检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本章节介绍了全平台C++ SDK的IHRTCEngine接口详情。 IHRTCEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、屏幕共享、音频管理、音效文件播放管理、自采集自渲染、其他接口。 单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。
事件回调（IHRTCVideoFrameObserver） 表1 视频事件回调说明 接口 描述 onVideoFrameCapture 原始视频回调（前处理) onVideoFrameRender 渲染后视频回调（后处理） requireCaptureVideoFrame 是否开启前处理
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：原始视频数据处理接
HRTCAudioOperateMode mode, int samplesPerCall); 【功能说明】 设置采集回调参数，配合setAudioFrameObserver的onAudioFrameRecord使用。 【请求参数】 sampleRate：onAudioFrameRecord中返回的采
width, int height) 【功能说明】 接收到第一帧远端视频流并解码成功，触发此回调。 【回调参数】 roomId：视频流对应的房间ID。 userId：视频流对应的用户ID。 width：视频流宽。 height：视频流高。 onConnectionChangedNotify
conn：连接对象。 IHRTCVideoFrameObserver* observer：原始视频数据处理接口代理。具体请参见IHRTCVideoFrameObserver。 IHRTCConnectionVideoFrameObserver* observer：原始视频数据处理接口
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
房间功能 joinRoom virtual int joinRoom(const HRTCJoinParam &joinParam) 【功能说明】 加入房间。该方法让用户加入通话房间。 【请求参数】 joinParam：入会参数。具体请参见HRTCJoinParam。 【返回参数】
音频管理 muteRemoteAudio virtual int muteRemoteAudio(const char* userId, bool mute) 【功能说明】 设置是否接收对应远端用户的音频流。同一时间所有房间最多只能接收17路音频流。 【请求参数】 userId:
int：无符号整数，对象（屏幕或窗口）数量。 get virtual HRTCScreenShareSourceInfo get(unsigned int index) 【功能说明】 获取屏幕共享窗口资源信息。 【请求参数】 index：资源句柄。 【返回参数】 捕获的共享资源对象，具体请参
HRTCVideoFrameFormat format) 【功能说明】 设置是否开启外部视频采集。 【请求参数】 enable：true表示开启视频自采集，false表示取消视频自采集。默认值为false。 format：设置外部采集的视频格式，默认为I420（即yuv420P）。 【返回参数】 0：方法调用成功。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
