更新时间:2025-02-28 GMT+08:00
分享

视频设备管理

本章节介绍了全平台C++ SDK的IHRTCVideoDeviceManager接口详情。

表1 IHRTCVideoDeviceManager接口

接口

描述

getVideoDevices

获取系统视频设备列表

setVideoDevice

设置视频设备

getCurrentVideoDevice

获取当前视频设备

cameraDeviceTest

视频采集设备测试

finishCameraDeviceTest

结束视频采集设备测试

表2 IVideoDeviceCollection类

接口

描述

getCount

获取设备个数

getDevice

通过设备序号获取设备信息

release

释放接口

getVideoDevices

virtual int getVideoDevices(HRTCDeviceInfo *deviceInfo, unsigned int *counts)

【功能说明】

获取系统视频设备列表。

【请求参数】

  • deviceInfo:输出参数,获取系统设备详情,包括设备标识和设备名称。具体请参见HRTCDeviceInfo。
  • counts:输入输出参数,获取deviceInfo对象数量,输入值为deviceInfo的数量,将会返回小于等于counts数量的设备信息。

【返回参数】

  • 0:方法调用成功。
  • > 0:方法调用失败。具体请参见HRTCErrorCode。

getVideoDevices

virtual IVideoDeviceCollection * getVideoDevices()

【功能说明】

获取系统视频设备列表。

【返回参数】

IVideoDeviceCollection:视频设备列表,具体请参见IVideoDeviceCollection。

setVideoDevice

virtual int setVideoDevice(const char deviceId[HRTC_MAX_DEVICE_ID_LEN+ 1])

【功能说明】

设置视频设备。

【请求参数】

deviceId:设备标识。可通过getVideoDevices获取。

【返回参数】

  • 0:方法调用成功。
  • > 0:方法调用失败。具体请参见HRTCErrorCode。
  • 通话前没有选择任何设备,通话中使用默认设备。
  • 通话前已选择指定设备,通话中直接生效。
  • 通话中所有拔插视频设备的操作,不会自动切换设备,需要应用重新调用该接口并设置对应设备才生效。

getCurrentVideoDevice

virtual int getCurrentVideoDevice(char deviceId[HRTC_MAX_DEVICE_ID_LEN + 1])

【功能说明】

获取当前视频设备。

【请求参数】

deviceId:输出参数。设备标识。

【返回参数】

  • 0:方法调用成功。
  • > 0:方法调用失败。具体请参见HRTCErrorCode。

cameraDeviceTest

virtual int cameraDeviceTest(view_t hwnd)

【功能说明】

视频采集设备测试,只支持入会前调用。

【请求参数】

hwnd:窗口句柄。

【返回参数】

  • 0:方法调用成功。
  • > 0:方法调用失败。具体请参见HRTCErrorCode。

finishCameraDeviceTest

virtual int finishCameraDeviceTest()

【功能说明】

结束视频采集设备测试,只支持入会前调用。

【请求参数】

无。

【返回参数】

  • 0:方法调用成功。
  • > 0:方法调用失败。具体请参见HRTCErrorCode。

getCount

virtual int getCount()

【功能说明】

获取当前视频设备个数。

【返回参数】

视频设备个数。

getDevice

virtual HRTCDeviceInfo* getDevice(int index)

【功能说明】

通过视频序号获取视频设备信息。一般轮询取设备信息,index从0到count取到的个数减1。

【返回参数】

视频设备信息,具体请参见HRTCDeviceInfo。

release

virtual void release()

【功能说明】

释放接口。

相关文档