视频设备管理
功能介绍
本节介绍如何使用 SDK 管理本地视频设备,包括:
- 枚举系统中的视频设备(含系统摄像头、自定义摄像头)
- 获取设备信息(设备 ID、名称、最大分辨率、设备类型等)
- 默认视频设备
- 监听视频设备变化
1. 设备枚举与信息
通过接口可获得指定用户(本端或远端)的视频设备列表,用于在 UI 中展示或选择。
- 调用示例:
RTCMeeting *meeting = [RTCMeeting shareInstance];
// 获取本端所有视频设备信息
NSString *myUserID = @"12345678";
NSMutableArray<UsrVideoInfo *> *videoDevs = [meeting getAllVideoInfo:myUserID];
for (UsrVideoInfo *info in videoDevs) {
// info.devID:设备编号(对应 C++ 的 _videoID)
// info.videoName:设备名称(对应 C++ 的 _devName)
// info.isDisabled:是否被禁用
// info.isIPCamera:是否为网络摄像头
// info.isCustomCamera:是否为自定义摄像头
// info.isScreenCamera:是否为桌面摄像头
// info.isFrontCam:是否为前置摄像头
}
相关结构体与 API 请参考:
2. 默认视频设备
SDK 内部会自动产生默认视频设备(除非系统没有任何真实摄像头、自定义摄像头、网络摄像头等)。应用可通过 setDefaultVideo 将指定视频设备设为本端默认视频设备等。
- 设置与获取默认视频设备示例:
RTCMeeting *meeting = [RTCMeeting shareInstance];
NSString *myUserID = @"12345678";
// 获取当前本端默认视频设备 ID
short defVideoID = [meeting getDefaultVideo:myUserID];
// 将指定视频设备设为默认设备
short videoID = 1; // 替换为实际的设备ID
[meeting setDefaultVideo:myUserID videoID:videoID];
当默认视频设备被移除时,SDK 会自动选择新的默认视频设备;
相关 API 请参考:
3. 系统设备变化通知
当系统摄像头设备有插拔,或添加移除桌面摄像头、网络摄像头、自定义摄像头时,SDK 会通过videoDevChanged回调业务层;
如果移除的是默认视频设备,SDK 内部会自动选择一个新的默认视频设备,并通过defVideoChanged回调业务层;
以上设备变化通知,同时会广播到房间中,所有参会者都能收到本端 SDK 对应UserID的以上通知回调;
相关 API 与回调请参考:
更多“推送视频流”“多路视频流”“桌面/网络/自定义摄像头”说明请参见: