检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
state, HRTCMediaConnChangeReason reason, String description); 【功能说明】 媒体服务器连接状态变更通知。加入房间过后，收到媒体服务的数据包时，返回Connected消息，超过6s没有收到包，则返回Failed消息。 【回调参数】
_Nonnull)description; 【功能说明】 网络连接状态发生变化，触发此回调。 【回调参数】 connection：跨房引擎。 state：链接服务器状态，具体请参见HWRtcConnStateType。 reason：连接状态改变原因，具体请参见HWRtcConnChangeReason。
0：方法调用成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。 该接口不改变本地摄像头的预览画面，但会使远端用户看到的和服务器录制的画面为指定的镜像效果。 startPublishStream - (int)startPublishStream:(NSString
0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。 该接口不改变本地摄像头的预览画面，但会使远端用户看到的和服务器录制的画面为指定的镜像效果。 setCameraConfig virtual int setCameraConfig(HRTCCameraConfig
初始化等基础接口 sharedEngine + (instancetype)sharedEngine; 【功能说明】 创建连麦引擎实例。 【请求参数】 无 【返回参数】 返回引擎实例对象。 destroy - (void)destroy; 【功能说明】 注销引擎。 【请求参数】 无
使用前必须 华为云实时音视频服务（SparkRTC）凭借在视频业务领域长期技术积累，快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务，适用于在线教育、云会议、社交文娱等场景。 您可以使用本文档提供的API对华为云实时音视频服务进行相关操作，如应
功能特性 华为云SparkRTC提供了视频通话、连麦互动等功能，如表1所示。 表1 功能列表 功能 说明 常见场景 视频通话 即1对1或多人视频通话，支持720P及以上高清画质。单个房间最多支持2000人同时在线，最高支持500人互动。 1对1视频通话、视频会议、在线问诊、多人视
初始化等基础接口 setEncryption public abstract int setEncryption(HRTCEncryptionConfig encryptionParam); 【功能说明】 设置端到端加密方式。需要在加入房间前设置生效。其中sdk加密模式，需要设置
API概览 华为云实时音视频服务对应的接口列表如下所示，在调用媒体处理API前，您需要先获取用户Token，Token可以用于调用其他API时鉴权，具体如何调用媒体处理API请参考应用示例。 应用管理接口 表1 应用管理接口 接口 说明 POST /v2/apps 创建应用 GET
客户端错误码 本章节介绍了Web SDK的客户端错误码RtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 RTC_ERR_CODE_SUCCESS 0 success 成功。 RTC_ERR_CODE_RTC_SDK_ERROR 90000001
事件回调（HWRtcEngine） 本章节介绍了iOS/Mac SDK的回调接口HWRtcEngineDelegate的详情。 表1 事件回调说明 接口 描述 onJoinSuccess 成功加入房间回调 onJoinRoomFailure 加入房间失败回调 onRejoinRoomSuccess
初始化等基础接口 create public static synchronized HRTCEngine create(HRTCEngineConfig config, IHRTCEngineEventHandler eventHandler) 【功能说明】 创建SparkRTC引擎实例。
功能介绍 在实时音视频控制台，您可以快速进行应用的创建、编辑等管理。同时，还提供了音视频互动质量指标监控服务，方便您进行数据分析。 表1 控制台功能介绍 分类 功能 功能介绍 应用管理 应用管理 支持用户创建并管理应用，应用创建后可以使用对应的App ID和域名进入互动频道。 录制配置
音频管理 enableLocalAudioStream virtual int enableLocalAudioStream(bool enabled) 【功能说明】 设置是否开启本地麦克风音频采集。 【请求参数】 enable：true表示开启。false表示关闭。 【返回参数】
本地流对象（LocalStream） 该对象继承自Stream对象，并有如下新增接口。 表1 LocalStream接口 接口 描述 initialize 本地流初始化。 setAudioProfile 设置音频流配置。 setVideoProfile 设置视频流配置。 setScreenProfile
接口按功能说明 初始化等基础接口 表1 初始化等基础接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 createHRtcEngine 创建IHRTCEngine对象 √ √ √ √ getHRtcEngine 获取创建后的IHRTCEngine对象
修订记录 表1 修订记录 修改时间 修改说明 2022-06-21 第六次正式发布 本次变更如下： 新增以下接口： addMultiRoomMediaRelay：添加单个跨房 removeMultiRoomMediaRelay：删除单个跨房 stopMultiRoomMediaRelay：停止所有跨房
配置录制规则 SparkRTC服务支持将实时音视频互动内容进行录制并将录制的内容存储到OBS桶中，您可以在OBS服务中对录制的音视频文件进行下载、分享等处理。相关操作流程，如图1所示。 图1 录制流程图 创建桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。
SDK使用 移动端（Android/iOS）创建一个房间，是否支持PC端（MAC/Windows）接入？ iOS平台如何缩减安装包体积？ Android平台如何缩减安装包体积？ iOS端是否可以监听远端离开房间？ 背景音乐是否支持循环播放？ SparkRTC是否支持调整背景音乐的播放进度？
单流录制 场景说明 将房间中的每一个用户的音视频流分别录制成独立的文件。 录制机制 SparkRTC提供的单流录制支持自启动模式，即单流自动录制，具体的实现机制如下图所示。 图1 单流录制 图2 单流自动录制 实现流程 创建OBS桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
