检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
开发前准备 前提条件 已提交工单获取SDK包。 环境要求 编译工具推荐安装Microsoft Visual Studio Code 1.43.2或以上版本。 如果客户端用Node.js开发， 推荐安装14.19.1或以上版本。 支持的浏览器详情请参见Web浏览器适配详情。 如果客
playModeFit，具体请参见HWRtcVideoDisplayMode。 userid：远端用户的唯一标识。 mirrorMode：镜像模式，默认模式为HWRtcVideoMirrorTypeDisable，具体请参见HWRtcVideoMirrorType。 【返回参数】
长较长的背景音乐或者伴奏。同一时间只能播放一个音频文件，播放给房间内的其他用户听。 支持播放本地或在线音乐文件，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现过程 加入房间并发布本端主流 参考接口调用流程中加入房间的时序图步骤加入房间，并发布本地主流。
具体请参见HRTCVideoDisplayMode，默认RTC_VIDEO_DISPLAY_FIT，通过扩边的方式保持宽高比。 mirrorMode：镜像模式。具体请参见HRTCVideoMirrorType。默认为HRTC_VIDEO_MIRROR_TYPE_DISABLE。 【返回参数】
【请求参数】 userId：用户ID。 displayMode：渲染模式，具体请参见HRTCVideoDisplayMode。 mirrorMode：镜像模式，具体请参见HRTCVideoMirrorType 。 【返回参数】 0：成功。 >0：失败。具体请参见客户端错误码。 setRemo
SDK概述 华为云实时音视频服务软件开发工具包是对SparkRTC服务提供的REST API进行的封装，以简化用户的开发工作。用户直接调用SparkRTC SDK提供的接口函数即可实现使用SparkRTC服务业务能力的目的。 相关开发包请提交工单联系华为云技术客服获取。 同时，针
0; 【功能说明】 开启网络质量测试，房间外调用，要等探测结束后才能加入房间。 【请求参数】 networkTestConfig：网络探测参数格式。具体请参见HRTCNetworkTestConfig。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。
事件注册监听应在业务结束时取消注册，否则注册监听事件累积会有内存泄漏风险。 player-state-change 【事件说明】 播放状态变更事件。在播放状态变更的时候触发。 【回调参数】 event：playState类型。字段定义如下： type：string类型，表示播放器类型，取值为video/audio。
如果使用外部输入音频数据，需要在加入房间后，按照一定时间间隔调用pushExternalAudioFrame接口输入音频数据。 不支持房间内切换。 自采集音频输入规格： 格式：PCM。 采样率：16k/48k 。 声道数：单声道。 位数：16。 pushExternalAudioFrame - (
_Nonnull)videoFrame; 【功能说明】 原始视频回调，从接口回调中取到原始视频数据以作前处理。 【回调参数】 HWRtcVideoFrame：视频数据格式 ，具体请参见HWRtcVideoFrame。 【返回参数】 YES：处理结果成功。 NO：处理结果失败。 onVideoFrameRender
_Nonnull)audioFrame; 【功能说明】 需要播放的音频数据回调，从接口回调中取到音频数据以作后处理。 【回调参数】 HWRtcAudioFrame ：音频数据格式，具体请参见HWRtcAudioFrame。 【返回参数】 YES：处理结果成功。 NO：处理结果失败。 onAudioFrameMixed
VideoDisplayMode，默认RTC_VIDEO_DISPLAY_HIDDEN，通过裁剪的方式保持宽高比。 mirrorMode：镜像模式。具体请参见HRTCVideoMirrorType 。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。
videoFrame) 【功能说明】 原始视频数据处理后回调 【回调参数】 conn：连接对象 userid：用户ID videoFrame：视频数据格式 ，具体请参见HRTCVideoFrame。 【返回参数】 true：处理结果成功。 false：处理结果失败。 父主题： 媒体原始数据管理
videoFrame) 【功能说明】 原始视频回调，从接口回调中取到原始视频数据以作前处理。 【回调参数】 videoFrame：视频数据格式 ，具体请参见HRTCVideoFrame。 【返回参数】 true：处理结果成功。 false：处理结果失败。 onVideoFrameRender
audioFrame) 【功能说明】 需要播放的音频数据回调，从接口回调中取到音频数据以作后处理。 【回调参数】 audioFrame：音频数据格式 ，具体请参见HRTCAudioFrame。 【返回参数】 true：处理结果成功。 false：处理结果失败。 onAudioFrameMixed
format：设置外部采集的视频格式，默认为I420（即yuv420P）。 【返回参数】 0：成功。 > 0：失败。具体请参见客户端错误码。 如果使用外部输入视频数据，需要在加入房间后，按照一定时间间隔调用pushExternalVideoFrame接口输入视频数据。 format可选格式为yuv42
int cycle, int replace, int startPos); 【功能说明】 开始播放音频文件。当前支持本端播放和在线播放。支持的格式包括：mp3、flac、mp4、m4a、aac、3gp、mkv、wav、amr、pcm、ogg。 【请求参数】 fullFilePath：
足开发需求： app中已有自己的音频模块。 需要使用自定义的采集或播放处理。 某些音频采集设备被系统独占。 注意事项 当前只支持PCM数据格式处理。 接口调用流程 实现过程 加入房间前调用主引擎的setExternalAudioCapture 加入房间前调用此接口打开自采集功能。
0：方法调用失败。具体请参见HWRtcErrorCode。 switchCamera - (int)switchCamera; 【功能说明】 切换前后镜头。开启摄像头后调用才生效。 【请求参数】 无 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。
第十一次正式发布 本次变更如下： 客户端对象（Client）新增setNetworkBandwidth接口。 优化部分文档描述。 2022-03-24 第十次正式发布 本次变更如下： 修改appid获取方式的相关描述。 2022-02-25 第九次正式发布 本次变更如下： 主入口（H
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
