检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
根据功能分类可以快速查找具体功能单个接口，方便接口对接。 技巧3：单个接口使用须知 接口使用时注意使用的时机、参数说明。“注意”是强调每个接口使用的注意事项并带有调用该接口的相关回调，对接时需要仔细阅读。 父主题： 使用前必读
X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date
TCDeviceInfo。 counts：输入输出参数，获取deviceInfo对象数量，输入值为deviceInfo的数量，将会返回小于等于counts数量的设备信息。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。 getVideoDevices
按档位选看远端用户，并设置用户窗口 stopRemoteStreamView 取消订阅远端用户，并清除此用户的窗口 pullAllRemoteVideo 订阅或取消订阅全部远端用户，对未入会用户也有影响 setRemoteVideoStreamType 切换用户指定档位的视频 updateRemoteRenderMode
接口总览 本章节介绍了全平台C++ SDK的IHRTCEngine接口详情。 IHRTCEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、屏幕共享、音频管理、音效文件播放管理、自采集自渲染、其他接口。 单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。
如何创建房间？ 房间是由SparkRTC后台在客户端进房时自动创建的，您无需手动创建房间，只需调用客户端的相关接口加入房间即可。具体接口详情请参见客户端SDK参考。 父主题： SDK使用
TCDeviceInfo。 counts：输入输出参数，获取deviceInfo对象数量，输入值为deviceInfo的数量，将会返回小于等于counts数量的设备信息。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。 getRecordDevices
收到onUserAuxiliaryStreamAvailable消息后，获取对应的userId。 多辅流场景，一个用户同时只能订阅一条辅流；当前正在订阅用户A的辅流，需要订阅另一个用户B的辅流时，需要先停止订阅用户A的辅流，再订阅用户B的辅流。 stopRemoteAuxiliaryStreamView
startRemoteStreamView的调用是需要放在主线程，不能在onUserJoined调用，否则会返回90000008错误码。 1080p经过RTC传输后，被自动缩放且颜色改变 老版本SDK不支持1080p。 推流1080p，接收到的是360p的流 关闭发送端设置发流编码参数分辨率自适应，关闭收端分辨率自适应。
getRoomId virtual const char* getRoomId() 【功能说明】 获取当前连接对应的房间ID。 【请求参数】 无 【返回参数】 roomId：返回当前连接对应的房间ID。 setNetworkBandwidth virtual int setNetworkBandwidth(const
设置是否开启外部视频采集。需要在加入房间前调用。 【请求参数】 enable：YES表示开启，NO表示关闭。默认为NO。 format：设置外部采集的视频格式，默认为I420（即yuv420P）。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。
设置是否开启外部视频采集。 【请求参数】 enable：true表示开启视频自采集，false表示取消视频自采集。默认值为false。 format：设置外部采集的视频格式，默认为I420（即yuv420P）。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。
joinRoom(joinParam ); joinParam：入会参数，包含用户ID、用户名、房间号、认证信息、ctime、是否自动订阅音频和视频、SFU类型、场景和用户角色，具体请参见HRTCJoinParam。 监听远端用户加入房间，并设置远端窗口。 1 2 3 4 5 6
joinRoom:joinParam ]; joinParam：入会参数，包含用户ID、用户名、房间号、认证信息、ctime、是否自动订阅音频和视频、SFU类型、场景和用户角色，具体请参见HWRtcJoinParam。 监听远端用户加入房间，并设置远端窗口。 1 2 3 4 5 6
事件回调(IHRTCAudioFrameObserver) 本章节介绍了全平台C++ SDK的回调接口IHRTCAudioFrameObserver的详情。 表1 事件回调说明 接口 描述 onAudioFramePlayback 音频播放回调（后处理） onAudioFrameMixed
0：方法调用失败。具体请参见HWRtcErrorCode。 soundId需要开发者自己生成并维护，保证不同的soundId对应不同的音效播放实例。同时音效播放完毕或者停止播放后，soundId需主动回收，待下一次播放音效时，建议复用被回收的soundId。 stopAudioClip - (int)stopAu
单流和合流录制模式的主要区别如下： 单流录制：支持将房间中的每一个用户的音视频流分别录制成独立的文件。例如，在线课堂场景中，若家长只想观看老师和自己孩子的视频，则可以选择单流模式，分别录制老师和每位学生的视频，然后将老师的视频分别与每位学生的视频合并。单流录制的具体实现方法请参见创建单流录制任务。
播放音效文件 功能描述 用户可以同时播放多个音效文件，给自己和其他与会者听，用于烘托气氛。 支持本地或在线文件路径，文件格式支持播放wav、pcm和单声道mp3音频格式。 接口调用流程 实现播放音效文件 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 播放音效文件 调
暂停播放所有正在播放的音效文件。 int soundId = 0; //音效文件ID engine->pauseAudioClip(soundId); 恢复播放暂停的音效文件 音频文件暂停播放后，可以调用resumeAudioClip接口可以恢复播放之前暂停的音效文件。或者调用r
0：方法调用失败。具体请参见HRTCErrorCode。 会触发onNetworkTestQuality和onNetworkTestResult两个回调，并通过回调返回具体的网络测试结果，探测大约需要20-60s。 stopNetworkTest virtual int stopNetworkTest() 【功能说明】
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
