检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本章节介绍了全平台C++ SDK的IHRTCEngine接口详情。 IHRTCEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、屏幕共享、音频管理、音效文件播放管理、自采集自渲染、其他接口。 单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。
iOS开发前准备 前提条件 已提交工单获取SDK包。 环境要求 准备XCODE集成开发。 准备iOS 8.0及以上的iPhone真机。 支持的终端CPU架构：arm64，arm32。 SDK集成 解压iOS SDK包。 将iOS SDK包中的HWRTCEngine动态库和RTC.
macOS开发前准备 前提条件 已提交工单获取SDK包。 环境要求 准备XCODE集成开发环境。 准备MAC设备，支持macOS 10.11以上的设备。 支持的终端CPU架构：x86_64。 SDK集成 支持dylib和framework两种包集成。 解压Mac SDK包。 将MAC
音效文件播放管理 如不集成hwffmpeg.framework，接口则只有startAudioFile/stopAudioFile/pauseAudioFile/resumeAudioFile生效，回调则只有onStartAudioFile/onStopAudioFile/onP
事件回调（HWRtcReplay） 本章节介绍了RtcEngineReplayKitExt SDK回调接口HWRtcReplayDelegate的详情。 replayBroadcastFinished - (void)replayBroadcastFinished;; 【功能说明】
Android 前提条件 已提交工单获取SDK包。 环境要求 OHOS SDK需要集成到APP工程中，建议您在如下推荐环境中进行集成开发。 准备DevEco，推荐使用4.0.0(10) SDK及以上。 准备Android运行环境：API 21、Android 5.0以上设备。 支
Mac 前提条件 已提交工单获取SDK包。 环境要求 准备XCODE集成开发环境。 准备MAC设备，支持macOS 10.11以上的设备。 支持的终端CPU架构：x86_64。 SDK集成 支持dylib和framework两种包集成。 解压Mac SDK包。 将MAC SDK包
optionalInfo) 【功能说明】 选择屏幕共享对象。 【请求参数】 info：共享对象信息，主要为采集源ID、名称等，具体请参见HRTCScreenShareSourceInfo。 optionalInfo：其他共享对象信息，如是否禁止鼠标采集、可选的共享区域等，具体请参见
setVideoFrameObserver(HRTCConnection conn, IHTCVideoFrameObserver observer); 【功能说明】 注册原始视频媒体数据监听回调。 【请求参数】 conn：HRTCConnection引擎。 observer：原始视频数据处理接
RTC.32000017 站点不存在 程序或环境问题 RTC.32000018 错误的加密算法 程序或环境问题 RTC.32000019 客户端媒体加密密钥base64解码失败 程序或环境问题 RTC.32000020 生成媒体加密密钥失败 程序或环境问题 RTC.32000021
HRTCAudioOperateMode mode, int samplesPerCall); 【功能说明】 设置采集回调参数，配合setAudioFrameObserver的onAudioFrameRecord使用。 【请求参数】 sampleRate：onAudioFrameRecord中返回的采
事件回调（IHRTCVideoFrameObserver） 表1 视频事件回调说明 接口 描述 onVideoFrameCapture 原始视频回调（前处理) onVideoFrameRender 渲染后视频回调（后处理） requireCaptureVideoFrame 是否开启前处理
屏幕分享 功能描述 屏幕共享用于在音视频会议中，把一个与会者的屏幕内容，以视频的方式分享给其他与会者。屏幕共享可以共享整个桌面，也可以共享某一个程序窗口。 接口调用流程 实现屏幕共享 加入房间 参考接口调用流程中加入房间的时序图步骤加入房间。 创建并播放共享流 入会后调用isSc
dler）。 【返回参数】 IHRTCConnection：成功返回连接对象指针，失败返回内容为空。 同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。加上IHRTCEngine对象，即同时最多可加入5个房间，且在这5个房间中最多只能同时有一个joiner
其他接口 startNetworkTest virtual int startNetworkTest(const HRTCNetworkTestConfig* networkTestConfig) = 0; 【功能说明】 开启网络质量测试，房间外调用，要等探测结束后才能加入房间。
流事件通知（RTCStreamEvent） 本章节介绍了Web SDK的RTCStreamEvent事件。 表1 StreamEvent事件 接口 描述 player-state-change 播放状态变更事件。 screen-sharing-stopped 共享屏幕停止事件。 audio-mixing-played
encryptionParam：加密配置，具体请参见HRTCEncryptionConfig。 【返回参数】 0：成功。 <0：失败。具体请参见客户端错误码。 release public abstract void release(); 【功能说明】 释放HRTCConnection。
辅流管理 setRemoteAuxiliaryStreamViewRotation virtual int setRemoteAuxiliaryStreamViewRotation(const char *userId, HRTCVideoRotation rotation) 【功能说明】
conn：连接对象。 IHRTCVideoFrameObserver* observer：原始视频数据处理接口代理。具体请参见IHRTCVideoFrameObserver。 IHRTCConnectionVideoFrameObserver* observer：原始视频数据处理接口
HRTCVideoFrameFormat format) 【功能说明】 设置是否开启外部视频采集。 【请求参数】 enable：true表示开启视频自采集，false表示取消视频自采集。默认值为false。 format：设置外部采集的视频格式，默认为I420（即yuv420P）。 【返回参数】 0：方法调用成功。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
