检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SparkRTC多人视频通话支持仅订阅2/3/4人音频吗？ 支持，SparkRTC提供音频TopN模式也叫音频最大三方模式。开启音频TopN模式后，本地用户不需要通过调用接口单独订阅某个远端用户的音频，即可接收到当前房间内音量值最大的三个用户的音频。具体接口调用请参见切换音频模式。 父主题： SDK使用
终端节点即调用API的请求地址，SparkRTC部署时不区分物理区域，为全局服务。因此，SparkRTC的终端节点如表1所示。 表1 SparkRTC的终端节点 区域名称 区域 终端节点（Endpoint） 所有 ALL rtc-api.myhuaweicloud.com 约束与限制 华为云实时音视频服务
常用概念 应用标识 应用标识或应用ID，简称appID，是SparkRTC用来区分不同应用的唯一标识，在SparkRTC控制台中创建应用时自动生成。 房间 房间是一个音视频空间，同一房间内的用户可以互相接收对方的实时音视频数据。 SparkRTC使用房间这个虚拟的概念，用于用户之间的相互隔离。
远端用户音频流，才可接收该用户音频。 会中通过调用switchAudioMode(3)将音频切换为最大三方模式。最大三方模式下，本地用户不需要单独主动订阅某个远端用户音频流，即可接收当前房间内声音最大的三个用户的音频。 接口调用流程 实现过程 加入房间前设置音频最大三方模式 入会
获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要项目级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity":
SDK使用 创建引擎并初始化。 域名不需要设置，由SDK自动获取。appId获取方法请参见创建应用。 1 2 3 4 5 6 7 8 9 10 11 12 _rtcEngine = [HWRtcEngine sharedEngine]; HWRtcEngineConfig
SparkRTC会根据配置的录制规则对正在直播的音视频进行录制。 若配置录制规则时，未开启自动录制功能，则加入SparkRTC房间后，您需要调用实时音视频API开启、查询和控制云端录制任务。SparkRTC服务才会根据接口中的录制规则ID对实时音视频互动画面进行录制。 回放录制
每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口，您可以从接口的请求部分看到所需的请求参数及参数说明，将消息体加入后的请求如下所示，其中加粗的字段需要根据实际值填写。
入门指引 首次使用SparkRTC，您需要完成如下操作： 注册华为账号：单击进入注册页面。 完成实名认证：单击进入实名认证。 账户充值：为确保正常使用SparkRTC，您需要进行账户充值（超过1元）。 提交工单联系华为云技术客服，进行业务咨询。 图1 入门流程 SparkRTC的入门操作流程说明如表1所示。
用户昵称，该昵称为UTF-8编码。 signature：必选，string[512]类型，鉴权签名字串，应用开发者需要向远端服务器获取鉴权签名。 远端服务器需要您自行部署，具体请参见接入鉴权。 ctime：必选，string类型，签名UTC时间戳，单位秒。 role：必选，nu
DOMESTIC：国内范围。 OVERSEA：海外范围。 GLOBAL：全球范围。 tenant_name String 账号名 domain String 域名，App对应域名 create_time String 创建时间，形如“2006-01-02T15:04:05.075Z”，时区为：UTC authentication
导入HWRTCEngine动态库和RTC.bundle文件 在“General”页面将SDK中HWRTCEngine.framework文件加入到工程。如果需要使用混音功能，请添加hwffmpeg.framework库文件至HWRTCEngine.framework同级目录。 图2 添加HWRTCEngine
登录实时音视频控制台。 在左侧导航栏中，选择“应用管理”，进入“应用管理”页面。 在需要编辑的应用行单击应用名称，进入应用详情页面。 在应用详情页面，您可以查看到该应用的ID、名称、对应域名、创建时间、鉴权密钥等信息。 图2 编辑应用 在应用编辑页面，您可以根据实际需求进行如下操作：
如果客户端用TypeScript开发，TypeScript的版本不低于3.8.3。 由于浏览器安全策略限制，仅支持通过https://域名的方式访问，或者直接在本地搭建服务器，通过localhost:端口访问，否则无法获取摄像头及麦克风的权限。 SDK集成 将获取的SDK压缩包放置在自己项目的“sdk”目录下。
domain：可选，string[128]类型，服务器的域名。需要与注册到SparkRTC平台的合法企业域名保持一致，该参数在SDK 1.0+版本中必填，SDK 2.0+版本中非必填。 countryCode: 可选，string[2]类型，需要满足ISO 3166-1的2位字母的国家码要求
问题定位和原因分析，有效解决通话质量问题。 注意事项 “通话调查”中的数据仅供数据分析和质量问题查询，计费数据请以账单为准。 由于统计数据需要时间，可能会有5分钟以内的延迟。 查询说明 支持查询的时间跨度最长为14天。 支持查询最近24小时的实时数据。 通话调查中提供的数据包括：
数据分析。 表1 控制台功能介绍 分类 功能 功能介绍 应用管理 应用管理 支持用户创建并管理应用，应用创建后可以使用对应的App ID和域名进入互动频道。 录制配置 支持为实时音视频互动配置录制规则，SparkRTC将按照录制规则ID进行录制，并将录制文件存储到OBS桶中。 视镜
RtcServerRoomInfo objects 房间列表信息 表6 RtcServerRoomInfo 参数 参数类型 描述 domain String 域名 app String 应用标识 room_id String 房间ID state String 房间状态，取值如下： RUNNING：开启中
users Array of RtcUser objects 用户列表 表6 RtcUser 参数 参数类型 描述 domain String 域名 app String 应用标识 room_id String 房间ID uid String 用户id session String 会话id
DOMESTIC：国内范围。 OVERSEA：海外范围。 GLOBAL：全球范围。 tenant_name String 账号名 domain String 域名，App对应域名 create_time String 创建时间，形如“2006-01-02T15:04:05.075Z”，时区为：UTC authentication
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
