检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接入鉴权 为保证SparkRTC的通信安全,当用户加入房间时,华为云SparkRTC服务需要对其进行接入鉴权。本章节主要介绍华为云SparkRTC接入鉴权的实现原理及鉴权签名的生成方法。 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式,需要在SDK加入房间时设置“
配置录制规则 SparkRTC服务支持将实时音视频互动内容进行录制并将录制的内容存储到OBS桶中,您可以在OBS服务中对录制的音视频文件进行下载、分享等处理。相关操作流程,如图1所示。 图1 录制流程图 创建桶:创建用于存储SparkRTC录制文件的OBS桶,若已有OBS桶,请直接执行
更新自动录制配置 功能介绍 更新自动录制配置,租户可以开启自动单流录制或者停用自动单流录制(仅支持单流录制)。 接口约束 开启自动单流录制功能之后,只针对新创建的房间有效,对开启自动录制功能之前已经创建的房间不生效。 单流自动录制任务的流名规则: {appid}_{roomid}_
能否直接开通后付费? 华为云实时音视频服务默认按需计费,您可以先使用后付费,不使用时不计费。 父主题: 计费购买
如何创建房间? 房间是由SparkRTC后台在客户端进房时自动创建的,您无需手动创建房间,只需调用客户端的相关接口加入房间即可。具体接口详情请参见客户端SDK参考。 父主题: SDK使用
Android SDK 开发前准备 SDK使用 基本使用逻辑 接口参考 常见问题 修订记录
启动单流任务 功能介绍 调用此接口接口启动单流任务。 API触发单流录制流名规则:{jobtype}_{jobid}_{roomid}_{userid} jobtype取值为's'代表单流录制。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer
示例2:创建合流录制任务 场景描述 示例1:创建单流录制任务已介绍了如何将房间中的每一个用户的音视频流分别录制成独立的文件。若您需要将房间中的多个单流用户录制成一个文件,您可以参考此章节内容调用SparkRTC API进行合流录制。 前提条件 已获取需要使用的SparkRTC服务的终端节点
SparkRTC支持哪些平台? SparkRTC支持的平台有Android、iOS、MAC、Windows和Web。其中支持的各平台系统版本如下所示: Android:支持Android 5.0及以上版本。 iOS:支持iOS 8.0及以上版本。 MAC:支持MacOS10.11或以上版本
如何获取密钥? app_key为华为云SparkRTC针对每个app生成的鉴权密钥,需要安全保存,谨防泄漏。您可以通过以下方式获取: 登录实时音视频控制台。 在左侧导航栏中,选择“应用管理”,进入应用管理页面。 在目标应用行单击应用名称,进入应用详情页面。 “鉴权私钥”可见状态下,
Web SDK 浏览器适配 开发前准备 SDK使用 基本使用逻辑 接口参考 常见问题 修订记录
删除录制规则 功能介绍 调用此接口删除录制规则,对于正在使用的录制规则,不允许删除。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI DELETE /v2/apps/{
更新单流任务 功能介绍 调用此接口修改单流任务。 仅部分场景支持修改。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI PUT /v2/apps/{app_id}/individual-stream-jobs
什么是Signature? 为保证RTC的通信安全,当用户加入频道时,华为云SparkRTC服务需要对其进行接入鉴权。 图1 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式,需要在相应的SDK的初始化或登录函数中提供“app_id”、“room_id”、“user_id
SparkRTC支持白板功能吗? 不支持,白板功能是为APP层级的应用。 父主题: SDK使用
SparkRTC支持旁路推流吗? 支持,具体请参见startPublishStream、updateTransCoding、stopPublishStream接口。 父主题: SDK使用
接口参考 主入口(HRTC) 客户端对象(Client) 客户端事件通知(ClientEvent) 流对象(Stream) 本地流对象(LocalStream) 远端流对象(RemoteStream) 流事件通知(RTCStreamEvent) 错误码(RtcError) 客户端错误码
查询单流任务状态 功能介绍 调用此接口查询单流任务状态。 租户的OBS桶内的情况,暂不支持查询。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v2/apps
示例1:创建单流录制任务 场景描述 若您需要对某一个房间的实时音视频进行录制,可以在加入房间后,调用录制接口创建单流录制任务。 前提条件 已获取需要使用的SparkRTC服务的终端节点:rtc-api.myhuaweicloud.com。 已创建用于存储录制文件的OBS桶,并完成OBS
接收增值(录制)事件回调通知内容 SparkRTC服务回调用户提供的接口时,会附带以下信息。 表1 请求Body参数 参数 是否必选 参数类型 描述 job_id 否 String 任务编号,可以用于修改、查看和停止录制任务 stream_name 否 String 流名 app_id