华为云用户手册

实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onUserNameChangedNotify

onUserNameChangedNotify virtual void onUserNameChangedNotify(IHRTCConnection* conn, const char* oldUserName, const char* newUserName) 【功能说明】本端用户昵称变化，触发此回调。【回调参数】 conn：连接对象。 oldUserName：变更前的昵称。 newUserName：变更后的昵称。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onRemoteAudioStateChangedNotify

onRemoteAudioStateChangedNotify virtual void onRemoteAudioStateChangedNotify(IHRTCConnection* conn, const char* userId, HRTCRemoteAudioStreamState state, HRTCRemoteAudioStreamStateReason reason) 【功能说明】远端音频流状态变化回调。【回调参数】 conn：连接对象。 userId：远端用户ID。 state：远端音频流状态，具体请参见HRTCRemoteAudioStreamState。 reason：远端音频流状态变化原因，具体请参见HRTCRemoteAudioStreamStateReason。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onUserRoleChangedNotify

onUserRoleChangedNotify void onUserRoleChangedNotify(String roomId, HRTCRoleType oldRole, HRTCRoleType newRole); 【功能说明】用户角色改变。【回调参数】 roomId：发生角色切换的房间号。 oldRole：改变前的角色，具体请参见HRTCRoleType。 newRole：改变后的角色，具体请参见HRTCRoleType。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onLocalAudioStateChangedNotify

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

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onConnectionChangedNotify

onConnectionChangedNotify virtual void onConnectionChangedNotify(IHRTCConnection* conn, HRTCConnStateType state, HRTCConnChangeReason reason, const char* description) 【功能说明】连接状态改变回调。【回调参数】 conn：连接对象。 state：连接状态类型，具体请参见HRTCConnStateTypes。 reason：连接状态改变原因，具体请参见HRTCConnChangeReason。 description：连接状态改变描述。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onUserRoleChangedNotify

onUserRoleChangedNotify virtual void onUserRoleChangedNotify(IHRTCConnection* conn, HRTCRoleType oldRole, HRTCRoleType newRole) 【功能说明】用户角色切换成功，触发此回调。【回调参数】 conn：连接对象。 oldRole：切换前的角色。具体请参见HRTCRoleType。 newRole：切换成功后的角色。具体请参见HRTCRoleType。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onRemoteUserOnline

onRemoteUserOnline virtual void onRemoteUserOnline(IHRTCConnection* conn, const char* userId, const char* userName) 【功能说明】远端joiner用户加入当前房间，触发此回调。该回调提示有远端joiner用户加入了房间，并返回新加入用户的ID。【回调参数】 conn：连接对象。 userId：远端用户ID。 userName：远端用户昵称。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onRemoteUserNameChangedNotify

onRemoteUserNameChangedNotify virtual void onRemoteUserNameChangedNotify(IHRTCConnection* conn, const char* userId, const char* userName) 【功能说明】远端用户昵称变化，触发此回调。【回调参数】 conn：连接对象。 userId：用户ID。 userName：变更后的昵称。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onConnectionChangedNotify

onConnectionChangedNotify void onConnectionChangedNotify(HRTCConnStateTypes connStateTypes, HRTCConnChangeReason connChangeReason, String description); 【功能说明】网络连接状态改变。【回调参数】 connStateTypes：网络连接状态，具体请参见HRTCConnStateTypes。 connChangeReason：网络连接状态原因，具体请参见HRTCConnChangeReason。 description：描述。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onUserAuxiliaryStreamAvailable

onUserAuxiliaryStreamAvailable void onUserAuxiliaryStreamAvailable(String roomId, String userId, boolean available); 【功能说明】辅流加入房间。【回调参数】 roomId：房间ID。 userId：用户ID。 available：true表示辅流开始推送，false表示辅流停止推送，提示用户关闭共享。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onPlaybackExternalAudioFrame

