华为云用户手册

实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onAudioMixStateChangedNotify

onAudioMixStateChangedNotify - (void)onAudioMixStateChangedNotify:(HWRtcAudioFileState)state reason:(HWRtcAudioFileReason)reason value:(NSUInteger)value; 【功能说明】混音音频文件播放状态改变回调。回调参数 state：音频文件播放状态，具体请参见 HWRtcAudioFileState reason：音频文件播放状态变化原因，具体请参见 HWRtcAudioFileReason value：state为HWRtcAudioFileOpenCompleted表示音频文件的时长，单位ms；state为HWRtcAudioFilePositionUpdate表示当前播放的位置，单位ms。其他情况下，value值无意义。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onUserAuxiliaryStreamAvailable

onUserAuxiliaryStreamAvailable - (void)onUserAuxiliaryStreamAvailable:(NSString * _Nonnull)roomId userId:(NSString * _Nonnull)userId isAvailable:(BOOL)isAvailable; 【功能说明】辅流状态回调。【回调参数】 roomId：房间ID。 userId：远端用户ID。 isAvailable：YES表示辅流推送中，NO表示辅流停止推送。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onLocalAudioStateChangedNotify

onLocalAudioStateChangedNotify -(void)onLocalAudioStateChangedNotify:(HWRtcLocalAudioState)state reason:(HWRtcLocalAudioStateReason)reason; 【功能说明】本地音频流状态变化回调。【回调参数】 state：本地音频流状态。具体请参见 HWRtcLocalAudioState。 reason：本地音频流状态变化原因。具体请参见 HWRtcLocalAudioStateReason。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onRemoteVideoResolutionChangedNotify

onRemoteVideoResolutionChangedNotify - (void)onRemoteVideoResolutionChangedNotify:(NSString *_Nullable)userId width:(NSInteger)width height:(NSInteger)height; 【功能说明】远端视频大小改变回调。【回调参数】 userId：用户ID。 width：视频流宽度。 height：视频流高度。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onUserNameChangedNotify

onUserNameChangedNotify -(void)onUserNameChangedNotify:(NSString * _Nonnull)oldUserName newUserName:(NSString * _Nonnull)newUserName; 【功能说明】本端用户昵称变化，触发此回调。【回调参数】 oldUserName：变更前的昵称。 newUserName：变更后的昵称。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onFirstRemoteAuxiliaryStreamDecoded

onFirstRemoteAuxiliaryStreamDecoded - (void)onFirstRemoteAuxiliaryStreamDecoded:(NSString*)roomId userId:(NSString*)userId width:(int)width height:(int)height; 【功能说明】引擎收到第一帧远端视频流并解码成功回调。【回调参数】 roomId：视频流对应的房间ID。 userId：视频流对应的用户ID。 width：视频流宽度。 height：视频流高度。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onDeviceStateChangedNotify

onDeviceStateChangedNotify - (void)onDeviceStateChangedNotify:(NSString*)deviceId deviceType:(HWRtcDeviceType)deviceType deviceState:(HWRtcDeviceState)deviceState; 【功能说明】设备状态发生变化，触发此回调。【回调参数】 deviceId：设备ID。 deviceType：系统设备类型，具体请参见HWRtcDeviceType。 deviceState：系统设备状态，具体请参见HWRtcDeviceState。仅支持macOS。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onLeaveRoom

onLeaveRoom - (void)onLeaveRoom:(HWRtcLeaveReason)leaveReason statsInfo:(HWRtcStatsInfo *)statsInfo; 【功能说明】离开房间，触发此回调。【回调参数】 leaveReason：离开的房间原因，具体请参见HWRtcLeaveReason。 statsInfo：卡顿统计信息，具体请参见HWRtcStatsInfo。 APP调用leaveRoom接口时，会返回HWRtcLeaveReasonUserLeaveRoom，APP可以通过以下任一方式回退到登录界面。 APP在调用leaveRoom接口时退到登录界面，或者在收到到onLeaveRoom回调，且回调消息不等于HWRtcLeaveReasonUserLeaveRoom时（防止重复操作），退到登录界面。 APP只在收到onLeaveRoom消息时退到登录界面。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onFirstRemoteVideoDecoded

