检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
隐私声明 华为云SparkRTC SDK是由华为云计算有限公司（以下简称“我们”或“华为云”）面向华为云客户提供，方便用户接入实时音视频。华为云客户根据开发文档和用户指南，在其应用中集成SparkRTC SDK后，我们将通过被集成的SparkRTC SDK向华为云客户面向的最终用
启动单流任务 功能介绍 调用此接口接口启动单流任务。 API触发单流录制流名规则：{jobtype}_{jobid}_{roomid}_{userid} jobtype取值为's'代表单流录制。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Exp
查询OBS桶下对象列表 功能介绍 查询OBS桶下对象列表。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/rtc-ops/buckets/objects
初始化等基础接口 createHRtcEngine huawei::rtc::IHRTCEngine* createHRtcEngine(void); 【功能说明】 创建IHRTCEngine对象。 【返回参数】 huawei::rtc::IHRTCEngine*：IHRTCEngine对象。
数据类型 本章节列出了iOS/macOS SDK的所有数据类型，您可以结合HWRtcEngine接口和回调进行开发。 表1 数据类型 类型 描述 HWRtcUserInfo 用户信息 HWRtcJoinParam 入会信息 HWRtcVideoEncode 视频编码 HWRtcDeviceInfo
更新录制规则 功能介绍 调用此接口更新录制规则。 接口约束 如果规则修改后，修改后的规则对正在录制的流无效。 修改后对新的流有效，生效时间为5分钟，即修改规则5分钟后的录制任务会使用新规则进行录制。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API E
查询单流任务状态 功能介绍 调用此接口查询单流任务状态。 租户的OBS桶内的情况，暂不支持查询。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/ap
创建或更新录制规则 功能介绍 调用此接口创建或更新录制规则。 若当前app在请求的location中无录制规则，则会创建新的录制规则 若当前app在请求的location中已有录制规则，则会更新原来的录制规则 接口约束 一个app在一个location最多创建一个录制规则。 调试
客户端错误码 本章节介绍了Web SDK的客户端错误码RtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 RTC_ERR_CODE_SUCCESS 0 success 成功。 RTC_ERR_CODE_RTC_SDK_ERROR 90000001
事件回调（HWRtcConnection） 本章节介绍了iOS/macOS SDK的回调接口HWRtcConnectionDelegate的详情。 表1 事件回调说明 接口 描述 connection:onJoinSuccess 成功加入跨房房间回调 connection:onJoinRoomFailure
概述 华为云实时音视频服务提供的云端录制回放功能适用于需要将音视频通话或互动直播过程进行录制和存储的业务场景。云端录制功能包含两种模式，如表1所示。 表1 云端录制模式 模式 说明 适用场景 单流录制 支持单流录制，可按用户进行录制。 支持自启动录制，开启后对房间内每一个流进行录制。
接收增值（录制）事件回调通知内容 SparkRTC服务回调用户提供的接口时，会附带以下信息。 表1 请求Body参数 参数 是否必选 参数类型 描述 job_id 否 String 任务编号，可以用于修改、查看和停止录制任务 stream_name 否 String 流名 app_id
encoderParam：视频编码参数，具体请参见HRTCVideoEncParam。 【返回参数】 0：成功。 >0：失败。具体请参见客户端错误码。 安卓移动端采集帧率限制20帧，建议设置的编码帧率不要超过20帧 setNonStandardVideoEncoder public abstract
配置录制规则 SparkRTC服务支持将实时音视频互动内容进行录制并将录制的内容存储到OBS桶中，您可以在OBS服务中对录制的音视频文件进行下载、分享等处理。相关操作流程，如图1所示。 图1 录制流程图 创建桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。
修订记录 表1 修订记录 修改时间 修改说明 2022-06-21 第十八次正式发布 本次变更如下： 新增以下接口： addMultiRoomMediaRelay：添加单个跨房 removeMultiRoomMediaRelay：删除单个跨房 stopMultiRoomMediaRelay：停止所有跨房
接口参考 主入口（HRTC） 客户端对象（Client） 客户端事件通知（ClientEvent） 流对象（Stream） 本地流对象（LocalStream） 远端流对象（RemoteStream） 流事件通知（RTCStreamEvent） 错误码（RtcError） 客户端错误码
事件回调（IHRTCConnection） 本章节介绍了全平台C++ SDK的回调接口IHRTCEngineEventHandler的详情。 表1 回调 接口 描述 onError 错误回调。 onWarning 警告回调。 onConnectionChangedNotify 连接状态改变回调。
单流录制 场景说明 将房间中的每一个用户的音视频流分别录制成独立的文件。 录制机制 SparkRTC提供的单流录制支持自启动模式，即单流自动录制，具体的实现机制如下图所示。 图1 单流录制 图2 单流自动录制 实现流程 创建OBS桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。
使用前必须 华为云实时音视频服务（SparkRTC）凭借在视频业务领域长期技术积累，快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务，适用于在线教育、云会议、社交文娱等场景。 您可以使用本文档提供的API对华为云实时音视频服务进行相关操作，如应
合流录制 场景说明 将房间中的多路音视频进行云端混流，再将混合后的音视频流录制成一个文件。 合流布局 在合流录制模式下，支持分屏九宫格模板和共享屏幕模板（主视窗居左/主视窗居右）两种预设合流布局。同时，也支持用户自定义合流布局样式（自定义视频窗格位置）。 九宫格模板 每个用户画面
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