onPlaybackExternalAudioFrame void onPlaybackExternalAudioFrame(String roomId,HRTCMediaDirection direction, HRTCAudioFrame audioFrame); 【功能说明】回调远端的音频原始数据流。【回调参数】 roomId：房间ID。 audioFrame：音频数据，具体请参见HRTCAudioFrame。 direction：数据源，本地数据，远端数据，具体请参见HRTCMediaDirection。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onMediaConnectStateChangedNotify

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

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onRemoteVideoStateChangedNotify

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

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onLeaveRoom

onLeaveRoom virtual void onLeaveRoom(IHRTCConnection* conn, HRTCLeaveReason reason, const HR TCS tatsInfo &statsInfo) 【功能说明】离开房间，触发此回调。【回调参数】 conn：连接对象。 reason：离开的房间原因，具体请参见HRTCLeaveReason。 statsInfo：卡顿统计信息，具体请参见HRT CS tatsInfo。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调（IHRTCEngineEventHandler）:onRemoteUserOffline

onRemoteUserOffline virtual void onRemoteUserOffline(IHRTCConnection* conn, const char* userId, int reason) 【功能说明】远端joiner用户离开当前房间，触发此回调。本端用户离开当前房间，会回调当前房间所有用户offline。【回调参数】 conn：连接对象。 userId：离开房间的远端用户ID。 reason：远端用户离线原因，预留参数。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onUserAuxiliaryStreamAvailable

onUserAuxiliaryStreamAvailable void onUserAuxiliaryStreamAvailable(HRTCConnection conn, String userId, boolean available); 【功能说明】辅流加入房间。【回调参数】 conn：回调对应的HRTCConnection实例。 userId：用户ID。 available：true为辅流开始推送，false为辅流停止推送。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onRemoteAudioStateChangedNotify

onRemoteAudioStateChangedNotify void onRemoteAudioStateChangedNotify(HRTCConnection conn, String userId, HRTCRemoteAudioStreamState state, HRTCRemoteAudioStreamStateReason reason); 【功能说明】远端音频流状态变化回调。【回调参数】 conn：回调对应的HRTCConnection实例。 userId：远端用户ID。 state：远端音频流状态，具体请参见HRTCRemoteAudioStreamState。 reason：远端音频流状态变化原因，具体请参见HRTCRemoteAudioStreamStateReason。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onMediaConnectStateChangedNotify

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

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onRemoteMicrophoneStateChanged

onRemoteMicrophoneStateChanged void onRemoteMicrophoneStateChanged(HRTCConnection conn, String userId, HRTCRemoteMicState state); 【功能说明】远端麦克风设备状态变更回调。【回调参数】 conn: 连接对象。 userId：用户id。 state：麦克风设备状态，具体请参见HRTCRemoteMicState。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onVideoResolutionChangedNotify

onVideoResolutionChangedNotify void onVideoResolutionChangedNotify(HRTCConnection conn, String userid, int width, int height); 【功能说明】远端视频大小改变回调。【回调参数】 conn：回调对应的HRTCConnection实例。 userId：用户ID。 width：视频流宽度。 height：视频流高度。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onRemoteShareStatusChangeNotify

onRemoteShareStatusChangeNotify void onRemoteShareStatusChangeNotify(HRTCConnection conn, String userId, boolean isRecving) 【功能说明】上报下行辅流状态变化通知，接收端探测网络变化，分配给下行辅流，如果有辅流因为带宽不足被停掉或者带宽恢复而恢复，则上报给产品。【回调参数】 conn: 连接对象。 userId：下行辅流对应的用户ID。 isRecving：是否接受。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onLeaveRoom

onLeaveRoom void onLeaveRoom(HRTCConnection conn, HRTCLeaveReason reason, HRTCStatsInfo statsInfo); 【功能说明】离开房间回调。【回调参数】 conn：回调对应的HRTCConnection实例。 reason：自己离开房间的原因，具体请参见HRTCLeaveReason。 statsInfo：会议期间的统计信息，具体请参见HRTCStatsInfo。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onFirstRemoteAuxiliaryStreamDecoded

