检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
视频通话、互动直播、在线课堂等。 角色切换 支持房间内角色切换,观众自由、平滑上下麦,切换过程无需等待。 互动直播、在线课堂等。 单用户加入多房间 支持单个主播加入多个房间互动PK。 秀场直播、PK连麦、超级大班课等。 屏幕分享 支持将本地电脑桌面、窗口、画面区域分享给他人。 互动课堂、视频会议、远程协助等。
概述 华为云实时音视频服务提供的云端录制回放功能适用于需要将音视频通话或互动直播过程进行录制和存储的业务场景。云端录制功能包含两种模式,如表1所示。 表1 云端录制模式 模式 说明 适用场景 单流录制 支持单流录制,可按用户进行录制。 支持自启动录制,开启后对房间内每一个流进行录制。
error_code String 错误码 error_msg String 错误描述 请求示例 停止指定应用id和任务编号的合流录制任务 DELETE https://rtc-api.myhuaweicloud.com/v2/apps/{app_id}/mix-stream-jobs/{job_id}
error_code String 错误码 error_msg String 错误描述 请求示例 删除指定应用id的应用 DELETE https://rtc-api.myhuaweicloud.com/v2/apps/{app_id} 响应示例 状态码: 400 删除失败,删除条件不满足
String 错误码 error_msg String 错误描述 请求示例 踢除指定房间号内的user001和user002用户 POST https://{endpoint}/v2/apps/{app_id}/rooms/{room_id}/batch-remove-users {
描述 error_code String 错误码 error_msg String 错误描述 请求示例 启用指定应用id的应用 POST https://rtc-api.myhuaweicloud.com/v2/apps/{app_id}/enable 响应示例 状态码: 200 启用成功
remoteAudioInfo:(NSArray<HWRtcAudioStatsInfo *> *)remoteAudioStatsInfos {https://support.huaweicloud.com/csdk-rtc/rtc_05_0167.html dispatch_as
error_code String 错误码 error_msg String 错误描述 请求示例 删除指定应用id和规则id的录制规则 DELETE https://rtc-api.myhuaweicloud.com/v2/apps/{app_id}/record-rules/{rule_id}
参数类型 描述 error_code String 错误码 error_msg String 错误描述 请求示例 解散指定房间 POST https://{endpoint}/v2/apps/{app_id}/rooms/{room_id}/dismiss 响应示例 状态码: 400
【请求参数】 无 【返回参数】 >= 0:音量大小,范围为0-100。 < 0:方法调用失败。具体请参见客户端错误码。 音效文件支持同时播放多个,setAudioClipsVolume接口设置的音量是所有音频文件的最大音量,setVolumeOfAudioClip接口设置的是单个音效文件的音量,音效文件的实际播放音量
引擎创建相关参数 属性 类型 描述 context Context 上下文 appId String 应用ID,只有App ID相同的应用程序才能进入同一个房间进行互动。appId获取方法请参见应用管理 countryCode String 国家码,具体请参见国家码对照表 logEnable boolean
状态码 调用实时音视频API时,可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求,但未处理完成。 204 No Content 请求完全成功,同时HTTP响应不包含响应体。
接口总览 本章节介绍了iOS/macOS SDK的HWRtcEngine接口详情。 HWRtcEngine按照其功能可分类为:初始化等基础接口、房间功能、视频管理、辅流管理、共享屏幕、音频管理、音效文件播放管理、自定义视频采集和渲染、自定义音频采集和渲染、设备管理、检测功能、音频增强管理。
接口按功能说明 初始化等基础接口 表1 初始化等基础接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 createHRtcEngine 创建IHRTCEngine对象 √ √ √ √ getHRtcEngine 获取创建后的IHRTCEngine对象
视频管理 createRenderer public abstract SurfaceView createRenderer(Context context) 【功能说明】 创建渲染视图。 【请求参数】 context:上下文。 【返回参数】 创建的渲染视图。 updateLocalRenderMode
error_code String 错误码 error_msg String 错误描述 请求示例 更新指定应用id和任务编号的单流任务 PUT https://{endpoint}/v2/apps/{app_id}/individual-stream-jobs/{job_id} 响应示例 状态码:
更新录制规则 功能介绍 调用此接口更新录制规则。 接口约束 如果规则修改后,修改后的规则对正在录制的流无效。 修改后对新的流有效,生效时间为5分钟,即修改规则5分钟后的录制任务会使用新规则进行录制。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API E
查询录制规则列表 功能介绍 调用此接口查询录制规则列表。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v2/apps/{app_id}/record-rules
查询录制规则 功能介绍 调用此接口查询指定录制规则。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v2/apps/{app_id}/record-rules/{rule_id}
接入鉴权 为保证SparkRTC的通信安全,当用户加入房间时,华为云SparkRTC服务需要对其进行接入鉴权。本章节主要介绍华为云SparkRTC接入鉴权的实现原理及鉴权签名的生成方法。 鉴权原理 华为云SparkRTC系统使用数字签名作为接入鉴权方式,需要在SDK加入房间时设置