检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前必须 华为云实时音视频服务（SparkRTC）凭借在视频业务领域长期技术积累，快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务，适用于在线教育、云会议、社交文娱等场景。 您可以使用本文档提供的API对华为云实时音视频服务进行相关操作，如应
SDK概述 华为云实时音视频服务软件开发工具包是对SparkRTC服务提供的REST API进行的封装，以简化用户的开发工作。用户直接调用SparkRTC SDK提供的接口函数即可实现使用SparkRTC服务业务能力的目的。 相关开发包请提交工单联系华为云技术客服获取。 同时，针
调用跨房连接的joinRoom加入跨房房间 调用跨房连接的joinRoom接口加入房间，其中HWRtcUserInfo的signature鉴权签名字符串需要填入正确的计算值，计算方法请参考接入鉴权。 如果本端需要发送音频或者视频流给跨房房间里的远端用户，则用户的role参数需要设为HWRtcRoleJoiner
调用跨房连接的joinRoom加入跨房房间 调用跨房连接的joinRoom接口加入房间，其中HWRtcUserInfo的signature鉴权签名字符串需要填入正确的计算值，计算方法请参考接入鉴权。 如果本端需要发送音频或者视频流给跨房房间里的远端用户，则用户的role参数需要设为HWRtcRoleJoiner
间 调用跨房连接的joinRoom接口加入房间，其中HRTCJoinParam的authorization鉴权签名字符串需要填入正确的计算值，计算方法请参考接入鉴权。 如果本端需要发送音频或者视频流给跨房房间里的远端用户，则用户的role参数需要设为HRTC_ROLE_TYPE_
事件回调（IHRTCEncDecryptFrameObserver） 表1 媒体数据回调说明 接口 描述 onMediaFrameEncrypt 编码后的媒体数据（加密处理） onMediaFrameDecrypt 解码前的媒体数据（解密处理） onMediaFrameEncrypt
请参见OBS帮助中心创建桶。 操作步骤 登录实时音视频控制台。 在左侧导航树中选择“云资源授权”，进入桶授权页面。 您也可以通过在“添加录制规则”页面的“存储-桶”中，单击“去授权”跳转到“云资源授权”页面进行OBS桶授权。 找到需要存储录制文件的OBS桶，在右侧“操作”列，单击“授权”即可，如图1所示。
使用时请注意。 Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通
云端录制与回放 概述 单流录制 合流录制
功能特性 华为云SparkRTC提供了视频通话、连麦互动等功能，如表1所示。 表1 功能列表 功能 说明 常见场景 视频通话 即1对1或多人视频通话，支持720P及以上高清画质。单个房间最多支持2000人同时在线，最高支持500人互动。 1对1视频通话、视频会议、在线问诊、多人视
通话中有一方的网络出现问题，其他人也会看不到此用户的视频。 用户主动关闭了视频。 您可以通过视镜功能进行端到端链路检查。 若问题仍未解决，建议您提交工单，申请华为云技术客服协助解决问题。 父主题： 问题排查
怎么理解SparkRTC的角色Role？ 角色Role是指用户在房间内的不同角色类型，不同角色类型有不同的权限模型。主要有如下三种角色类型： 主播（publisher）：只发流不收流主播型角色。SparkRTC预留的角色类型。 互动观众（joiner）：既能发流也能收流的互动型角色。
页选择“视频 > 实时音视频”。 如果未注册，请单击此处注册华为账号并开通华为云，完成实名认证。 API方式 如果用户需要将华为云实时音视频服务集成到第三方系统，用于二次开发，请使用API方式访问华为云实时音视频服务，具体操作请参见《服务端API参考》。
修改合流任务 功能介绍 调用此接口更新合流任务布局。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI PUT /v2/apps/{app_id}/mix-stream-jobs/{job_id}
若您未有存储录制文件的OBS桶，请参见OBS帮助中心创建桶。否则，请直接执行步骤二：云资源授权。 暂只支持录制存储在华北-北京四的OBS桶中。 步骤二：云资源授权 将OBS桶授权给SparkRTC服务，允许录制文件存储在OBS桶中。具体授权方法请参见云资源授权。 步骤三：配置录制规则 登录实时音视频控制台。
查询合流任务 功能介绍 调用此接口查询合流转码任务状态。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/apps/{app_id}/mix-stream-jobs/{job_id}
客户端事件通知（ClientEvent） 本章节介绍了Web SDK的ClientEvent事件。 表1 ClientEvent事件 接口 描述 peer-join 远端用户进入房间事件。 peer-leave 远端用户退出房间事件。 stream-added 远端流添加事件。 stream-removed
接入鉴权 为保证SparkRTC的通信安全，当用户加入房间时，华为云SparkRTC服务需要对其进行接入鉴权。本章节主要介绍华为云SparkRTC接入鉴权的实现原理及鉴权签名的生成方法。 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式，需要在SDK加入房间时设置
常见问题 加入房间时，userName必须填吗？ 非必填。userName、userId由App自定义，但可以相同。 userId：必填，string[64]类型，用户标识，userId需要保证应用内唯一。userId支持的字符包括：a-z、A-Z、0-9、连接符 '-'、下划线
客户端错误码 本章节介绍了iOS/macOS SDK的客户端错误码HWRtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因 HWRtcErrorCodeSuccess 0 调用成功 - HWRtcErrorCodeSdkInternalError
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
