#include <nertc_video_device_manager.h>
◆ enumerateCaptureDevices()
获取系统中所有的视频采集设备列表。
该方法返回一个 IDeviceCollection 对象,包含系统中所有的音频采集设备。通过IDeviceCollection 对象,App 可以枚举视频采集设备。
- 注解
- 在使用结束后,App 需调用 destroy 方法销毁返回的对象。
- 返回
-
◆ getDevice()
获取当前使用的视频采集设备信息。
通过本接口可以实现获取主流或辅流视频通道已选择的视频采集设备信息。
- 自从
- V4.6.20
- 使用前提
- 请在通过 setDevice 接口设置视频采集设备后调用该方法,否则返回空。
- 调用时机
- 请在初始化后调用该方法。
- 注解
- 纯音频 SDK 禁用该接口,如需使用请前往云信官网下载并替换成视频 SDK。
- 参数说明
-
- 示例代码
std::string device_id = "\\?\usb#vid_046d&pid_081b&mi_00#7&1f6973a&0&0000#{65e8773d-8f56-11d0-a3b9-00a0c9223196}\global";
std::string device_id = "\\?\usb#vid_046d&pid_081b&mi_00#7&1f6973a&0&0000#{65e8773d-8f56-11d0-a3b9-00a0c9223196}\global";
virtual int setDevice(const char device_id[kNERtcMaxDeviceIDLength], NERtcVideoStreamType type=kNERTCVideoStreamMain)=0
NERtcVideoStreamType
Definition: nertc_engine_defines.h:5456
@ kNERTCVideoStreamSub
Definition: nertc_engine_defines.h:5474
@ kNERTCVideoStreamMain
Definition: nertc_engine_defines.h:5465
- 返回
- 0(kNERtcNoError):方法调用成功。
- 其他:方法调用失败。
- 30004(kNERtcErrNotSupported):不支持的操作,比如使用的是纯音频 SDK。
◆ setDevice()
指定视频采集设备。
通过本接口可以实现为主流或辅流视频通道选择视频采集设备。
- 自从
- V4.6.20
- 使用前提
- 请在通过 startVideoPreview 接口开启视频预览后调用该方法。
- 调用时机
- 请在初始化后调用该方法。
- 注解
- 纯音频 SDK 禁用该接口,如需使用请前往云信官网下载并替换成视频 SDK。
- 参数说明
-
- 示例代码
std::string deviceID = ...;
videoManager->setDevice(deviceID, type);
std::string deviceID = ...;
videoManager->setDevice(deviceID, type);
Definition: nertc_video_device_manager.h:31
@ kNERtcIIDVideoDeviceManager
Definition: nertc_engine_defines.h:233
- 返回
- 0(kNERtcNoError):方法调用成功。
- 其他:方法调用失败。
- 30003(kNERtcErrInvalidParam):参数错误,比如 deviceID 设置错误。
- 30004(kNERtcErrNotSupported):不支持的操作,比如使用的是纯音频 SDK。
- 30008(kNERtcErrDeviceNotFound):未找到设备。
- 30009(kNERtcErrInvalidDeviceSourceID):非法的设备,比如设置的 deviceID 字符串含有非法字符。
该类的文档由以下文件生成: