检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
准备XCODE集成开发环境。 准备MAC设备，支持macOS 10.11以上的设备。 支持的终端CPU架构：x86_64。 SDK集成 支持dylib和framework两种包集成。 解压Mac SDK包。 将MAC SDK包中的lib动态库libHRTCEngine.dylib或者libHRTCEngine
X-Auth-Token or AK/SK SparkRTC服务收到的token中解析不到domainID，无法确认租户身份 检查调用API时使用的账号是否正确：如使用了错误的token 400 RTC.00001002 MalformedRequestBody: json parsing
注册回调（IHRTCMediaEngine） 本章节介绍了全平台C++ SDK的IHRTCMediaEngine类接口详情。 表1 IHRTCMediaEngine类 接口 描述 setVideoFrameObserver 注册原始视频媒体数据监听回调 setAudioFrameObserver
用户Token。使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。
共享屏幕资源管理 本章节介绍了全平台C++ SDK的IHRTCScreenShareSourceList类接口详情。 表1 IHRTCScreenShareSourceList类 接口 描述 count 获取屏幕共享窗口资源数量 get 获取屏幕共享窗口资源信息 release 资源释放函数
事件回调(IHRTCAudioFrameObserver) 本章节介绍了全平台C++ SDK的回调接口IHRTCAudioFrameObserver的详情。 表1 事件回调说明 接口 描述 onAudioFramePlayback 音频播放回调（后处理） onAudioFrameMixed
// 将远端视频统计消息显示到屏幕上 } 本地音频和远端音频统计信息 onAudioStatsNotify回调返回的参数中，有本地当前用户的音频信息，也有远端用户的音频信息。 音频信息包括：码率、丢包、延迟、抖动。 @Override public void onAudioSta
功能描述 加入房间后，SDK上报通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。 接口调用流程 通话质量上报 network-quality网络上下行质量报告事件，用户加入房间后，在网络质量变化的时候会触发一次该事件，报告用户的本地网络上下行质量情况。 示例代码如下：
通话质量监测 功能描述 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。 上报接口 通话质量上报 onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启，每2s上报一次。 void HWE
通话质量监测 功能描述 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。 上报接口 通话质量上报 onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启，每2s上报一次。 - (void)
reason：string类型，表示触发播放状态变更的原因。 screen-sharing-stopped 【事件说明】 共享屏幕停止事件。仅在本地共享屏幕停止时触发。 【回调参数】 event：string类型。表示停止共享屏幕时的流Id。 audio-mixing-played 【事件说明】
视频。 支持录制MP4、HLS文件，音频编码类型支持AAC。 支持获取回调消息中的播放URL进行回放，回调消息中的downloadurl字段为OBS播放地址，使用该URL播放将会在OBS中产生对应的下载流量或者带宽费用。 支持选择摄像头流或屏幕分享流。 支持指定分辨率大小。 在线课堂、内容审核等
【请求参数】 userName：变更的昵称。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。 该接口仅支持房间内调用，更改的昵称会被实时同步到房间内其他用户的用户列表，退出房间不会保存，再次加入房间变更为加入房间时设置的昵称（参考joinRoom接口注意事项）。
通话质量监测 功能描述 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。 上报接口 通话质量上报 onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启，每2s上报一次。 - (void)
事件回调(IHRTCVideoFrameObserver) 本章节介绍了全平台C++ SDK的回调接口IHRTCVideoFrameObserver的详情。 表1 事件回调说明 接口 描述 onVideoFrameCapture 原始视频回调（前处理） onVideoFrameRender
js开发， 推荐安装14.19.1或以上版本。 支持的浏览器详情请参见Web浏览器适配详情。 如果客户端用TypeScript开发，TypeScript的版本不低于3.8.3。 由于浏览器安全策略限制，仅支持通过https://域名的方式访问，或者直接在本地搭建服务器，通过local
【返回参数】 无 broadcastFinished - (void)broadcastFinished; 【功能说明】 系统录屏完成，在sampleHandle类中的broadcastFinished中调用。 【请求参数】 无 【返回参数】 无 sendVideoSampleBuffer
对于管理员创建IAM用户接口，返回如图1所示的消息头，其中“X-Subject-Token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。 建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。 图1 管理员创建IAM用户响应消息头
版本规划 本章节为您介绍实时音视频服务（SparkRTC）客户端SDK的版本支持机制。 版本号说明 版本号格式为a.b.c.d，其中： a为大版本号：在版本架构重构的情况下更新。 b为小版本号：在重大特性或接口变更的情况下更新。 c为月度开发版本号：月度累加。 d为release版本
【功能说明】 设置用户在本房间内/指定房间的角色，角色切换时使用。 【请求参数】 role：用户角色，具体请参见HWRtcRole。 authorization：鉴权信息，当填写null时，则切换角色不鉴权，同时会忽略ctime值。 ctime：生成鉴权时使用的时间戳，必须匹配对应。 【返回参数】
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
