音视频通话

视频设备管理

功能介绍

本节介绍如何使用 SDK 管理本地视频设备,包括:

  • 枚举系统中的视频设备(含系统摄像头、自定义摄像头)
  • 获取设备信息(设备 ID、名称、最大分辨率、设备类型等)
  • 默认视频设备
  • 监听视频设备变化
注意:

成功进入房间后,才可以进行视频设备管理。

1. 设备枚举与信息

String myUserID = "12345678";
ArrayList<UsrVideoInfo> videoDevs = RTCMeeting.getInstance().getAllVideoInfo(myUserID);

for (UsrVideoInfo info : videoDevs) {
    // info.videoID:设备编号
    // info.devName:设备名称
    // info.devMaxSz:支持的最大分辨率
    // info.devType:设备类型
}

相关结构体与 API 请参考:

2. 默认视频设备

// 获取当前本端默认视频设备 ID
short defVideoID = RTCMeeting.getInstance().getDefaultVideo(myUserID);

// 将指定视频设备设为默认设备
RTCMeeting.getInstance().setDefaultVideo(myUserID, videoID);

当默认视频设备被移除时,SDK 会自动选择新的默认视频设备。

相关 API 请参考:

3. 设备变化通知

当系统摄像头设备有插拔,或添加/移除自定义摄像头时,SDK 会通过 videoDevChanged 回调业务层。
如果移除的是默认视频设备,SDK 内部会自动选择新的默认视频设备,并通过 defVideoChanged 回调业务层。

相关 API 与回调请参考:

更多说明请参见: