检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
根据房间ID，创建HRTCConnection对象，为跨房做准备。 通过此接口创建一个与房间关联的HRTCConnection连接对象。 该方法支持多次调用，创建多个HRTCConnection连接对象，调用每个对象中的joinRoom方法，可以同时加入到多个房间。在每个房间中，可以分别订阅和选看房间中的用户。 具
事件回调(IHRTCAudioFrameObserver) 本章节介绍了全平台C++ SDK的回调接口IHRTCAudioFrameObserver的详情。 表1 事件回调说明 接口 描述 onAudioFramePlayback 音频播放回调（后处理） onAudioFrameMixed
void release() 【功能说明】 释放IHRTCConnection对象，如果未离会，会自动离会再释放连接，会触发onDestroyConnection回调。 如果资源已经释放，不能继续使用该对象，需要重新调用createConnection。 getRoomId virtual
*)userid muted:(BOOL)muted; 【功能说明】 订阅或取消订阅对应远端用户的音频流。同一时间所有房间最多只能接收17路音频流。 【请求参数】 userid : 远端用户的id，唯一的标识。 muted：YES表示取消订阅，NO表示订阅。默认值 NO。 【返回参数】 0：方法调用成功。
E_AUDIO_SUBSCRIBED时，如何设置才能默认听不到远端用户的声音？ HRTC_REMOTE_AUDIO_SUBSCRIBED为自主订阅，需要用户手动调用订阅。在加入房间（joinRoom）时调用带有HRTCJoinParam类的方法，创建该类实例后autoSubscr
事件回调（IHRTCEncDecryptFrameObserver） 表1 媒体数据回调说明 接口 描述 onMediaFrameEncrypt 编码后的媒体数据（加密处理） onMediaFrameDecrypt 解码前的媒体数据（解密处理） onMediaFrameEncrypt
音视频传输过程中，我们可以对采集到的音视频数据进行前处理和后处理，获取想要的播放效果。 对于有自行处理音视频数据需求的场景，HWRtcEngine SDK 提供原始数据功能，您可以在将数据发送给编码器前进行前处理，对捕捉到的音频信号或视频帧进行修改，也可以在将数据发送给解码器后进行后处理，对接收到的音频信号或视频帧进行修改。
RecordObsFileAddr 参数 参数类型 描述 location String OBS Bucket所在RegionID cn-north-4 project_id String OBS Bucket所在Region的项目ID bucket String OBS的bucket名称
RecordObsFileAddr 参数 参数类型 描述 location String OBS Bucket所在RegionID cn-north-4 project_id String OBS Bucket所在Region的项目ID bucket String OBS的bucket名称
常见问题 初始化引擎时，countryCode应该如何填写？ countryCode表示区域码，如果对应的是GLOBAL类型，则直接填空字符串，即""，如果是CN类型，则可以填"CN"。具体请参见国家码对照表。 初始化引擎时，domain应该如何填写？ 该字段已废弃，不需要再传值。 加入房间时，username必须填吗？
【回调参数】 conn：连接对象。 localQuality：本地上行网络质量，该参数暂时不使用。 localQualityCount：正在上报的网络质量数量，该参数暂时不使用。 remoteQualityCount：正在上报的流的数量，集合的大小。 onDestroyConnection
ionalInfo参数用于指定共享的程序窗口的子矩形区域，矩形区域以共享的程序窗口的左上角为原点(0,0)，最小96*92 最大1920*1080。如果需要共享该程序的完整窗口，则HRTCSrceenCaptureOptionalInfo参数的矩形区域全填为0。 然后调用startScreenShare开始共享。
示例1：创建单流录制任务已介绍了如何将房间中的每一个用户的音视频流分别录制成独立的文件。若您需要将房间中的多个单流用户录制成一个文件，您可以参考此章节内容调用SparkRTC API进行合流录制。 前提条件 已获取需要使用的SparkRTC服务的终端节点：rtc-api.myhuaweicloud
口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 X-Project-Id 否 String
String 共享屏幕的背景图地址，图片先上传obs，格式s3://bucket/object，如：s3://rtc-bucket-cn-north-4/img/testImg.jpg。 在一大多小的布局场景下，无论大窗是显示非指定用户（屏幕共享人的桌面）还是指定用户的共享桌面，都通过该字段指定背景图。
【回调参数】 conn：连接对象。 localQuality：本地上行网络质量，该参数暂时不使用。 localQualityCount：正在上报的网络质量数量，该参数暂时不使用。 remoteQualityCount：正在上报的流的数量，集合的大小。 onError virtual
setPriorRemoteVideoStreamType 大小流模式，设置所有订阅的远端视频流类型 pullRemoteVideo 设置是否接收对应远端用户的视频流 pullAllRemoteVideo 设置是否接收所有用户的视频流 startRemoteStreamView 设置远端用户渲染视图（发起选看-老接口）
参考接口调用流程中加入房间的时序图步骤加入房间。 渲染远端视频流 当远端用户加入房间后会触发onRemoteUserOnline回调，在该回调中使用startRemoteStreamView方法开启接收远端用户的视频流，如果不开启，无法渲染远端视频流。 //远端用户加入房间后触发的回调 - (
【回调参数】 stream：必选，RemoteStream类型，远端流对象。 client-banned 【事件说明】 用户被踢下线事件，当用户以相同的userId 在其他Client加入相同的房间后，被踢的Client会收到该事件通知。 【回调参数】 clientBannedE
error) }) 接收远端用户的共享流 收到远端用户开启共享流通知stream-added后，通过调用subscribe订阅远端用户的共享流，当共享流订阅成功会收到stream-subscribed回调通知，然后通过调用play在指定的窗口里播放接收到的远端用户的共享流。 示例代码如下：
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
