检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
域名不需要设置，由SDK自动获取。appId获取方法请参见创建应用。
应用管理 您可以在实时音视频控制台创建应用并查询应用的基本信息，应用创建后，您可以使用应用对应的App ID和域名进入互动频道。 注意事项 首次使用华为云实时音视频服务，请先提交工单联系华为云技术客服进行业务咨询。 创建应用 登录实时音视频控制台。
入门指引 首次使用SparkRTC，您需要完成如下操作： 注册华为账号：单击进入注册页面。 完成实名认证：单击进入实名认证。 账户充值：为确保正常使用SparkRTC，您需要进行账户充值（超过1元）。 提交工单联系华为云技术客服，进行业务咨询。
1 2 let config = { appId,domain,countryCode } let client = HRTC.createClient(config) domain：string[128]类型，服务器域名。
已集成Web SDK 1.0+版本（2.0+版本不涉及）的用户，请尽快升级至1.10.0+版本，否则在Chrome 96+浏览器上有可能出现无法使用的情况。 Web SDK 2.0+版本是目前的主力构建版本，承载新功能及体验优化，建议您优先集成使用。
注册回调（IHRTCMediaEngine） 本章节介绍了全平台C++ SDK的IHRTCMediaEngine类接口详情。
】 注册原始视频媒体数据监听回调。
注册回调（IHRTCMediaEngine） 表1 HWRtcMediaEngine 接口 描述 setVideoFrameObserver 注册原始视频媒体数据监听回调 setAudioFrameObserver 注册原始音频媒体数据监听回调 setVideoFrameObserver
Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如IAM服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。
由于浏览器安全策略限制，仅支持通过https://域名的方式访问，或者直接在本地搭建服务器，通过localhost:端口访问，否则无法获取摄像头及麦克风的权限。 SDK集成 将获取的SDK压缩包放置在自己项目的“sdk”目录下。 在项目代码中引入“hrtc”。
表1 控制台功能介绍 分类 功能 功能介绍 应用管理 应用管理 支持用户创建并管理应用，应用创建后可以使用对应的App ID和域名进入互动频道。 录制配置 支持为实时音视频互动配置录制规则，SparkRTC将按照录制规则ID进行录制，并将录制文件存储到OBS桶中。
domain：可选，string[128]类型，服务器的域名。需要与注册到SparkRTC平台的合法企业域名保持一致，该参数在SDK 1.0+版本中必填，SDK 2.0+版本中非必填。
表1 SparkRTC的终端节点 区域名称 区域 终端节点（Endpoint） 所有 ALL rtc-api.myhuaweicloud.com 约束与限制 华为云实时音视频服务设置了API流控，避免出现因短时间内重复调用API，服务中断的情况。
事件注册监听应在业务结束时取消注册，否则注册监听事件累积会有内存泄漏风险。 peer-join 【事件说明】 远端用户加入房间事件，远端用户加入房间后会收到该事件通知。 【回调参数】 peerJoinEvent：必选，PeerJoin类型，用户信息。
tenant_name String 账号名 domain String 域名，App对应域名 create_time String 创建时间，形如“2006-01-02T15:04:05.075Z”，时区为：UTC authentication AppAuth object 鉴权配置
tenant_name String 账号名 domain String 域名，App对应域名 create_time String 创建时间，形如“2006-01-02T15:04:05.075Z”，时区为：UTC authentication AppAuth object 鉴权配置
事件注册监听应在业务结束时取消注册，否则注册监听事件累积会有内存泄漏风险。 player-state-change 【事件说明】 播放状态变更事件。在播放状态变更的时候触发。 【回调参数】 event：playState类型。
在通话详情页面，您可以根据实际需求查看以下信息： 通话基本信息：可查看房间ID、应用ID、域名、房间状态、整段通话的起止时间。单击“查看事件”还可查看用户在该房间中的所有操作事件，具体事件类型及ID请参见表1。
2021-06-05 第十一次正式发布 本次发布版本为1.8.0版本，整合了之前若干版本和分支的一个全新版本，主要变更内容为跨房功能重构，结合服务端升级，可以支持2W人超大型会议和最多同时跨5个房间互动等场景。此外，管控面和用户体验上也新增了部分功能和优化。
Integer 查询结果限制 offset Integer 查询偏移量 room_info_list Array of RtcServerRoomInfo objects 房间列表信息 表6 RtcServerRoomInfo 参数 参数类型 描述 domain String 域名
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
