检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
事件回调(IHRTCVideoFrameObserver) 本章节介绍了全平台C++ SDK的回调接口IHRTCVideoFrameObserver的详情。 表1 事件回调说明 接口 描述 onVideoFrameCapture 原始视频回调（前处理） onVideoFrameRender
单流和合流录制模式的主要区别如下： 单流录制：支持将房间中的每一个用户的音视频流分别录制成独立的文件。例如，在线课堂场景中，若家长只想观看老师和自己孩子的视频，则可以选择单流模式，分别录制老师和每位学生的视频，然后将老师的视频分别与每位学生的视频合并。单流录制的具体实现方法请参见创建单流录制任务。
实时音视频是什么？ 华为云实时音视频服务（SparkRTC）凭借在视频业务领域长期技术积累，快速为行业提供高并发、低延迟、高清流畅、安全可靠的全场景、全互动、全实时的音视频服务，适用于在线教育、云会议、社交文娱等场景。具体请参见《实时音视频 产品介绍》 。 父主题： 产品咨询
准备XCODE集成开发。 准备iOS 8.0及以上的iPhone真机。 支持的终端CPU架构：arm64，arm32。 SDK集成 解压iOS SDK包。 将iOS SDK包中的HWRTCEngine动态库和RTC.bundle文件导入创建的XCODE工程中。 图1 导入HWRTCEngine动态库和RTC
服务端如何计算Signature？ //认证用的app_key和app_id硬编码至代码中或以明文形式存储会有极大风险。建议密文形式配置存储在文件或者环境变量中，使用时解密，以确保安全。本例以app_key和app_id存放至环境变量为例，运行前请先在本地环境中设置完成环境变量APP_KEY和APP_ID。 app_key
回退到登录界面。 APP在调用leaveRoom接口时退到登录界面，或者在收到到onLeaveRoom回调，且回调消息不等于HWRtcLeaveReasonUserLeaveRoom时（防止重复操作），退到登录界面。 APP只在收到onLeaveRoom消息时退到登录界面。 onRemoteUserOnline
事件注册监听应在业务结束时取消注册，否则注册监听事件累积会有内存泄漏风险。 player-state-change 【事件说明】 播放状态变更事件。在播放状态变更的时候触发。 【回调参数】 event：playState类型。字段定义如下： type：string类型，表示播放器类型，取值为video/audio。
TCDeviceInfo。 counts：输入输出参数，获取deviceInfo对象数量，输入值为deviceInfo的数量，将会返回小于等于counts数量的设备信息。 【返回参数】 0：方法调用成功。 > 0：方法调用失败。具体请参见HRTCErrorCode。 getVideoDevices
ode。 音效文件支持同时播放多个，setAudioClipsVolume接口设置的音量是所有音频文件的最大音量，setVolumeOfAudioClip接口设置的是单个音效文件的音量，音效文件的实际播放音量 = 最大音量 * 自身音量 / 100。例如，最大音量是50，单个音效音量是80，实际播放音量就是50
WRtcVideoStreamType)type; 【功能说明】 大小流模式，设置所有订阅的远端视频流类型。默认订阅大流，优先应用setRemoteVideoStreamType接口设置的用户流类型。 【请求参数】 type：视频流类型。指大流、小流，具体请参见HWRtcVideoStreamType。
接口总览 本章节介绍了全平台C++ SDK的IHRTCEngine接口详情。 IHRTCEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、屏幕共享、音频管理、音效文件播放管理、自采集自渲染、其他接口。 单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。
基本使用逻辑 创建新的项目工程，导入 SDK 后，需要创建客户端并获取本地音视频设备信息。 创建本地流并初始化。 当用户加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以对音视频流进行订阅、取消订阅等其它操作。 在会中，也可以对本地录音或播放设备等进行配置。
void onAudioFramePlayback(HRTCAudioFrame audioFrame) 【功能说明】 需要播放的音频数据回调，从接口回调中取到音频数据以作后处理。 【回调参数】 audioFrame：音频数据格式 ，具体请参见HRTCAudioFrame。 onAudioFrameMixed
设置音效播放的最大音量 getAudioClipsVolume 获取音效播放的最大音量 setVolumeOfAudioClip 设置指定音效的播放音量 getVolumeOfAudioClip 获取指定音效的播放音量 setAudioClipPosition 设置指定音效文件的播放位置
过以下任一方式回退到登录界面。 APP在调用leaveRoom接口时退到登录界面，或者在收到onLeaveRoom回调，且回调消息不等于HRTC_LEAVE_REASON_USER_LEAVE_ROOM时（防止重复操作）退到登录界面。 APP只在收到onLeaveRoom消息时退到登录界面。
HRTC_ERR_CODE_INITIALIZING 90000010 初始化过程中 初始化过程中，不能再做初始化或者去初始化操作。 HRTC_ERR_CODE_UN_INITIALIZING 90000011 去初始化过程中 去初始化过程中，不能再做初始化或者去初始化操作。 HRTC_ERR_CODE_LOG_UPLOADING
提交工单联系华为技术工程师。 本地服务端录制需要使用Linux SDK，可部署在客户Linux 服务器上，使用客户自有的服务器和存储资源。 云端录制无需部署客户自有Linux服务器，减轻了研发和运维的压力，更轻量便捷。 父主题： 录制相关
remoteEnable：true表示输出远端视频数据，false表示不输出远端视频数据，默认值为false。 format：自渲染输出的视频帧图片格式，在onRenderExternalVideoFrame接口参数的videoFrameType中体现，取值请参见HRTCImageBufferFormat。 【返回参数】
过以下任一方式回退到登录界面。 APP在调用leaveRoom接口时退到登录界面，或者在收到onLeaveRoom回调，且回调消息不等于HRTC_LEAVE_REASON_USER_LEAVE_ROOM时（防止重复操作）退到登录界面。 APP只在收到onLeaveRoom消息时退到登录界面。
该接口限制在房间外调用，在房间内设置不生效，需要调用stopLocalPreview关闭预览，否则将一直处于预览状态。 在房间内预览：可调用setupLocalView设置有效view开启预览，设置为null表示关闭预览，不需要调用stopLocalPreview。 在房间外预览
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