onFirstRemoteAuxiliaryStreamDecoded void onFirstRemoteAuxiliaryStreamDecoded(HRTCConnection conn, String roomId, String userId, int width, int height); 【功能说明】接收到第一帧远端辅流并解码成功，触发此回调。【回调参数】 conn：回调对应的HRTCConnection实例。 roomId：视频流对应的房间ID。 userId：视频流对应的用户ID。 width：视频流宽。 height：视频流高。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onUserNameChangedNotify

onUserNameChangedNotify void onUserNameChangedNotify(HRTCConnection conn, String oldUserName, String newUserName); 【功能说明】调用changeUserName接口成功后，上报此事件通知修改昵称结果。【回调参数】 conn：回调对应的HRTCConnection实例。 oldUserName：修改前的昵称。 newUserName：修改后的昵称。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onTopActiveSpeaker

onTopActiveSpeaker public void onTopActiveSpeaker(HRTCConnection conn, String userId, boolean noStream); 【功能说明】上报当前最活跃的用户userId。该回调主要用于0号会场场景（额外订阅uid为0的用户音频）。【回调参数】 userId：返回当前远端音量最活跃的用户ID。 noStream：该用户是否有视频流。 0号会场模式下，SDK会持续监测（根据一定时间内用户音量大小）当前最活跃的用户，如果最活跃用户发生变化，则触发此回调并上报当前最活跃的用户userId。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onFirstRemoteVideoDecoded

onFirstRemoteVideoDecoded void onFirstRemoteVideoDecoded(HRTCConnection conn, String userId, int width, int height); 【功能说明】远端用户第一帧解码成功回调。【回调参数】 conn：回调对应的HRTCConnection实例。 userId：用户ID。 width：视频宽度。 height：视频高度。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onRenderSuccessNotify

onRenderSuccessNotify void onRenderSuccessNotify(HRTCConnection conn, String userId, boolean isAux); 【功能说明】用户视频流渲染成功通知回调。首帧渲染成功、分辨率变化或视频流中断后恢复触发。【回调参数】 conn：回调对应的HRTCConnection实例。 userId：用户ID。 isAux：是否辅流。true为是辅流，false为不是辅流。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onRemoteUserNameChangedNotify

onRemoteUserNameChangedNotify void onRemoteUserNameChangedNotify(HRTCConnection conn, String userId, String userName); 【功能说明】远端用户修改昵称后，通知本端昵称变更。【回调参数】 conn：回调对应的HRTCConnection实例。 userId：修改昵称的用户id。 userName：修改后的昵称。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onConnectionChangedNotify

onConnectionChangedNotify void onConnectionChangedNotify(HRTCConnection conn, HRTCConnStateTypes connStateTypes, HRTCConnChangeReason connChangeReason, String description); 【功能说明】网络连接状态改变。【回调参数】 conn：回调对应的HRTCConnection实例。 connStateTypes：网络连接状态，具体请参见HRTCConnStateTypes。 connChangeReason：网络连接状态原因，具体请参见HRTCConnChangeReason。 description：描述。

实时音视频 SparkRTC
实时音视频 SparkRTC-事件回调(IHRTCConnectionEventHandler):onUserRoleChangedNotify

onUserRoleChangedNotify void onUserRoleChangedNotify(HRTCConnection conn, HRTCRoleType oldRole, HRTCRoleType newRole); 【功能说明】用户角色改变。【回调参数】 conn：回调对应的HRTCConnection实例。 oldRole：改变前的角色，具体请参见HRTCRoleType。 newRole：改变后的角色，具体请参见HRTCRoleType。

实时音视频 SparkRTC

共100000条

undefined

意见反馈

0/200

提交取消

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