检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
音频自采集和音频自渲染 功能描述 实时音频传输过程中，HWRtcEngine SDK通常会启动默认的音频模块进行采集和渲染。在以下场景中，您可能会发现默认的音频模块无法满足开发需求： app中已有自己的音频模块。 需要使用自定义的采集或播放处理。 某些音频采集设备被系统独占。 接口调用流程
接口参考 HWRtcEngine 事件回调（HWRtcEngine） HWRtcConnection 事件回调（HWRtcConnection） 媒体原始数据管理 HWRtcReplay 客户端错误码 服务端错误码 数据类型 事件回调（HWRtcReplay） 父主题： iOS/macOS
实现音视频通话（iOS） 环境准备 屏幕共享 通话质量监测 播放音效 播放音乐 原始音频数据（音频前后处理） 音频自采集和音频自渲染 原始视频数据（视频前后处理） 自定义视频采集 自定义视频渲染 加入多频道（跨房） 父主题： 实现音视频通话
实现音视频通话（MAC） 环境准备 屏幕分享 通话质量监测 播放音效 播放音乐 原始音频数据（音频前后处理） 音频自采集和音频自渲染 原始视频数据（视频前后处理） 自定义视频采集 自定义视频渲染 加入多频道（跨房） 父主题： 实现音视频通话
修订记录 表1 修订记录 修改时间 修改说明 2023-08-28 第二十次正式发布 本次变更如下： 新增OBS桶管理接口组。 新增查询详情事件接口和查询指定项目用户异常体验事件接口。 2023-07-06 第十九次正式发布 本次变更如下： 删除启动单流任务、更新单流任务和启动合
接口总览 本章节介绍了Android SDK的HRtcEngine接口详情。 HRtcEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、屏幕共享、音频管理、音效文件播放管理、自定义视频采集和渲染、自定义音频采集和渲染、设备管理、检测功能、音频增强管理。 单击下
自定义视频采集 功能描述 实时视频传输过程中，HWRtcEngine SDK通常会启动默认的视频模块进行采集和渲染。在以下场景中，您可能会发现默认的视频模块无法满足开发需求： app中已有自己的视频模块。 需要使用自定义的采集或播放处理。 某些视频采集设备被系统独占。 接口调用流程
接口总览 本章节介绍了iOS/macOS SDK的HWRtcEngine接口详情。 HWRtcEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、共享屏幕、音频管理、音效文件播放管理、自定义视频采集和渲染、自定义音频采集和渲染、设备管理、检测功能、音频增强管理。
HWRtcConnection 接口总览 初始化等基础接口 房间功能 音频管理 视频管理 辅流管理 媒体原始数据管理 父主题： 接口参考
常见问题 初始化引擎时，countryCode应该如何填写？ countryCode表示区域码，如果对应的是GLOBAL类型，则直接填空字符串，即""，如果是CN类型，则可以填"CN"。具体请参见国家码对照表。 初始化引擎时，domain应该如何填写？ 该字段已废弃，不需要再传值。
客户端对象（Client） 本章节介绍了Web SDK的Client接口详情。 表1 Client接口 接口 描述 join 加入房间。调用该接口让用户加入指定房间，进行音频/视频通话。 leave 离开房间。用户结束通话后须调用该接口离开房间。 publish 加入房间后，发布本地流。
主要功能 SparkRTC主要包含基本房间功能和跨房功能，各端主要功能框架，如图1所示。 说明：图1中仅展示各端的统一功能，独属功能详见各端SDK指导。 图1 功能框架 表1 功能说明 类别 功能分类 功能说明 基本功能 初始化等基础接口 主要功能包括创建/销毁RTC引擎、设置日志保存位置等。
使用前必须 华为云实时音视频服务（SparkRTC）凭借在视频业务领域长期技术积累，快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务，适用于在线教育、云会议、社交文娱等场景。 您可以使用本文档提供的API对华为云实时音视频服务进行相关操作，如应
API概览 华为云实时音视频服务对应的接口列表如下所示，在调用媒体处理API前，您需要先获取用户Token，Token可以用于调用其他API时鉴权，具体如何调用媒体处理API请参考应用示例。 应用管理接口 表1 应用管理接口 接口 说明 POST /v2/apps 创建应用 GET
合规使用指南 华为云SparkRTC SDK开发者合规指南 《中华人民共和国个人信息保护法》自2021年11月1日起正式施行后，监管部门、各行业参与方和终端消费者越来越关注用户的隐私保护问题。为了有效治理App、SDK违规收集使用个人信息的现象，监管部门也陆续出台相关标准规范。
事件回调（IHRTCEngine） 本章节介绍了全平台C++ SDK的回调接口IHRTCEngineEventHandler的详情。 表1 事件回调说明 接口 描述 onError 错误回调。 onJoinRoomSuccess 成功加入房间回调。 onJoinRoomFailure
通话质量监测 功能描述 加入房间后，SDK上报通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。 接口调用流程 通话质量上报 network-quality网络上下行质量报告事件，用户加入房间后，在网络质量变化的时候会触发一次该事件，报告用户的本地网络上下行质量情况。
事件回调（IHRTCEngineEventHandler） 本章节介绍了Android SDK的回调接口IHRTCEngineEventHandler的详情。 表1 回调接口 接口 描述 onError 错误回调 onJoinRoomSuccess 加入房间成功回调 onJoinRoomFailure
SDK使用 移动端（Android/iOS）创建一个房间，是否支持PC端（MAC/Windows）接入？ iOS平台如何缩减安装包体积？ Android平台如何缩减安装包体积？ iOS端是否可以监听远端离开房间？ 背景音乐是否支持循环播放？ SparkRTC是否支持调整背景音乐的播放进度？
修订记录 表1 修订记录 修改时间 修改说明 2022-06-21 第六次正式发布 本次变更如下： 新增以下接口： addMultiRoomMediaRelay：添加单个跨房 removeMultiRoomMediaRelay：删除单个跨房 stopMultiRoomMediaRelay：停止所有跨房
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
