检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
离开原因枚举，取值如表2 离开房间原因所示。 msg：string类型，原因描述。 } 表2 离开房间原因 枚举值 描述 0 用户主动离开 1 服务器异常 2 sfu服务故障 3 服务不可达503 4 内部错误 5 被踢出房间 6 签名过期 7 重连超时 8 网络检测，UI不需要关注该错误码，不对外体现
同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。 支持播放wav、pcm和单声道mp3音频文件。可以播放本地或在线音乐文件。 接口调用步骤 实现过程 加入房间 参考接口调用步骤中加入房间的时序图步骤加入房间。 播放音乐文件 调用startAudioFi
ID相同的应用程序才能进入同一个房间进行互动。应用的appId请参考应用管理进行获取。 domain：可选，string[128]类型，服务器的域名。需要与注册到SparkRTC平台的合法企业域名保持一致，该参数在SDK 1.0+版本中必填，SDK 2.0+版本中非必填。 countryCode:
为“X-Request-Id”。 2022-07-01 第十三次正式发布 本次变更如下： 修改部分接口参考示例。 下线“查询学生和老师同时在线时长”接口。 2022-06-28 第十二次正式发布 本次变更如下： 修改部分接口示例。 优化启动合流任务背景图相关字段的描述。 2022-03-09
混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。 可以播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现播放音乐文件 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。
混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。 支持播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现过程 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。
同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。 支持播放wav、pcm和单声道mp3音频文件。可以播放本地或在线音乐文件。 接口调用流程 实现过程 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 播放音乐文件 调用startAudioFi
混音是将音频文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音频文件，播放给房间内的其他用户听。 支持播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现过程 加入房间并发布本端主流 参考接口调用流程中加入房
eason reason, const char* description) 【功能说明】 媒体服务器连接状态变更通知。 【回调参数】 conn：连接对象。 state：与媒体服务器连接状态，具体请参见HRTCMediaConnStateTypes。 reason：连接状态改变原
房间管理接口 接口 说明 POST /v2/apps/{app_id}/rooms/{room_id}/batch-remove-users 踢除在线用户 POST /v2/apps/{app_id}/rooms/{room_id}/dismiss 解散房间 OBS桶管理 表8 OBS桶管理接口
HRTCMediaConnChangeReason reason, const char* description) 【功能说明】 媒体服务器连接状态变更通知。 【回调参数】 state：与媒体服务器连接状态，具体请参见HRTCMediaConnStateTypes。 reason：连接状态变化的原因，具体
0：方法调用成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。 该接口不改变本地摄像头的预览画面，但会使远端用户看到的和服务器录制的画面为指定的镜像效果。 startPublishStream - (int)startPublishStream:(NSString
_Nonnull)description; 【功能说明】 网络连接状态发生变化，触发此回调。 【回调参数】 connection：跨房引擎。 state：链接服务器状态，具体请参见HWRtcConnStateType。 reason：连接状态改变原因，具体请参见HWRtcConnChangeReason。
HRTCMediaConnChangeReason reason, const char* description) 【功能说明】 媒体服务器连接状态变更通知。 【回调参数】 state：与媒体服务器连接状态，具体请参见HRTCMediaConnStateTypes。 reason：连接状态变化的原因，具体
state, HRTCMediaConnChangeReason reason, String description); 【功能说明】 媒体服务器连接状态变更通知。加入房间过后，收到媒体服务的数据包时，返回Connected消息，超过6s没有收到包，则返回Failed消息。 【回调参数】
0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。 该接口不改变本地摄像头的预览画面，但会使远端用户看到的和服务器录制的画面为指定的镜像效果。 setCameraConfig virtual int setCameraConfig(HRTCCameraConfig
metric 是 Array of strings 查询的数据类型 JoinSuccessRate：加入房间成功率 JoinSuccess5SecsRate：5秒加入成功率 VideoFreezeRate：视频卡顿率 AudioFreezeRate：音频卡顿率 FirstVideoRecvTime：首帧视频接收耗时
String 房间ID metric 是 String 查询的数据类型： JoinSuccessRate：加入房间成功率 JoinSuccess5SecsRate：5秒加入成功率 VideoFreezeRate：视频卡顿率 AudioFreezeRate：音频卡顿率 sdk_type 是 String
使用限制 在使用实时音视频前，您需要了解本服务的使用限制。 表1 使用限制 限制项 说明 应用创建 若首次使用SparkRTC，则需提交工单联系华为云技术客服进行咨询。 直播间人数 一个直播间最多支持500人同时通话。 Android SDK 系统版本：支持Android 5.0及以上版本。
接口参考 主入口（HRTC） 客户端对象（Client） 客户端事件通知（ClientEvent） 流对象（Stream） 本地流对象（LocalStream） 远端流对象（RemoteStream） 流事件通知（RTCStreamEvent） 错误码（RtcError） 客户端错误码
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
