检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口按功能说明 初始化等基础接口 表1 初始化等基础接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 createHRtcEngine 创建IHRTCEngine对象 √ √ √ √ getHRtcEngine 获取创建后的IHRTCEngine对象
实现音视频通话 实现音视频通话（Android） 实现音视频通话（iOS） 实现音视频通话（MAC） 实现音视频通话（Windows） 实现音视频通话（Web）
实现音视频通话（iOS） 环境准备 屏幕共享 通话质量监测 播放音效 播放音乐 原始音频数据（音频前后处理） 音频自采集和音频自渲染 原始视频数据（视频前后处理） 自定义视频采集 自定义视频渲染 加入多频道（跨房） 父主题： 实现音视频通话
实现音视频通话（MAC） 环境准备 屏幕分享 通话质量监测 播放音效 播放音乐 原始音频数据（音频前后处理） 音频自采集和音频自渲染 原始视频数据（视频前后处理） 自定义视频采集 自定义视频渲染 加入多频道（跨房） 父主题： 实现音视频通话
实现音视频通话（Web） 环境准备 屏幕分享 通话质量监测 播放音频文件（混音） 切换音频模式 父主题： 实现音视频通话
修订记录 表1 表1 修订记录 发布日期 修订说明 2023-11-30 实时音视频所有客户端类型均增加“环境准备”章节。 2022-09-30 更新“单流录制”和“合流录制”章节的操作内容。 2021-10-30 第一次正式发布。
应用示例 示例1：创建单流录制任务 示例2：创建合流录制任务
下线查询用户异常体验事件、查询用户异常体验事件分布、查询用户详情、查询房间详情、查询服务端实时通话指标和查询流量数据分布接口。 2021-09-07 第四次正式发布 本次变更如下： 应用回调管理中增加接收增值（录制）时间回调通知内容接口。 数据统计分析中增加查询服务端实时通话指标和查询流量数据分布接口。 修改创建或
地区名称缩写 表1 地区名称缩写 地区 英文缩写 其他 OT 北京 BJ 天津 TJ 重庆 CQ 上海 SH 广东 GD 海南 HI 广西 GX 云南 YN 山西 SX 河北 HE 内蒙古 NM 宁夏 NX 辽宁 LN 吉林 JL 黑龙江 HL 江苏 JS 浙江 ZJ 江西 JX
OBS桶管理 查询OBS桶列表 查询OBS桶下对象列表 OBS桶授权及取消授权
接入鉴权 为保证SparkRTC的通信安全，当用户加入房间时，华为云SparkRTC服务需要对其进行接入鉴权。本章节主要介绍华为云SparkRTC接入鉴权的实现原理及鉴权签名的生成方法。 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在SDK加入房间时设置
OnlineUsers:在线用户数 dimension 是 String 维度类型: region：省份 access_net：网络类型 platform：系统平台 sdk：SDK版本 time 是 String 查询时刻。UTC时间，格式：YYYY-MM-DDThh:mm:ssZ 请求参数 表3 请求Header参数
概述 华为云实时音视频服务提供的云端录制回放功能适用于需要将音视频通话或互动直播过程进行录制和存储的业务场景。云端录制功能包含两种模式，如表1所示。 表1 云端录制模式 模式 说明 适用场景 单流录制 支持单流录制，可按用户进行录制。 支持自启动录制，开启后对房间内每一个流进行录制。
API概览 华为云实时音视频服务对应的接口列表如下所示，在调用媒体处理API前，您需要先获取用户Token，Token可以用于调用其他API时鉴权，具体如何调用媒体处理API请参考应用示例。 应用管理接口 表1 应用管理接口 接口 说明 POST /v2/apps 创建应用 GET
加入房间后才能主动上传日志。 会触发以下回调： onLogUploadResult：日志上传结果回调。 onLogUploadProgress：日志上传进度回调，远端服务器不通时不会收到此回调。 getVersion virtual char* getVersion() 【功能说明】 获取当前SDK版本号。
支持用户鉴权，华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在相应SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id”、“role”、“ctime”和“signature”等信息，才能接入华为SparkRTC服务。具体请参见接入鉴权。
使用限制 在使用实时音视频前，您需要了解本服务的使用限制。 表1 使用限制 限制项 说明 应用创建 若首次使用SparkRTC，则需提交工单联系华为云技术客服进行咨询。 直播间人数 一个直播间最多支持500人同时通话。 Android SDK 系统版本：支持Android 5.0及以上版本。
ID相同的应用程序才能进入同一个房间进行互动。应用的appId请参考应用管理进行获取。 domain：可选，string[128]类型，服务器的域名。需要与注册到SparkRTC平台的合法企业域名保持一致，该参数在SDK 1.0+版本中必填，SDK 2.0+版本中非必填。 countryCode:
请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。
配置录制回调 SparkRTC服务提供了录制任务状态回调设置，支持配置HTTP/HTTPS URL，向用户服务器发送POST请求，将录制任务状态信息实时反馈到用户服务器。 回调协议 请求：HTTP POST请求，请求Body的内容为JSON格式。 应答：HTTP STATUS CODE
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
