更新时间:2024-10-23 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()

功能说明

释放接口。

相关文档