检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
onVideoStats、onAudioStatus、onSubStreamStats回调触发时为什么程序会崩溃？ 回调函数的入参localStats和remoteStats指针有可能为空，需要先判断不为空再使用，否则可能引发空指针错误。 父主题： SDK使用
视频管理 setPriorRemoteVideoStreamType public abstract int setPriorRemoteVideoStreamType(HRTCVideoStreamType type); 【功能说明】 大小流模式，设置所有订阅的远端视频流类型。
辅流管理 startRemoteAuxiliaryStreamView public abstract int startRemoteAuxiliaryStreamView(String userId, SurfaceView view); 【功能说明】 开始订阅辅流。 【请求参数】
事件回调（HWRtcConnection） 本章节介绍了iOS/macOS SDK的回调接口HWRtcConnectionDelegate的详情。 表1 事件回调说明 接口 描述 connection:onJoinSuccess 成功加入跨房房间回调 connection:onJoinRoomFailure
iOS 前提条件 已提交工单获取SDK包。 环境要求 准备XCODE集成开发。 准备iOS 8.0及以上的iPhone真机。 支持的终端CPU架构：arm64，arm32。 SDK集成 解压iOS SDK包。 将iOS SDK包中的HWRTCEngine动态库和RTC.bundle文件导入创建的XCODE工程中。
Windows 前提条件 已提交工单获取SDK包。 环境要求 准备集成开发环境，建议使用Microsoft Visual Studio 2015或以上版本。 支持Windows 7或以上版本的Windows设备。 支持的平台：x86 release。 资源文件列表 头文件目录 lib文件目录
IHRTCEngine 接口总览 接口按功能说明 初始化等基础接口 房间功能 音频管理 视频管理 辅流管理 屏幕共享 音频文件播放管理 自采集自渲染 其他接口 父主题： 接口参考
客户端错误码 本章节介绍了Web SDK的客户端错误码RtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 RTC_ERR_CODE_SUCCESS 0 success 成功。 RTC_ERR_CODE_RTC_SDK_ERROR 90000001
播放音乐 功能描述 混音是将音乐文件和麦克风音频混合，一般用于播放时长较长的背景音乐或者伴奏。同一时间只能播放一个音乐文件。可以在本地播放，也可以同时播放给其他与会者听。 支持播放wav、pcm和单声道mp3音频文件。可以播放本地或在线音乐文件。 接口调用步骤 实现过程 加入房间
播放音效 功能描述 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。 支持播放wav、pcm和单声道mp3音频文件，支持本地或在线文件路径。 接口调用流程 实现过程 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 播放音效文件 调用playAudio
SparkRTC多人视频通话支持仅订阅2/3/4人音频吗？ 支持，SparkRTC提供音频TopN模式也叫音频最大三方模式。开启音频TopN模式后，本地用户不需要通过调用接口单独订阅某个远端用户的音频，即可接收到当前房间内音量值最大的三个用户的音频。具体接口调用请参见切换音频模式。
接口总览 本章节介绍了全平台C++ SDK的IHRTCEngine接口详情。 IHRTCEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、屏幕共享、音频管理、音效文件播放管理、自采集自渲染、其他接口。 单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。
音频管理 enableLocalAudioStream virtual int enableLocalAudioStream(bool enabled) 【功能说明】 设置是否开启本地麦克风音频采集。 【请求参数】 enable：true表示开启。false表示关闭。 【返回参数】
屏幕共享 getScreenShareSources virtual IHRTCScreenShareSourceList* getScreenShareSources(HRTCScreenShareIconType type) 【功能说明】 获取屏幕可共享对象列表。 【请求参数】
其他接口 startNetworkTest virtual int startNetworkTest(const HRTCNetworkTestConfig* networkTestConfig) = 0; 【功能说明】 开启网络质量测试，房间外调用，要等探测结束后才能加入房间。
IHRTCConnection 接口总览 初始化等基础接口 房间功能 音频管理 视频管理 辅流管理 父主题： 接口参考
视频设备管理 本章节介绍了全平台C++ SDK的IHRTCVideoDeviceManager接口详情。 表1 IHRTCVideoDeviceManager接口 接口 描述 getVideoDevices 获取系统视频设备列表 setVideoDevice 设置视频设备 getCurrentVideoDevice
流事件通知（RTCStreamEvent） 本章节介绍了Web SDK的RTCStreamEvent事件。 表1 StreamEvent事件 接口 描述 player-state-change 播放状态变更事件。 screen-sharing-stopped 共享屏幕停止事件。 audio-mixing-played
播放音效文件 功能描述 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。 支持本地或在线文件路径，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现播放音效文件 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 播放音效文件 调
通话质量监测 功能描述 加入频道后，SDK会每隔2秒自动触发通话质量相关的回调，上报当前通话的网络质量、本地和远端的音视频统计信息。 上报接口 通话质量上报 onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启，每2s上报一次。 -
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
