检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
基本使用逻辑 创建新的项目工程,导入 SDK 后,需要创建客户端并获取本地音视频设备信息。 创建本地流并初始化。 当用户加入房间后,将通过回调的方式通知房间内的其他用户,收到用户加入的回调后,可以对音视频流进行订阅、取消订阅等其它操作。 在会中,也可以对本地录音或播放设备等进行配置。
退出房间不需要手动释放摄像头,会自动关闭,不再采集摄像头。 如何鉴权?在什么时候鉴权? 具体请参见接入鉴权。 客户端以joiner角色加入房间失败。 客户端调用join时传入的角色参数不对。role是数值型,如果客户端传入的是字符串型,则会加入房间失败。 创建本地流失败,控制台提示Cannot read
用户昵称,该昵称为UTF-8编码。 signature:必选,string[512]类型,鉴权签名字串,应用开发者需要向远端服务器获取鉴权签名。 远端服务器需要您自行部署,具体请参见接入鉴权。 ctime:必选,string类型,签名UTC时间戳,单位秒。 role:必选,num
HRTCAudioOperateMode mode, int samplesPerCall); 【功能说明】 设置采集回调参数,配合setAudioFrameObserver的onAudioFrameRecord使用。 【请求参数】 sampleRate:onAudioFrameRecord中返回的采
0:表示调用启动命令失败。具体请参见客户端错误码。 stopNetworkTest public abstract int stopNetworkTest(); 【功能说明】 停止入会前网络检测。 【请求参数】 无 【返回参数】 0:表示调用停止命令成功。 > 0:表示调用停止命令失败。具体请参见客户端错误码。
房间功能 joinRoom - (int)joinRoom:(HWRtcJoinParam * _Nonnull)joinParam; 【功能说明】 加入房间。该方法让用户加入通话房间。如果已在通话中,用户必须调用leaveRoom退出当前通话,才能进入下一个房间。 【请求参数】
HWRtcReplay 表1 HWRtcReplay接口 接口 描述 sharedInstance 生成HWRtcReplay单例对象 setupWithAppGroup 通过appGroup启动HWrtcReplay broadcastFinished 系统录屏结束 sendVideoSampleBuffer
用户主动离开 HWRtcLeaveReasonServerError 服务器异常 HWRtcLeaveReasonBreakdown sfu服务故障 HWRtcLeaveReasonServiceUnreachable 服务不可达 HWRtcLeaveReasonInternalError
接口总览 本章节介绍了iOS/macOS SDK的HWRtcEngine接口详情。 HWRtcEngine按照其功能可分类为:初始化等基础接口、房间功能、视频管理、辅流管理、共享屏幕、音频管理、音效文件播放管理、自定义视频采集和渲染、自定义音频采集和渲染、设备管理、检测功能、音频增强管理。
主要功能 SparkRTC主要包含基本房间功能和跨房功能,各端主要功能框架,如图1所示。 说明:图1中仅展示各端的统一功能,独属功能详见各端SDK指导。 图1 功能框架 表1 功能说明 类别 功能分类 功能说明 基本功能 初始化等基础接口 主要功能包括创建/销毁RTC引擎、设置日志保存位置等。
文档基本使用技巧 技巧1:基本使用逻辑说明 用时序图展示各端接口使用顺序,单击相应接口可以快速查看相关接口使用方法。 技巧2:接口总览说明 包括SparkRTC接口总体功能流程图和接口列表,根据功能分类可以快速查找具体功能单个接口,方便接口对接。 技巧3:单个接口使用须知 接口使
abstract int startScreenShare(); 【功能说明】 开启屏幕共享。 【返回参数】 0:成功。 > 0:失败。具体请参见客户端错误码。 Android 5.0及以上版本支持此功能。 使用时,在AndroidManifest.xml中需添加如下约束。 <activity
接口总览 本章节介绍了Android SDK的HRTCConnection接口详情。 HRTCConnection按照其功能可分类为:初始化等基础接口、房间功能、音频管理、视频管理、屏幕共享。 单击下图中相应接口名称,可快速跳转到相应接口位置查看其使用方法。 表1 初始化等基础接口
mute:true表示取消音频流接收,false表示开启音频流接收,默认为false。 【返回参数】 0:成功。 > 0:失败。具体请参见客户端错误码。 muteAllRemoteAudio public abstract int muteAllRemoteAudio(boolean
辅流管理 startRemoteAuxiliaryStreamView - (int)startRemoteAuxiliaryStreamView:(HWRtcVideoCanvas *)streamView streamType:(HWRtcStreamType)streamType;
屏幕共享 startScreenShare - (int)startScreenShare; 【功能说明】 开启屏幕共享功能。 【请求参数】 无 【返回参数】 0:成功。 > 0:方法调用失败。具体请参见HWRtcErrorCode。 目前可支持多路辅流共享,若需开启多辅流,请提交工单联系技术支持处理。
0:方法调用失败。具体请参见客户端错误码。 stopAllAudioClips public abstract int stopAllAudioClips(); 【功能说明】 停止播放所有音效文件。 【请求参数】 无 【返回参数】 0:方法调用成功。 < 0:方法调用失败。具体请参见客户端错误码。 pauseAllAudioClips
辅流管理 startRemoteAuxiliaryStreamView - (int)startRemoteAuxiliaryStreamView:(HWRtcVideoCanvas *)view; 【功能说明】 开启辅流渲染视图(发起辅流选看) 【请求参数】 view: 具体请参见HWRtcVideoCanvas
0:方法调用成功。 > 0:方法调用失败。具体请参见HRTCErrorCode。 华为SDK系统有默认的编码设置(720P+360P),一般可以不设置发流编码参数。如果您确实需要自定义发流编码参数,请参考华为SDK系统推荐码表:表7 不同分辨率的码率和帧率配置推荐和不同场景下帧率和码率的推荐值,否则可能设置失败。
流对象(Stream) 本章节介绍了Web SDK的Stream接口详情。 表1 Stream接口 接口 描述 play 播放该音视频流。 stop 停止播放视频流。 resume 恢复播放音视频。 close 关闭音视频。 muteAudio 禁用音频轨道。 muteVideo