检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备状态发生变化,触发此回调。 【回调参数】 deviceId:系统设备标识,如系统音频播放设备标识可通过getPlaybackDevices获取。 deviceType:系统设备类型,具体请参见HRTCDeviceType。 deviceState:系统设备状态,具体请参见HRTCDeviceState。
接收增值(录制)事件回调通知内容 SparkRTC服务回调用户提供的接口时,会附带以下信息。 表1 请求Body参数 参数 是否必选 参数类型 描述 job_id 否 String 任务编号,可以用于修改、查看和停止录制任务 stream_name 否 String 流名 app_id
支持监听房间成员进出房间吗? 支持,可通过onRemoteUserOnline或onRemoteUserOffline监听房间成员进出房间信息。 父主题: SDK使用
设备状态发生变化,触发此回调。 【回调参数】 deviceId:系统设备标识,如系统音频播放设备标识可通过getPlaybackDevices获取。 deviceType:系统设备类型,具体请参见HRTCDeviceType。 deviceState:系统设备状态,具体请参见HRTCDeviceState。
客户端错误码 本章节介绍了Web SDK的客户端错误码RtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 RTC_ERR_CODE_SUCCESS 0 success 成功。 RTC_ERR_CODE_RTC_SDK_ERROR 90000001
0:方法调用成功。 > 0:方法调用失败。具体请参见HRTCErrorCode。 华为SDK系统有默认的编码设置(720P+360P),一般可以不设置发流编码参数。如果您确实需要自定义发流编码参数,请参考华为SDK系统推荐码表:表7 不同分辨率的码率和帧率配置推荐和不同场景下帧率和码率的推荐值,否则可能设置失败。
通话质量监测 功能描述 加入频道后,SDK会每隔2秒自动触发通话质量相关的回调,上报当前通话的网络质量、本地和远端的音视频统计信息。 上报接口 通话质量上报 onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启,每2s上报一次。 -
HRTCConnStateTypes 网络连接状态 HRTCConnChangeReason 网络状态变化原因 HRTCDeviceType 系统音视频设备设备类型 HRTCDeviceState 系统音视频设备设备状态 HRTCLeaveReason 离开房间原因 HRTCVideoImageFormat 视频帧图片存储格式
通话质量监测 功能描述 加入频道后,SDK会每隔2秒自动触发通话质量相关的回调,上报当前通话的网络质量、本地和远端的音视频统计信息。 上报接口 通话质量上报 onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启,每2s上报一次。 void
用。 由于设备采集能力、系统性能以及浏览器的限制,视频分辨率,帧率,码率的实际值不一定能够完全匹配设定值,这种情况下浏览器会自动调整分辨率,尽可能匹配设定值,具体分辨率以实际采集到的分辨率为准。 能否采集1080p及以上的分辨率取决于采集设备能力以及系统性能,iOS Safari不支持采集1080p。
通话质量监测 功能描述 加入频道后,SDK会每隔2秒自动触发通话质量相关的回调,上报当前通话的网络质量、本地和远端的音视频统计信息。 上报接口 通话质量上报 onNetworkQualityNotify回调上报当前通话中每个入会者的上下行网络质量。默认开启,每2s上报一次。 -
基本使用逻辑 创建新的项目工程,导入 SDK 后,需要创建客户端并获取本地音视频设备信息。 创建本地流并初始化。 当用户加入房间后,将通过回调的方式通知房间内的其他用户,收到用户加入的回调后,可以对音视频流进行订阅、取消订阅等其它操作。 在会中,也可以对本地录音或播放设备等进行配置。
获取账号ID 在调用接口的时候,部分URL中需要填入账号ID,所以需要先在管理控制台上获取到账号ID。具体获取步骤如下: 登录管理控制台。 鼠标悬停在右上角的用户名,选择下拉列表中“我的凭证”。 在“API凭证”页面,即可获取对应的账号ID信息。 图1 获取账号ID 父主题: 附录
房间功能 joinRoom virtual int joinRoom(const HRTCJoinParam &joinParam) 【功能说明】 加入房间。该方法让用户加入通话房间。 【请求参数】 joinParam:加入房间信息。具体请参见HRTCJoinParam。 【返回参数】
辅流管理 setRemoteAuxiliaryStreamViewRotation virtual int setRemoteAuxiliaryStreamViewRotation(const char *userId, HRTCVideoRotation rotation) 【功能说明】
辅流管理 startRemoteAuxiliaryStreamView - (int)startRemoteAuxiliaryStreamView:(HWRtcVideoCanvas *)streamView streamType:(HWRtcStreamType)streamType;
房间功能 joinRoom - (int)joinRoom:(HWRtcJoinParam * _Nonnull)joinParam; 【功能说明】 加入房间。该方法让用户加入通话房间。如果已在通话中,用户必须调用leaveRoom退出当前通话,才能进入下一个房间。 【请求参数】
辅流管理 setRemoteAuxiliaryStreamViewRotation virtual int setRemoteAuxiliaryStreamViewRotation(const char *userId, HRTCVideoRotation rotation) 【功能说明】
共享屏幕资源管理 本章节介绍了全平台C++ SDK的IHRTCScreenShareSourceList类接口详情。 表1 IHRTCScreenShareSourceList类 接口 描述 count 获取屏幕共享窗口资源数量 get 获取屏幕共享窗口资源信息 release 资源释放函数
初始化等基础接口 sharedEngine + (instancetype)sharedEngine; 【功能说明】 创建连麦引擎实例。 【请求参数】 无 【返回参数】 返回引擎实例对象。 destroy - (void)destroy; 【功能说明】 注销引擎。 【请求参数】 无