检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
事件回调（HWRtcEngine） HWRtcConnection 事件回调（HWRtcConnection） 媒体原始数据管理 HWRtcReplay 客户端错误码 服务端错误码 数据类型 事件回调（HWRtcReplay） 父主题： iOS/macOS SDK
【功能说明】 媒体服务器连接状态变更通知。 【回调参数】 state：与媒体服务器连接状态，具体请参见HRTCMediaConnStateTypes。 reason：连接状态变化的原因，具体请参见HRTCMediaConnChangeReason。 description：连接状态变化原因描述。
基本使用逻辑 创建新的项目工程，导入 SDK 后，需要创建客户端并获取本地音视频设备信息。 创建本地流并初始化。 当用户加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以对音视频流进行订阅、取消订阅等其它操作。 在会中，也可以对本地录音或播放设备等进行配置。
tryCode必选入参。客户端须修改代码，否则使用2.0.3 SDK创建客户端会失败。参数domain由必选修改为可选。 客户端对象（Client）subscribe、unsubscribe接口增加autoAdjustResolution可选入参。 客户端对象（Client）删除
iOS/macOS SDK 开发前准备 SDK使用 基本使用逻辑 接口参考 常见问题 修订记录
SDK使用 创建引擎并初始化。 域名不需要设置，由SDK自动获取。appId获取方法请参见创建应用。 1 2 3 4 5 6 7 8 9 10 11 12 _rtcEngine = [HWRtcEngine sharedEngine]; HWRtcEngineConfig
基本使用逻辑 创建新的项目工程，导入SDK后，需要先创建引擎。 您可以在入会前进行视频编码、声音播放模式等参数的配置。 设置本地视图。 用户加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以为其设置远端视图。 在会中，也可以进行切换摄像头等参数的配置。 离开房间后，需销毁对应资源。
本地流对象（LocalStream） 该对象继承自Stream对象，并有如下新增接口。 表1 LocalStream接口 接口 描述 initialize 本地流初始化。 setAudioProfile 设置音频流配置。 setVideoProfile 设置视频流配置。 setScreenProfile
RTC.32000017 站点不存在 程序或环境问题 RTC.32000018 错误的加密算法 程序或环境问题 RTC.32000019 客户端媒体加密密钥base64解码失败 程序或环境问题 RTC.32000020 生成媒体加密密钥失败 程序或环境问题 RTC.32000021
加入房间时，username必须填吗？ 必填。 应用关闭鉴权时，加入房间还需要填鉴权参数吗？ 不需要填。 加入房间失败时，如何解决？ 首先通过返回的客户端错误码进行分析，主要有以下几个原因： 网络问题，您需要确认网络是否正常运行。 鉴权问题，应用默认开启鉴权，您需要确保鉴权生成正确，参数合理
abstract int startScreenShare(); 【功能说明】 开启屏幕共享。 【返回参数】 0：成功。 > 0：失败。具体请参见客户端错误码。 Android 5.0及以上版本支持此功能。 使用时，在AndroidManifest.xml中需添加如下约束。 <activity
RTC.32000017 站点不存在 程序或环境问题 RTC.32000018 错误的加密算法 程序或环境问题 RTC.32000019 客户端媒体加密密钥base64解码失败 程序或环境问题 RTC.32000020 生成媒体加密密钥失败 程序或环境问题 RTC.32000021
0：表示调用启动命令失败。具体请参见客户端错误码。 stopNetworkTest public abstract int stopNetworkTest(); 【功能说明】 停止入会前网络检测。 【请求参数】 无 【返回参数】 0：表示调用停止命令成功。 > 0：表示调用停止命令失败。具体请参见客户端错误码。
0：方法调用成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。 会触发以下回调： onConnStateChange：连接状态发送改变。 onJoinSuccess：加入房间成功。 onRemoteUserOnline：远端用户加入。 onJoinRoomFailure：加入房间失败。
changeUserName 设置用户自己的昵称 createConnection 创建 跨房（HWRtcConnection）对象，跨房前需先创建连接 addMultiRoomMediaRelay 添加单个跨房 removeMultiRoomMediaRelay 删除单个跨房 stopMultiRoomMediaRelay
【功能说明】 媒体服务器连接状态变更通知。 【回调参数】 state：与媒体服务器连接状态，具体请参见HRTCMediaConnStateTypes。 reason：连接状态变化的原因，具体请参见HRTCMediaConnChangeReason。 description：连接状态变化原因描述。
description); 【功能说明】 网络连接状态改变。 【回调参数】 conn：回调对应的HRTCConnection实例。 connStateTypes：网络连接状态，具体请参见HRTCConnStateTypes。 connChangeReason：网络连接状态原因，具体请参见HRTCConnChangeReason。
_Nonnull)description; 【功能说明】 网络连接状态发生变化，触发此回调。 【回调参数】 connection：跨房引擎。 state：链接服务器状态，具体请参见HWRtcConnStateType。 reason：连接状态改变原因，具体请参见HWRtcConnChangeReason。
主要功能 SparkRTC主要包含基本房间功能和跨房功能，各端主要功能框架，如图1所示。 说明：图1中仅展示各端的统一功能，独属功能详见各端SDK指导。 图1 功能框架 表1 功能说明 类别 功能分类 功能说明 基本功能 初始化等基础接口 主要功能包括创建/销毁RTC引擎、设置日志保存位置等。
文档基本使用技巧 技巧1：基本使用逻辑说明 用时序图展示各端接口使用顺序，单击相应接口可以快速查看相关接口使用方法。 技巧2：接口总览说明 包括SparkRTC接口总体功能流程图和接口列表，根据功能分类可以快速查找具体功能单个接口，方便接口对接。 技巧3：单个接口使用须知 接口使
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