onFirstRemoteVideoDecoded - (void)onFirstRemoteVideoDecoded:(NSString*)roomId userId:(NSString*)userId width:(int)width height:(int)height; 【功能说明】引擎收到第一帧远端视频流并解码成功回调。【回调参数】 roomId：视频流对应的房间ID。 userId：视频流对应的用户ID。 width：视频流宽度。 height：视频流高度。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onFirstRemoteVideoDecoded

onFirstRemoteVideoDecoded - (void)onFirstRemoteVideoDecoded:(NSString*)roomId userId:(NSString*)userId width:(int)width height:(int)height elapsed:(NSUInteger)elapsed; 【功能说明】引擎收到第一帧远端视频流并解码成功回调。【回调参数】 roomId：视频流对应的房间ID。 userId：视频流对应的用户ID。 width：视频流宽度。 height：视频流高度。 elapsed：本端订阅远端用户视频到首帧解码后消耗的时间，单位ms。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onRemoteUserOffline

onRemoteUserOffline - (void)onRemoteUserOffline:(NSString*)roomId userId:(NSString*)userId reason:(NSInteger)reason; 【功能说明】远端用户离开当前房间，触发此回调。本端用户离开当前房间，会回调当前房间所有用户offline。【回调参数】 roomId：当前房间的房间ID。 userId：离开房间的远端用户ID。 reason：远端用户离线原因，预留参数。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onFirstRemoteAuxiliaryStreamDecoded

onFirstRemoteAuxiliaryStreamDecoded - (void)onFirstRemoteAuxiliaryStreamDecoded:(NSString*)roomId userId:(NSString*)userId width:(int)width height:(int)height elapsed:(NSUInteger)elapsed; 【功能说明】引擎收到第一帧远端视频流并解码成功回调。【回调参数】 roomId：视频流对应的房间ID。 userId：视频流对应的用户ID。 width：视频流宽度。 height：视频流高度。 elapsed：本端订阅远端用户视频到首帧解码后消耗时间，单位ms。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onRemoteVideoStateChange

onRemoteVideoStateChange - (void)onRemoteVideoStateChange:(NSString * _Nonnull)roomid userid:(NSString * _Nonnull)userid state:(HWRtcRemoteVideoState)state reason:(HWRtcRemoteVideoStateReason)reason; 【功能说明】远端用户视频流状态发生改变，会触发此回调。【回调参数】 roomid：房间ID。 userid ：远端用户ID。 state：远端视频流状态，具体请参见HWRtcRemoteVideoState。 reason：远端视频流状态改变的原因，具体请参见HWRtcRemoteVideoStateReason。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onRenderExternalVideoFrame

onRenderExternalVideoFrame - (void)onRenderExternalVideoFrame:(NSString *_Nonnull)roomid meidaDirection:(HWRtcMediaDirection)meidaDirection videoFrame:(HWRtcVideoFrame * _Nonnull)videoFrame; 【功能说明】渲染视频帧回调。需要调用setExternalVideoFrameOutputWithFormat接口开启视频自渲染，从而触发该回调。【回调参数】 roomid：房间ID。 meidaDirection：数据源（本地/远端数据），媒体方向，具体请参见HWRTCMediaDirection。 videoFrame：视频帧详情，具体请参见HWRtcVideoFrame。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onRemoteUserOnline

onRemoteUserOnline - (void)onRemoteUserOnline:(NSString*)roomId userId:(NSString*)userId userName:(NSString*)userName; 【功能说明】远端用户加入房间成功，触发此回调。该回调提示有远端用户加入了房间，并返回新加入用户信息。【回调参数】 roomId：房间ID。 userId：远端用户ID。 userName：远端用户昵称。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onLocalAudioMutedStatusDetected

