检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口总览 本章节介绍了全平台C++ SDK的IHRTCEngine接口详情。 IHRTCEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、屏幕共享、音频管理、音效文件播放管理、自采集自渲染、其他接口。 单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。
本地服务端录制需要使用Linux SDK，可部署在客户Linux 服务器上，使用客户自有的服务器和存储资源。 云端录制无需部署客户自有Linux服务器，减轻了研发和运维的压力，更轻量便捷。 父主题： 录制相关
enableUserVolumeNotify(int interval); 【功能说明】 设置音量值上报回调函数(onUserVolumeStatsNotify)的回调周期。 【请求参数】 interval：音量值上报周期，默认关闭音量回调。 0：关闭音量回调。 [100，10000]：有效值范围，单位
onAudioFramePlayback void onAudioFramePlayback(HRTCAudioFrame audioFrame) 【功能说明】 需要播放的音频数据回调，从接口回调中取到音频数据以作后处理。 【回调参数】 audioFrame：音频数据格式 ，具体请参见HRTCAudioFrame。
remoteEnable：true表示输出远端视频数据，false表示不输出远端视频数据，默认值为false。 format：自渲染输出的视频帧图片格式，在onRenderExternalVideoFrame接口参数的videoFrameType中体现，取值请参见HRTCImageBufferFormat。 【返回参数】
设置是否接收所有远端用户的音频流。 【请求参数】 mute：true表示取消音频流接收，false表示开启音频流接收。 【返回参数】 0：成功。 > 0：失败。具体请参见客户端错误码。 取消所有音频流接收，同时也会取消接收新加入用户的音频流。 开启所有音频流接收，同时也会开启接收新加入用户的音频流。
设置是否接收所有远端用户的音频流。 【请求参数】 mute：true表示取消音频流接收，false表示开启音频流接收。 【返回参数】 0：成功。 > 0：失败。具体请参见客户端错误码。 取消所有音频流接收，同时也会取消接收新加入用户的音频流。 开启所有音频流接收，同时也会开启接收新加入用户的音频流。
lable通知后，获取对应的userId。 多辅流场景下，一个用户只能同时订阅一条辅流。即当前正在订阅用户A的辅流，需要订阅另一个用户B的辅流时，需要调用startRemoteAuxiliaryStreamView停止订阅用户A的辅流后，才能订阅用户B的辅流。 stopRemot
多辅流场景，一个用户同时只能订阅一条辅流；当前正在订阅用户A的辅流，需要订阅另一个用户B的辅流时，需要先停止订阅用户A的辅流，再订阅用户B的辅流。 stopRemoteAuxiliaryStreamView virtual int stopRemoteAuxiliaryStreamView(const
多辅流场景，一个用户同时只能订阅一条辅流；当前正在订阅用户A的辅流，需要订阅另一个用户B的辅流时，需要先停止订阅用户A的辅流，再订阅用户B的辅流。 stopRemoteAuxiliaryStreamView virtual int stopRemoteAuxiliaryStreamView(const
同一端大小流或多流模式多路流设置的分辨率需保持一致，否则会设置失败。 多终端发流和选看的分辨率不一致时，sdk默认自适应并匹配最接近的分辨率（以实际发流分辨率优先），可能会导致选看时设置的分辨率和实际收到的流分辨率不一致。 调用接口一设置编码参数的分辨率发生变化时，需要先enab
多辅流场景，一个用户同时只能订阅一条辅流；当前正在订阅用户A的辅流，需要订阅另一个用户B的辅流时，需要先停止订阅用户A的辅流，再订阅用户B的辅流。 stopRemoteAuxiliaryStreamView - (int)stopRemoteAuxiliaryStreamView:(NSString *)userid;
选看当前未选看用户，或者选看用户的流类型发生变化时，会触发回调onFirstRemoteVideoDecoded。 stopRemoteStreamView - (int)stopRemoteStreamView:(NSString*)userId; 【功能说明】 关闭远端用户的显示视图，并停止收流。
使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。 Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。
UserID是什么？取值范围是多少？ 怎么理解SparkRTC的角色Role？ SparkRTC最多可以支持多少个人同时视频通话？ 实时音视频的时延是多少？ SparkRTC是否支持连麦互动？ SparkRTC是否支持双向的桌面推送？ 实时音视频支持私有化部署吗？ PC端实时音视频支持USB摄像头吗？
Name不能为空或空字符串，该名称可从getScreenShareSources接口获取。 如设置的rect为NSRect(0,0,0,0)，则会根据共享的id和名称取得相应对象的默认区域作为共享范围。 adjustAudioShareVolume - (int)adjustAu
0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。 使用该接口设置辅流编码参数，目前策略会根据获取的区域宽高比对设置的宽高进行调整，使用户设置的宽高比与获取的宽高比保持一致，因此，用户实际收流分辨率与设置分辨率有可能不同。 父主题： IHRTCEngine
修订记录 表1 修订记录 发布日期 修改说明 最新时间 实时音视频各端SDK的修订记录，详见各端节点下的“修订记录”。 2020-03-30 第一次正式商用发布。
程序或环境问题 RTC.32000022 获取SFU的IP失败 程序或环境问题 RTC.32000024 内部调用异常 程序或环境问题 RTC.32000025 内部调用异常 程序或环境问题 RTC.32000028 不支持的操作 程序或环境问题 RTC.32000030 sfu资源不足
eObserver） 表1 媒体数据回调说明 接口 描述 onMediaFrameEncrypt 编码后的媒体数据（加密处理） onMediaFrameDecrypt 解码前的媒体数据（解密处理） onMediaFrameEncrypt void onMediaFrameEncrypt(HRTCFrameBuffer
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
