LiteAVSDK
腾讯云音视频 SDK ，服务于数万家企业客户的高可用组件，致力于最大限度地节省您的研发成本。
ITXDeviceManager

详细描述

腾讯云视频通话功能的设备管理接口类

结构体说明

◆ ManageLiteAV::ITRTCDeviceCollection

interface ManageLiteAV::ITRTCDeviceCollection

Public 成员函数

UInt32 getCount ()
 
String ^ getDeviceName (UInt32 index)
 
String ^ getDevicePID (UInt32 index)
 
void release ()
 

成员函数说明

◆ getCount()

UInt32 getCount ( )

返回
设备个数

◆ getDeviceName()

String ^ getDeviceName ( UInt32  index)

返回
设备名称，字符编码格式是UTF-8

◆ getDevicePID()

String ^ getDevicePID ( UInt32  index)

返回
设备PID，字符编码格式是UTF-8

◆ release()

void release ( )

遍历完设备后，调用release释放资源。

◆ ManageLiteAV::ITRTCDeviceInfo

interface ManageLiteAV::ITRTCDeviceInfo

Public 成员函数

String ^ getDeviceName ()
 
String ^ getDevicePID ()
 
void release ()
 

成员函数说明

◆ getDeviceName()

String ^ getDeviceName ( )

返回
设备名称，字符编码格式是UTF-8

◆ getDevicePID()

String ^ getDevicePID ( )

返回
设备PID，字符编码格式是UTF-8

◆ release()

void release ( )

获取完设备信息后，调用release释放资源。

◆ ManageLiteAV::ITXDeviceManager

class ManageLiteAV::ITXDeviceManager

Public 成员函数

 ITXDeviceManager ()
 
ITRTCDeviceCollection ^ getDevicesList (TRTCDeviceType type)
 
int setCurrentDevice (TRTCDeviceType type, String^ deviceId)
 
ITRTCDeviceInfo ^ getCurrentDevice (TRTCDeviceType type)
 
int setCurrentDeviceVolume (TRTCDeviceType type, UInt32 volume)
 
UInt32 getCurrentDeviceVolume (TRTCDeviceType type)
 
int setCurrentDeviceMute (TRTCDeviceType type, bool mute)
 
bool getCurrentDeviceMute (TRTCDeviceType type)
 
int startCameraDeviceTest (IntPtr view)
 
int stopCameraDeviceTest ()
 
int startMicDeviceTest (UInt32 interval)
 
int stopMicDeviceTest ()
 
int startSpeakerDeviceTest (String^ filePath)
 
int stopSpeakerDeviceTest ()
 

构造及析构函数说明

◆ ~ITXDeviceManager()

~ITXDeviceManager ( )
protected

◆ ITXDeviceManager()

ITXDeviceManager ( )

成员函数说明

◆ getCurrentDevice()

ITRTCDeviceInfo ^ getCurrentDevice ( TRTCDeviceType  type)

获取当前使用的设备

参数
type设备类型，根据设备类型获取当前设备信息。详见 TRTCDeviceType 定义
返回
ITRTCDeviceInfo 设备信息，能获取设备 ID 和设备名称

◆ getCurrentDeviceMute()

bool getCurrentDeviceMute ( TRTCDeviceType  type)

查询当前设备是否静音

参数
type设备类型，根据设备类型获取当前设备状态。详见TRTCDeviceType定义。
返回
true : 当前设备已静音；false : 当前设备未静音

type 只支持 TRTCDeviceTypeMic、TRTCDeviceTypeSpeaker

◆ getCurrentDeviceVolume()

UInt32 getCurrentDeviceVolume ( TRTCDeviceType  type)

获取当前设备的音量

参数
type设备类型，根据设备类型获取当前设备音量。详见TRTCDeviceType定义。

type 只支持 TRTCDeviceTypeMic、TRTCDeviceTypeSpeaker

◆ getDevicesList()

ITRTCDeviceCollection ^ getDevicesList ( TRTCDeviceType  type)

获取设备列表

参数
type设备类型，指定需要获取哪种设备的列表。详见TRTCDeviceType定义。
  • SDK 会维护 ITXDeviceCollection 对象的生命周期，使用完毕后请调用 release 方法释放资源。
  • type 只支持 TRTCDeviceTypeMic、TRTCDeviceTypeSpeaker、TRTCDeviceTypeCamera

◆ setCurrentDevice()

int setCurrentDevice ( TRTCDeviceType  type,
String^  deviceId 
)

指定当前设备

参数
type设备类型，根据设备类型指定当前设备。详见 TRTCDeviceType 定义。
deviceId从 getDevicesList 中得到的设备 ID
返回
0：操作成功 负数：失败

type 只支持 TRTCDeviceTypeMic、TRTCDeviceTypeSpeaker、TRTCDeviceTypeCamera

◆ setCurrentDeviceMute()

int setCurrentDeviceMute ( TRTCDeviceType  type,
bool  mute 
)

设置当前设备是否静音

参数
type设备类型，根据设备类型设置当前设备状态。详见TRTCDeviceType定义。
mute是否静音/禁画
返回
0：操作成功 负数：失败

type 只支持 TRTCDeviceTypeMic、TRTCDeviceTypeSpeaker

◆ setCurrentDeviceVolume()

int setCurrentDeviceVolume ( TRTCDeviceType  type,
UInt32  volume 
)

设置当前设备的音量

参数
type设备类型，根据设备类型获取当前设备音量。详见TRTCDeviceType定义。
volume音量大小
返回
0：操作成功 负数：失败

type 只支持 TRTCDeviceTypeMic、TRTCDeviceTypeSpeaker

◆ startCameraDeviceTest()

int startCameraDeviceTest ( IntPtr  view)

开始摄像头测试

参数
view预览控件所在的父控件
返回
0：操作成功 负数：失败

在测试过程中可以使用 setCurrentCameraDevice 接口切换摄像头。

◆ startMicDeviceTest()

int startMicDeviceTest ( UInt32  interval)

开始麦克风测试

参数
interval音量回调间隔
返回
0：操作成功 负数：失败

◆ startSpeakerDeviceTest()

int startSpeakerDeviceTest ( String^  filePath)

开始扬声器测试

该方法播放指定的音频文件测试播放设备是否能正常工作。如果能听到声音，说明播放设备能正常工作。

参数
filePath声音文件的路径
返回
0：操作成功 负数：失败

◆ stopCameraDeviceTest()

int stopCameraDeviceTest ( )

结束摄像头测试

返回
0：操作成功 负数：失败

◆ stopMicDeviceTest()

int stopMicDeviceTest ( )

结束麦克风测试

返回
0：操作成功 负数：失败

◆ stopSpeakerDeviceTest()

int stopSpeakerDeviceTest ( )

停止扬声器测试

返回
0：操作成功 负数：失败

枚举类型说明

◆ TRTCDeviceType

enum TRTCDeviceType
strong

设备类型

枚举值
TRTCDeviceTypeUnknow 

未知设备

TRTCDeviceTypeMic 

麦克风

TRTCDeviceTypeSpeaker 

扬声器

TRTCDeviceTypeCamera 

摄像头