检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID，所以需要先在管理控制台上获取到账号ID。具体获取步骤如下： 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中“我的凭证”。 在“API凭证”页面，即可获取对应的账号ID信息。 图1 获取账号ID 父主题： 附录
房间功能 joinRoom virtual int joinRoom(const HRTCJoinParam &joinParam) 【功能说明】 加入房间。该方法让用户加入通话房间。 【请求参数】 joinParam：加入房间信息。具体请参见HRTCJoinParam。 【返回参数
辅流管理 setRemoteAuxiliaryStreamViewRotation virtual int setRemoteAuxiliaryStreamViewRotation(const char *userId, HRTCVideoRotation rotation) 【功能说明
房间功能 joinRoom - (int)joinRoom:(HWRtcJoinParam * _Nonnull)joinParam; 【功能说明】 加入房间。该方法让用户加入通话房间。如果已在通话中，用户必须调用leaveRoom退出当前通话，才能进入下一个房间。 【请求参数】
辅流管理 startRemoteAuxiliaryStreamView - (int)startRemoteAuxiliaryStreamView:(HWRtcVideoCanvas *)streamView streamType:(HWRtcStreamType)streamType
房间功能 joinRoom - (int)joinRoom:(HWRtcJoinParam * _Nonnull)joinParam; 【功能说明】 加入房间。该方法让用户加入通话房间。如果已在通话中，用户必须调用leaveRoom退出当前通话，才能进入下一个房间。 【请求参数】
辅流管理 setRemoteAuxiliaryStreamViewRotation virtual int setRemoteAuxiliaryStreamViewRotation(const char *userId, HRTCVideoRotation rotation) 【功能说明
SparkRTC是否支持对房间进行权限校验？ 支持用户鉴权，华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id”、“role”、“ctime”和“signature”等信息，才能接入华为
初始化等基础接口 sharedEngine + (instancetype)sharedEngine; 【功能说明】 创建连麦引擎实例。 【请求参数】 无 【返回参数】 返回引擎实例对象。 destroy - (void)destroy; 【功能说明】 注销引擎。 【请求参数】 无
共享屏幕资源管理 本章节介绍了全平台C++ SDK的IHRTCScreenShareSourceList类接口详情。 表1 IHRTCScreenShareSourceList类 接口 描述 count 获取屏幕共享窗口资源数量 get 获取屏幕共享窗口资源信息 release 资源释放函数
客户端事件通知（ClientEvent） 本章节介绍了Web SDK的ClientEvent事件。 表1 ClientEvent事件 接口 描述 peer-join 远端用户进入房间事件。 peer-leave 远端用户退出房间事件。 stream-added 远端流添加事件。 stream-removed
通话中质量监测 功能描述 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前本地和远端的音视频统计信息。 接口调用流程 实现通话中质量监测 通话质量上报 onNetworkQualityNotify，房间内客户端网络质量实时上报，默认开启，每2s上报一次，两人以上才会回调
配置录制回调 SparkRTC服务提供了录制任务状态回调设置，支持配置HTTP/HTTPS URL，向用户服务器发送POST请求，将录制任务状态信息实时反馈到用户服务器。 回调协议 请求：HTTP POST请求，请求Body的内容为JSON格式。 应答：HTTP STATUS CODE
查询单个应用 功能介绍 调用此接口查询单个应用详情。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/apps/{app_id} 表1 路径参数 参数
什么是Signature？ 为保证RTC的通信安全，当用户加入频道时，华为云SparkRTC服务需要对其进行接入鉴权。 图1 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应的SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id
屏幕共享 getScreenShareSources virtual IHRTCScreenShareSourceList* getScreenShareSources(HRTCScreenShareIconType type) 【功能说明】 获取屏幕可共享对象列表。 【请求参数】
通话质量监测 功能描述 加入房间后，SDK上报通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。 接口调用流程 通话质量上报 network-quality网络上下行质量报告事件，用户加入房间后，在网络质量变化的时候会触发一次该事件，报告用户的本地网络上下行质量情况
检测功能 startNetworkTest public abstract int startNetworkTest(HRTCNetworkTestConfig networkTestConfig); 【功能说明】 启动入会前网络检测。 【请求参数】 networkTestConfig
获取项目ID 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。您可以通过以下两种方式获取项目ID。 从控制台获取项目ID 调用API获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标悬停在右上角的用户名，选择下拉列表中“我的凭证”。 图1 管理控制台
隐私声明 华为云SparkRTC SDK是由华为云计算有限公司（以下简称“我们”或“华为云”）面向华为云客户提供，方便用户接入实时音视频。华为云客户根据开发文档和用户指南，在其应用中集成SparkRTC SDK后，我们将通过被集成的SparkRTC SDK向华为云客户面向的最终用户
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
