检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Token认证：通过Token认证调用请求。 AK/SK认证 AK/SK签名认证方式仅支持消息体大小在12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥
LS。 实时音视频时延小于400ms，可适用于1对1或1对多的音视频通话，以及多人视频连麦和低时延视频直播。华为云SparkRTC服务提供了兼容全平台的SDK。 父主题： 产品咨询
90000002 发送的消息太大 发送消息时，消息体太大。 HRTC_ERR_CODE_MEM_NOT_ENOUGH 90000003 内存不足 内存申请不到。 HRTC_ERR_CODE_SYNSEND_MSG_ERR 90000004 消息发送失败 消息队列异常，导致内部消息发送失败。
应用场景 在线教育 高清、低时延、高并发直播，易集成，适用于在线学习、师生互动，支持快速部署到在线教育视频平台。 互动文娱 适用于网红直播、企业直播、娱乐直播、游戏直播等场景，提供功能强大的实时媒体处理能力，实现各种直播场景玩法，为客户和合作伙伴打造端到端一站式“音视频互动”解决方案。
接口总览 本章节介绍了全平台C++ SDK的IHRTCEngine接口详情。 IHRTCEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、屏幕共享、音频管理、音效文件播放管理、自采集自渲染、其他接口。 单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。
事件回调(IHRTCConnectionVideoFrameObserver) 本章节介绍了全平台C++ SDK的回调接口IHRTCConnectionVideoFrameObserver的详情。 表1 事件回调说明 接口 描述 onVideoFrameRender 渲染后视频回调（后处理）
注册回调（IHRTCMediaEngine） 本章节介绍了全平台C++ SDK的IHRTCMediaEngine类接口详情。 表1 IHRTCMediaEngine类 接口 描述 setVideoFrameObserver 注册原始视频媒体数据监听回调 setAudioFrameObserver
场景描述 若您需要对某一个房间的实时音视频进行录制，可以在加入房间后，调用录制接口创建单流录制任务。 前提条件 已获取需要使用的SparkRTC服务的终端节点：rtc-api.myhuaweicloud.com。 已创建用于存储录制文件的OBS桶，并完成OBS桶授权。您可以通过调用OBS
共享屏幕资源管理 本章节介绍了全平台C++ SDK的IHRTCScreenShareSourceList类接口详情。 表1 IHRTCScreenShareSourceList类 接口 描述 count 获取屏幕共享窗口资源数量 get 获取屏幕共享窗口资源信息 release 资源释放函数
"InvalidParameterValue" } 状态码： 500 创建合流任务失败，服务器错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError" } 状态码 状态码 描述 201 任务创建成功，返回job的概要信息
事件回调(IHRTCAudioFrameObserver) 本章节介绍了全平台C++ SDK的回调接口IHRTCAudioFrameObserver的详情。 表1 事件回调说明 接口 描述 onAudioFramePlayback 音频播放回调（后处理） onAudioFrameMixed
HRTCMultiRoomMediaRelayState：跨房状态 HRTCMultiRoomMediaRelayStateCode：跨房状态码 2022-03-24 第五次正式发布 本次变更如下： 修改appid获取方式的相关描述。 2022-03-18 第四次正式发布 本次变更如下：
中的多个单流用户录制成一个文件，您可以参考此章节内容调用SparkRTC API进行合流录制。 前提条件 已获取需要使用的SparkRTC服务的终端节点：rtc-api.myhuaweicloud.com。 已创建用于存储录制文件的OBS桶，并完成OBS桶授权。您可以通过调用OBS
> 0：方法调用失败。具体请参见HWRtcErrorCode。 如果手机分辨率不超过1080p，不可以设置为NO。 开启后，辅流发流分辨率为720p，否则发流分辨率为1080p。默认不开启。 pushAuxExternalVideoFrame - (int)pushAuxExter
0：方法调用成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。 收到onUserAuxiliaryStreamAvailable消息后，获取对应的userId。 多辅流场景，一个用户同时只能订阅一条辅流；当前正在订阅用户A的辅流，需要订阅另一个用户B的辅流时，需要先停止订阅用户A的辅流，再订阅用户B的辅流。
事件回调(IHRTCVideoFrameObserver) 本章节介绍了全平台C++ SDK的回调接口IHRTCVideoFrameObserver的详情。 表1 事件回调说明 接口 描述 onVideoFrameCapture 原始视频回调（前处理） onVideoFrameRender
音频文件播放管理 音频文件播放使用ffmpeg能力，在播放在线url时受windows平台自身特性影响，断网时会立刻停止播放（SparkRTC内部无缓存设计），若对该场景体验有要求，建议业务通过先下载到本地再播放的形式使用。 startAudioFile virtual int
03 入门 华为云提供了多终端的SDK，您可以快速集成SDK并实现SparkRTC基本功能。 SparkRTC快速入门 05 服务端API 华为云实时音视频服务支持通过API进行应用、录制管理、数据分析等。 快速入门 创建单流录制任务 创建合流录制任务 API参考 应用管理 录制规则管理
录制下来的文件存储到OBS或者点播服务中。 存储、录制审核、视频双录等。 文件混音 支持将本地或在线的音频和用户声音混音，发送给房间内其他用户。 在线教育、语聊房、在线合唱等。 旁路直播 将房间内的音视频流混流转码后推送RTMP的视频流给直播服务。 互动直播、大型会议等。 网络检测
对录制回调消息进行鉴权。本章节介绍录制回调鉴权签名的生成方法。 参数说明 表1 参数说明 参数 说明 X-Rtc-Rand 消息请求头中的随机数。 X-Rtc-Timestamp 消息请求头中的时间戳。 X-Rtc-Signature 消息请求头中的签名。 msg 消息请求中body体的内容。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
