检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
注册回调（IHRTCMediaEngine） 表1 HWRtcMediaEngine 接口 描述 setVideoFrameObserver 注册原始视频媒体数据监听回调 setAudioFrameObserver 注册原始音频媒体数据监听回调 setVideoFrameObserver
curState：必选，ConnectionState类型，变更后状态。 } 连接状态ConnectionState的取值如下所示： CONNECTING：连接建立中。 CONNECTED：连接已连接。 RECONNECTING：重新连接中。 DISCONNECTED：连接已断开。 mute-audio 【事件说明】
ID相同的应用程序才能进入同一个房间进行互动。应用的appId请参考应用管理进行获取。 domain：可选，string[128]类型，服务器的域名。需要与注册到SparkRTC平台的合法企业域名保持一致，该参数在SDK 1.0+版本中必填，SDK 2.0+版本中非必填。 countryCode: 可选，string[2]类型，需要满足ISO
终端节点即调用API的请求地址，SparkRTC部署时不区分物理区域，为全局服务。因此，SparkRTC的终端节点如表1所示。 表1 SparkRTC的终端节点 区域名称 区域 终端节点（Endpoint） 所有 ALL rtc-api.myhuaweicloud.com 约束与限制 华为云实时音视频服务
0：方法调用成功。 >0：方法调用失败。具体请参见HRTCErrorCode。 会触发以下回调： onConnectStateChange：连接状态发送改变。 onJoinRoomSuccess：加入房间成功。 onJoinRoomFailure：加入房间失败。 onRemoteU
0：成功。 1：失败。 2：上下文为空。 【注意事项】 该方法将会触发以下回调： onConnectionStateChangedNotify：连接状态发送改变。 onJoinRoomSuccess：加入房间成功时回调。 onJoinRoomFailure: 加入房间失败时回调。 on
通过此接口可以创建一个与房间关联的IHRTCConnection连接对象，可多次调用以创建多个IHRTCConnection连接对象。调用每个连接对象中的joinRoom方法等接口，可以实现同时加入到多个房间，完成订阅和选看多个连接房间中的用户等功能。具体请参见IHRTCConnecti
RtcServerRoomInfo objects 房间列表信息 表6 RtcServerRoomInfo 参数 参数类型 描述 domain String 域名 app String 应用标识 room_id String 房间ID state String 房间状态，取值如下： RUNNING：开启中
char* userId, HRTCVideoFrame& videoFrame) 【功能说明】 原始视频数据处理后回调 【回调参数】 conn：连接对象 userid：用户ID videoFrame：视频数据格式 ，具体请参见HRTCVideoFrame。 【返回参数】 true：处理结果成功。
表33 网络连接状态 枚举值 描述 HRTC_CONN_DISCONNECTED 连接断开。 HRTC_CONN_CONNECTING 建立网络连接中。 HRTC_CONN_CONNECTED 网络连接成功。 HRTC_CONN_RECONNECTING 重新建立网络连接中。 HRTC_CONN_FAILED
【返回参数】 不为null：成功。 null：失败。 同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。 如果使用HRTCConnection对象加入房间，则加入房间的房间ID不能和已创建连接对象对应的房间ID相同。 同一时间只能以JOINER角色加入某一个房间。
${stats}`) }) 获取客户端连接状态 getConnectionState获取客户端的连接状态，分别为： CONNECTING：连接建立中。 CONNECTED：连接已建立。 RECONNECTING：重新连接中。 DISCONNECTED：连接已断开。 示例代码如下： console
createConnection：加入多房间（跨房）前，与要跨入的房间先建立连接的接口，跨一个房间建立一个连接。 setDefaultSpeakerModel：设置默认的声音播放模式。 onMediaConnectStateChangedNotify：增加与媒体服务器连接状态变化的通知回调。 onFirstRem
users Array of RtcUser objects 用户列表 表6 RtcUser 参数 参数类型 描述 domain String 域名 app String 应用标识 room_id String 房间ID uid String 用户id session String 会话id
userId：必填，string[64]类型，用户标识，userId需要保证应用内唯一。userId支持的字符包括：a-z、A-Z、0-9、连接符 '-'、下划线 '_'。 userName：选填，string[128]类型，用户昵称。 microphoneId跟cameraId在哪获取？为什么是必填的？
description) 【功能说明】 连接状态改变回调。 【回调参数】 conn：连接对象。 state：连接状态类型，具体请参见HRTCConnStateTypes。 reason：连接状态改变原因，具体请参见HRTCConnChangeReason。 description：连接状态改变描述。 o
HWRtcErrorCodeConnectOtherRoomFail 90000034 连接其他房间失败 连接其他房间失败。 HWRtcErrorCodeDisConnectOtherRoomFail 90000035 断开连接其他房间失败 断开连接其他房间失败。 HWRtcErrorCodeSetUseRoleNotAllowed
d：引擎收到第一帧远端辅流并解码成功的回调。 createConnection：加入多房间（跨房）前，与要跨入的房间先建立连接的接口，跨一个房间建立一个连接。 setRemoteAudioMode：设置音频订阅模式的接口，整合了setRemoteAudioTopNVoice和en
0：方法调用成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。 会触发以下回调： onConnStateChange：连接状态发送改变。 onJoinSuccess：加入房间成功。 onRemoteUserOnline：远端用户加入。 onJoinRoomFailure：加入房间失败。
SDK是否支持断线重连机制？ 支持，您也可以通过disableRejoinRoom关闭重连房间功能。 父主题： SDK使用
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