onLocalAudioMutedStatusDetected - (void)onLocalAudioMutedStatusDetected; 【功能说明】本地静音但检测到音频输入回调。【回调参数】无通过setVolumeNotifyInterval开启并设置回调周期，本端禁音后检测到麦克风有输入后定时上报。上报频率和setVolumeNotifyInterval的参数大小有关，参考值建议设置成200。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onRemoteAudioStateChange

onRemoteAudioStateChange - (void)onRemoteAudioStateChange:(NSString * _Nonnull)roomid userid:(NSString * _Nonnull)userid state:(HWRtcRemoteAudioState)state reason:(HWRtcRemoteAudioStateReason)reason; 【功能说明】远端用户音频流状态发生改变，会触发此回调。【回调参数】 roomid：房间ID。 userid：远端用户ID。 state：远端音频流状态，具体请参见HWRtcRemoteAudioState。 reason：远端音频流状态改变的原因，具体请参见HWRtcRemoteAudioStateReason。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onRemoteUserNameChangedNotify

onRemoteUserNameChangedNotify -(void)onRemoteUserNameChangedNotify:(NSString * _Nonnull)roomId userId:(NSString * _Nonnull)userId userName:(NSString * _Nonnull)userName; 【功能说明】远端用户昵称变化，触发此回调。【回调参数】 roomId：房间ID。 userId：用户ID。 userName：昵称。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（HWRtcEngine）:onConnectionChangedNotify

onConnectionChangedNotify - (void)onConnectionChangedNotify:(HWRtcConnStateType)state reason:(HWRtcConnChangeReason)reason description:(NSString*)description; 【功能说明】网络连接状态发生变化，触发此回调。【回调参数】 state：网络连接状态，具体请参见HWRtcConnStateType。 reason：网络连接状态发生变化原因，具体请参见HWRtcConnChangeReason。 description：错误原因描述。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（IHRTCConnection）:onMediaConnectStateChangedNotify

onMediaConnectStateChangedNotify virtual void onMediaConnectStateChangedNotify(HRTCMediaConnStateTypes state, HRTCMediaConnChangeReason reason, const char* description) 【功能说明】媒体服务器连接状态变更通知。【回调参数】 state：与媒体服务器连接状态，具体请参见HRTCMediaConnStateTypes。 reason：连接状态变化的原因，具体请参见HRTCMediaConnChangeReason。 description：连接状态变化原因描述。加入房间过后，收到媒体服务的数据包时，返回Connected消息，超过6s没有收到包，则返回Failed消息。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（IHRTCConnection）:onLocalVideoStatsNotify

onLocalVideoStatsNotify virtual void onLocalVideoStatsNotify(const HRTCLocalVideoStats *localStats, unsigned int localStatsCount) 【功能说明】本地视频流详情，2s触发一次回调。【回调参数】 localStats：本地视频收流统计，具体请参见HRTCLocalVideoStats。 localStatsCount：localStats数组长度。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（IHRTCConnection）:onRemoteMicrophoneStateChanged

onRemoteMicrophoneStateChanged void onRemoteMicrophoneStateChanged(const char* userId, HRTCRemoteMicState state); 【功能说明】远端麦克风设备状态变更通知。【回调参数】 userId：远端用户userId。 state：麦克风设备状态，具体请参见HRTCRemoteMicState。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（IHRTCConnection）:onRemoteVideoStateChangedNotify

onRemoteVideoStateChangedNotify virtual void onRemoteVideoStateChangedNotify(const char* userId, HRTCRemoteVideoStreamState state, HRTCRemoteVideoStreamStateReason reason) 【功能说明】远端视频流状态变化回调。【回调参数】 userId：远端用户ID。 state：远端视频流状态，具体请参见HRTCRemoteVideoStreamState。 reason：远端视频流状态变化原因，具体请参见HRTCRemoteVideoStreamStateReason。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（IHRTCConnection）:onRenderAuxiliaryExternalVideoFrame

