检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
入门指引 首次使用SparkRTC，您需要完成如下操作： 注册华为账号：单击进入注册页面。 完成实名认证：单击进入实名认证。 账户充值：为确保正常使用SparkRTC，您需要进行账户充值（超过1元）。 提交工单联系华为云技术客服，进行业务咨询。 图1 入门流程 SparkRTC的入门操作流程说明如表1所示。
DOMESTIC：国内范围。 OVERSEA：海外范围。 GLOBAL：全球范围。 tenant_name String 账号名 domain String 域名，App对应域名 create_time String 创建时间，形如“2006-01-02T15:04:05.075Z”，时区为：UTC authentication
Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权
DOMESTIC：国内范围。 OVERSEA：海外范围。 GLOBAL：全球范围。 tenant_name String 账号名 domain String 域名，App对应域名 create_time String 创建时间，形如“2006-01-02T15:04:05.075Z”，时区为：UTC authentication
应用管理 您可以在实时音视频控制台创建应用并查询应用的基本信息，应用创建后，您可以使用应用对应的App ID和域名进入互动频道。 注意事项 首次使用华为云实时音视频服务，请先提交工单联系华为云技术客服进行业务咨询。 停用或删除应用会导致业务不可用，请谨慎处理。 创建应用 登录实时音视频控制台。
SDK使用 创建引擎并初始化。 域名不需要设置，由SDK自动获取。appId获取方法请参见创建应用。 1 2 3 4 5 6 7 8 9 10 11 12 _rtcEngine = [HWRtcEngine sharedEngine]; HWRtcEngineConfig
于浏览器的安全策略，必须要支持跨域，否则请求失败。 注意：混音只有对端可以听到，本端听不见。 音频TopN 模式（音频最大三方模式）是什么意思？ 音频TopN模式也叫音频最大三方模式。开启音频TopN模式后，本地用户不需要通过调用接口，单独订阅某个远端用户的音频，即可接收到当前房
尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的En
注意事项 当前只支持YUV420数据格式处理。 接口调用流程 注册视频前后处理 获取HWRtcEngine的HWRtcMediaEngine对象。 [HWRtcEngine sharedEngine].mediaEngine 注册视频前后处理 [[HWRtcEngine sharedEngine]
countryCode } let client = HRTC.createClient(config) domain：string[128]类型，服务器域名。该参数在SDK 1.0+版本中必填，SDK 2.0+版本中非必填。 appId：string[128]类型，必填。应用ID，只有App
RtcServerRoomInfo objects 房间列表信息 表6 RtcServerRoomInfo 参数 参数类型 描述 domain String 域名 app String 应用标识 room_id String 房间ID state String 房间状态，取值如下： RUNNING：开启中
实现原始视频数据（视频前后处理） 注册视频前后处理 获取mHwRtcEngine的MediaEngine对象，调用setVideoFrameObserver方法进行注册。 传入的参数是需要实现了IHRTCVideoFrameObserver的实例对象。 从回调中获取视频帧，并进行处理。
数据分析。 表1 控制台功能介绍 分类 功能 功能介绍 应用管理 应用管理 支持用户创建并管理应用，应用创建后可以使用对应的App ID和域名进入互动频道。 录制配置 支持为实时音视频互动配置录制规则，SparkRTC将按照录制规则ID进行录制，并将录制文件存储到OBS桶中。 视镜
所示。 图4 用户详情页面 其中，音视频选看和辅流选看页签中展示的是从特定发送端到接收端的音视频质量指标详情，您可以通过分析各项质量指标，找到通话体验质量问题所在。 通话基本信息：可查看房间ID、应用ID、域名、房间状态、整段通话的起止时间。 用户画像信息：可查看用户在线时长、5s加入房间失败次数、推拉流失败次数。
users Array of RtcUser objects 用户列表 表6 RtcUser 参数 参数类型 描述 domain String 域名 app String 应用标识 room_id String 房间ID uid String 用户id session String 会话id
String 项目ID，获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 domain 否 String 域名 app_id 是 String 应用id room_id 是 String 房间ID user_id 否 String 发送端用户 peer_id
终端节点即调用API的请求地址，SparkRTC部署时不区分物理区域，为全局服务。因此，SparkRTC的终端节点如表1所示。 表1 SparkRTC的终端节点 区域名称 区域 终端节点（Endpoint） 所有 ALL rtc-api.myhuaweicloud.com 约束与限制 华为云实时音视频服务
创建一个实时音视频通话的客户端对象。一个Client对应于一个房间。 createStream 创建一个本地流对象。流分为主流和辅流。主流指从摄像头和麦克风采集的音视频流，辅流是从共享屏幕采集的音视频流。 setLogLevel 设置日志级别。 checkSystemRequirements 如果Web
如果客户端用TypeScript开发，TypeScript的版本不低于3.8.3。 由于浏览器安全策略限制，仅支持通过https://域名的方式访问，或者直接在本地搭建服务器，通过localhost:端口访问，否则无法获取摄像头及麦克风的权限。 SDK集成 将获取的SDK压缩包放置在自己项目的“sdk”目录下。
更新旁路推流的事件。该事件为2.0.0版本新增。 rtc-stats 音视频流数据统计事件。该事件为2.0.3版本新增。 事件注册监听应在业务结束时取消注册，否则注册监听事件累积会有内存泄漏风险。 peer-join 【事件说明】 远端用户加入房间事件，远端用户加入房间后会收到该事件通知。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
