检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
state, HRTCMediaConnChangeReason reason, String description); 【功能说明】 媒体服务器连接状态变更通知。加入房间过后，收到媒体服务的数据包时，返回Connected消息，超过6s没有收到包，则返回Failed消息。 【回调参数】
onMultiRoomMediaRelayStateChanged 跨房状态回调 onMediaAddressNotify 加入房间成功之后sfuip地址回调 onJoinSuccess -(void)onJoinSuccess:(NSString*)roomId userId:(NSString*)userId;
0：方法调用成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。 该接口不改变本地摄像头的预览画面，但会使远端用户看到的和服务器录制的画面为指定的镜像效果。 startPublishStream - (int)startPublishStream:(NSString
0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。 该接口不改变本地摄像头的预览画面，但会使远端用户看到的和服务器录制的画面为指定的镜像效果。 setCameraConfig virtual int setCameraConfig(HRTCCameraConfig
如何进行视频自渲染显示正常图像？ 在开启自渲染后，通过onRenderExternalVideoFrame接口接收SDK回调的图像信息，需要自行解析其中的图像信息，包括尺寸、格式、数据。以YUV格式举例，SDK返回的YUV格式是YUV420，故Y、U、V三分量需要按照下面的方式获取： ByteBuffer
metric 是 Array of strings 查询的数据类型 JoinSuccessRate：加入房间成功率 JoinSuccess5SecsRate：5秒加入成功率 VideoFreezeRate：视频卡顿率 AudioFreezeRate：音频卡顿率 FirstVideoRecvTime：首帧视频接收耗时
客户端错误码 本章节介绍了Web SDK的客户端错误码RtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 RTC_ERR_CODE_SUCCESS 0 success 成功。 RTC_ERR_CODE_RTC_SDK_ERROR 90000001
接口按功能说明 初始化等基础接口 表1 初始化等基础接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 createHRtcEngine 创建IHRTCEngine对象 √ √ √ √ getHRtcEngine 获取创建后的IHRTCEngine对象
概述 华为云实时音视频服务提供的云端录制回放功能适用于需要将音视频通话或互动直播过程进行录制和存储的业务场景。云端录制功能包含两种模式，如表1所示。 表1 云端录制模式 模式 说明 适用场景 单流录制 支持单流录制，可按用户进行录制。 支持自启动录制，开启后对房间内每一个流进行录制。
音频管理 enableLocalAudioStream virtual int enableLocalAudioStream(bool enabled) 【功能说明】 设置是否开启本地麦克风音频采集。 【请求参数】 enable：true表示开启。false表示关闭。 【返回参数】
接口总览 本章节介绍了Android SDK的HRtcEngine接口详情。 HRtcEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、屏幕共享、音频管理、音效文件播放管理、自定义视频采集和渲染、自定义音频采集和渲染、设备管理、检测功能、音频增强管理。 单击下
修订记录 表1 修订记录 修改时间 修改说明 2023-11-30 第十三次正式发布 本次变更如下： 客户端对象（Client）新增旁路推流接口：startLiveStreaming、updateLiveStreaming和stopLiveStreaming。 2022-06-29
接收增值（录制）事件回调通知内容 SparkRTC服务回调用户提供的接口时，会附带以下信息。 表1 请求Body参数 参数 是否必选 参数类型 描述 job_id 否 String 任务编号，可以用于修改、查看和停止录制任务 stream_name 否 String 流名 app_id
String 房间ID metric 是 String 查询的数据类型： JoinSuccessRate：加入房间成功率 JoinSuccess5SecsRate：5秒加入成功率 VideoFreezeRate：视频卡顿率 AudioFreezeRate：音频卡顿率 sdk_type 是 String
接口总览 本章节介绍了iOS/macOS SDK的HWRtcEngine接口详情。 HWRtcEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、共享屏幕、音频管理、音效文件播放管理、自定义视频采集和渲染、自定义音频采集和渲染、设备管理、检测功能、音频增强管理。
配置录制规则 SparkRTC服务支持将实时音视频互动内容进行录制并将录制的内容存储到OBS桶中，您可以在OBS服务中对录制的音视频文件进行下载、分享等处理。相关操作流程，如图1所示。 图1 录制流程图 创建桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。
使用限制 在使用实时音视频前，您需要了解本服务的使用限制。 表1 使用限制 限制项 说明 应用创建 若首次使用SparkRTC，则需提交工单联系华为云技术客服进行咨询。 直播间人数 一个直播间最多支持500人同时通话。 Android SDK 系统版本：支持Android 5.0及以上版本。
SDK概述 华为云实时音视频服务软件开发工具包是对SparkRTC服务提供的REST API进行的封装，以简化用户的开发工作。用户直接调用SparkRTC SDK提供的接口函数即可实现使用SparkRTC服务业务能力的目的。 相关开发包请提交工单联系华为云技术客服获取。 同时，针
接口参考 主入口（HRTC） 客户端对象（Client） 客户端事件通知（ClientEvent） 流对象（Stream） 本地流对象（LocalStream） 远端流对象（RemoteStream） 流事件通知（RTCStreamEvent） 错误码（RtcError） 客户端错误码
单流录制 场景说明 将房间中的每一个用户的音视频流分别录制成独立的文件。 录制机制 SparkRTC提供的单流录制支持自启动模式，即单流自动录制，具体的实现机制如下图所示。 图1 单流录制 图2 单流自动录制 实现流程 创建OBS桶：创建用于存储SparkRTC录制文件的OBS桶，若已有OBS桶，请直接执行2。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