onRenderAuxiliaryExternalVideoFrame virtual void onRenderAuxiliaryExternalVideoFrame(const char* roomId, HRTCMediaDirection direction, const char* userId, HRTCVideoFrame& videoFrame) 【功能说明】辅流自渲染回调。需要调用setAuxiliaryExternalVideoFrameOutput接口开启辅流自渲染，从而触发该回调。【回调参数】 roomId：房间ID。 direction：数据源，本地数据，远端数据，具体请参见HRTCMediaDirection。 userId：用户ID。 videoFrame：辅流详情，具体请参见HRTCVideoFrame。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（IHRTCConnection）:onLocalAudioStateChangedNotify

onLocalAudioStateChangedNotify virtual void onLocalAudioStateChangedNotify(HRTCLocalAudioStreamState state, HRTCLocalAudioStreamStateReason reason) 【功能说明】本地音频状态改变，触发此回调。【回调参数】 state：本地音频状态，具体请参见HRTCLocalAudioStreamState。 reason：本地音频状态改变的原因，具体请参见HRTCLocalAudioStreamStateReason。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（IHRTCConnection）:onRemoteVideoStatsNotify

onRemoteVideoStatsNotify virtual void onRemoteVideoStatsNotify(const HRTCRemoteVideoStats *remoteStats, unsigned int remoteStatsCount) 【功能说明】远端视频流详情，2s触发一次回调。【回调参数】 remoteStats：远端视频收流统计，具体请参见HRTCRemoteVideoStats。 remoteStatsCount：remoteStats数组长度。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（IHRTCConnection）:onUserVolumeStatsNotify

onUserVolumeStatsNotify virtual void onUserVolumeStatsNotify(const HRTCVolumeInfo* userVolumes, unsigned int userVolumesCount, unsigned int totalVolume) 【功能说明】用户音量状态回调。通过enableUserVolumeNotify开启并设置回调周期，定时上报。【回调参数】 userVolumes：用户信息，具体请参见HRTCVolumeInfo。 userVolumesCount：上报的用户人数，包含本地用户。 totalVolume：总音量。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（IHRTCConnection）:onStreamPublishStateChange

onStreamPublishStateChange void onStreamPublishStateChange(int code, const char* taskId, const HRTCUrlStatusList * urlStatu); 【功能说明】 RTMP推流状态回调。回调参数 code：错误码，成功为0，失败参考错误码HRTCErrorCode。 taskId：任务Id。 urlStatu：推流的url状态，具体请参见HRTCUrlStatusList。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（IHRTCConnection）:onLocalVideoStateChangedNotify

onLocalVideoStateChangedNotify virtual void onLocalVideoStateChangedNotify(HRTCLocalVideoStreamState state, HRTCLocalVideoStreamStateReason reason) 【功能说明】本地视频状态改变，触发此回调。【回调参数】 state：本地视频状态，具体请参见HRTCLocalVideoStreamState。 reason：本地视频状态改变原因，具体请参见HRTCLocalVideoStreamStateReason。

实时音视频 SPARKRTC
实时音视频 SPARKRTC-事件回调（IHRTCConnection）:onStartAllRemoteViewResult

onStartAllRemoteViewResult virtual void onStartAllRemoteViewResult(int errCode, const char* errMsg, unsigned int counts, const HR TCS etupRemoteViewResult* results) 【功能说明】批量选看结果回调。【回调参数】 errCode：错误码。 errMsg：错误信息。 counts：results数组大小。 results：批量选看结果，具体请参见HRT CS etupRemoteViewResult。

实时音视频 SPARKRTC

共100000条

undefined

意见反馈

0/200

提交取消

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

华为云用户手册

7*24

备案

专业服务

退订

建议反馈

售前咨询热线