检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口总览 本章节介绍了iOS/macOS SDK的HWRtcEngine接口详情。 HWRtcEngine按照其功能可分类为：初始化等基础接口、房间功能、视频管理、辅流管理、共享屏幕、音频管理、音效文件播放管理、自定义视频采集和渲染、自定义音频采集和渲染、设备管理、检测功能、音频增强管理。
errorMsg:(NSString * _Nonnull)errorMsg; 【功能说明】 发生错误，触发此回调。返回客户端错误码或者服务端错误码。 【回调参数】 connection：跨房引擎。 errorCode：错误码，具体请参见HRTCErrorCode。
onError(IHRTCConnection* conn, int error, const char* msg) 【功能说明】 发生错误，触发此回调。返回客户端错误码或者服务端错误码。 【回调参数】 conn：连接对象。 error：错误码，具体请参见HRTCErrorCode。 msg：错误描述。
0：方法调用失败。具体请参见客户端错误码。 stopAllAudioClips public abstract int stopAllAudioClips(); 【功能说明】 停止播放所有音效文件。 【请求参数】 无 【返回参数】 0：方法调用成功。 < 0：方法调用失败。具体请参见客户端错误码。 pauseAllAudioClips
RTC.32000017 站点不存在 程序或环境问题 RTC.32000018 错误的加密算法 程序或环境问题 RTC.32000019 客户端媒体加密密钥base64解码失败 程序或环境问题 RTC.32000020 生成媒体加密密钥失败 程序或环境问题 RTC.32000021
RTC.32000017 站点不存在 程序或环境问题 RTC.32000018 错误的加密算法 程序或环境问题 RTC.32000019 客户端媒体加密密钥base64解码失败 程序或环境问题 RTC.32000020 生成媒体加密密钥失败 程序或环境问题 RTC.32000021
iOS 前提条件 已提交工单获取SDK包。 环境要求 准备XCODE集成开发。 准备iOS 8.0及以上的iPhone真机。 支持的终端CPU架构：arm64，arm32。 SDK集成 解压iOS SDK包。 将iOS SDK包中的HWRTCEngine动态库和RTC.bundle文件导入创建的XCODE工程中。
接口按功能说明 初始化等基础接口 表1 初始化等基础接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 createHRtcEngine 创建IHRTCEngine对象 √ √ √ √ getHRtcEngine 获取创建后的IHRTCEngine对象
接口总览 本章节介绍了Android SDK的HRTCConnection接口详情。 HRTCConnection按照其功能可分类为：初始化等基础接口、房间功能、音频管理、视频管理、屏幕共享。 单击下图中相应接口名称，可快速跳转到相应接口位置查看其使用方法。 表1 初始化等基础接口
辅流管理 startRemoteAuxiliaryStreamView - (int)startRemoteAuxiliaryStreamView:(HWRtcVideoCanvas *)streamView streamType:(HWRtcStreamType)streamType;
onError(IHRTCConnection* conn, int error, const char* msg) 【功能说明】 发生错误，触发此回调。返回客户端错误码或者服务端错误码。 【回调参数】 conn：连接对象。 error：错误码，具体请参见HRTCErrorCode。 msg：错误描述。
0：方法调用成功。 > 0：方法调用失败。具体请参见HWRtcErrorCode。 华为SDK系统有默认的编码设置（720P+360P），一般可以不设置发流编码参数。如果您确实需要自定义发流编码参数，请参考华为SDK系统推荐码表：表56和表57，否则可能设置失败。 两重构接口针对不同使用
SDK使用 以下为集成SDK进行实时音视频互动直播的基本流程： 创建引擎。 appId获取方法请参见创建应用。 m_pRtcEngine = createHRtcEngine(); // 创建引擎 HRTCLogConfig logConfig; logConfig.level =
常见问题 调用加入房间接口成功后，再调用pushExternalVideoFrame返回90000001 SDK内部系统错误 需要收到加入房间成功回调通知后，才能调用pushExternalVideoFrame。 joiner和player都加入房间成功，joiner调用push
remoteEnable：true表示输出远端音频数据，false表示不输出远端音频数据。 【返回参数】 0：成功。 >0：失败。具体请参见客户端错误码。 通过onPlaybackExternalAudioFrame回调音频数据。 setExternalVideoFrameOutputEnable
encryptionParam：加密配置，具体请参见HRTCEncryptionConfig。 【返回参数】 0：成功。 <0：失败。具体请参见客户端错误码。 release public abstract void release(); 【功能说明】 释放HRTCConnection。
事件回调(IHRTCConnectionEventHandler) 本章节介绍了Android SDK的回调接口IHRTCConnectionEventHandler的详情。 表1 回调接口 接口 描述 onError 错误回调 onJoinRoomSuccess 加入房间成功回调
辅流管理 startRemoteAuxiliaryStreamView - (int)startRemoteAuxiliaryStreamView:(HWRtcVideoCanvas *)view; 【功能说明】 开启辅流渲染视图（发起辅流选看） 【请求参数】 view: 具体请参见HWRtcVideoCanvas
>0：失败。具体请参见客户端错误码。 startLocalPreview public abstract int startLocalPreview(); 【功能说明】 开始本地预览。 【请求参数】 无 【返回参数】 0：成功。 >0：失败。具体请参见客户端错误码。 该接口限制在
abstract int leaveRoom() 【功能说明】 离开房间。 【请求参数】 无 【返回参数】 0：成功。 >0：失败。具体请参见客户端错误码。 会触发以下回调： onLeaveRoom：离开房间回调。 onConnectionStateChangedNotify：连接状态改变回调。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
