详细描述

Tencent Cloud Device Management Module

Module: TRTC 音视频设备管理模块 Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬件设备

结构体说明

◆ com::tencent::liteav::device::TXDeviceManager::TXSystemVolumeType

interface com::tencent::liteav::device::TXDeviceManager::TXSystemVolumeType

成员变量
	TXSystemVolumeTypeAuto	自动切换模式
	TXSystemVolumeTypeMedia	全程媒体音量
	TXSystemVolumeTypeVOIP	全程通话音量

◆ com::tencent::liteav::device::TXDeviceManager::TXAudioRoute

interface com::tencent::liteav::device::TXDeviceManager::TXAudioRoute

成员变量
	TXAudioRouteEarpiece	Earpiece：使用听筒播放，听筒位于手机顶部，声音偏小，适合需要保护隐私的通话场景。
	TXAudioRouteSpeakerphone	Speakerphone：使用扬声器播放（即“免提”），扬声器位于手机底部，声音偏大，适合外放音乐。

◆ com::tencent::liteav::device::TXDeviceManager::TXCameraCaptureMode

interface com::tencent::liteav::device::TXDeviceManager::TXCameraCaptureMode

成员变量
	TXCameraCaptureManual	允许用户设置本地摄像头采集的视频宽高。
	TXCameraResolutionStrategyAuto	自动调整采集参数。 SDK 根据实际的采集设备性能及网络情况，选择合适的摄像头输出参数，在设备性能及视频预览质量之间，维持平衡。
	TXCameraResolutionStrategyHighQuality	优先保证视频预览质量。 SDK选择较高的摄像头输出参数，从而提高预览视频的质量。在这种情况下，会消耗更多的 CPU 及内存做视频前处理。
	TXCameraResolutionStrategyPerformance	优先保证设备性能。 SDK 根据用户设置编码器的分辨率和帧率，选择最接近的摄像头输出参数，从而保证设备性能。

◆ com::tencent::liteav::device::TXDeviceManager::TXCameraCaptureParam

class com::tencent::liteav::device::TXDeviceManager::TXCameraCaptureParam

成员变量
int	height	【字段含义】采集图像宽度
TXCameraCaptureMode	mode	【字段含义】摄像头采集偏好
int	width	【字段含义】采集图像长度

◆ com::tencent::liteav::device::TXDeviceManager

interface com::tencent::liteav::device::TXDeviceManager

移动端设备操作接口
boolean	isFrontCamera ()

int	switchCamera (boolean frontCamera)

float	getCameraZoomMaxRatio ()

int	setCameraZoomRatio (float zoomRatio)

boolean	isAutoFocusEnabled ()

int	enableCameraAutoFocus (boolean enabled)

int	setCameraFocusPosition (int x, int y)

boolean	enableCameraTorch (boolean enable)

int	setAudioRoute (TXAudioRoute route)

桌面端设备操作接口
void	setCameraCapturerParam (TXCameraCaptureParam params)

弃用接口（建议使用对应的新接口）
int	setSystemVolumeType (TXSystemVolumeType type)

成员函数说明

◆ enableCameraAutoFocus()

int enableCameraAutoFocus ( boolean enabled )

开启自动对焦功能（仅适用于移动端）

开启后，SDK 会自动检测画面中的人脸位置，并将摄像头的焦点始终对焦在人脸位置上。

◆ enableCameraTorch()

boolean enableCameraTorch ( boolean enable )

开启/关闭闪光灯，也就是手电筒模式（仅适用于移动端）

◆ getCameraZoomMaxRatio()

float getCameraZoomMaxRatio ( )

获取摄像头的最大缩放倍数（仅适用于移动端）

◆ isAutoFocusEnabled()

boolean isAutoFocusEnabled ( )

查询是否支持自动识别人脸位置（仅适用于移动端）

◆ isFrontCamera()

boolean isFrontCamera ( )

判断当前是否为前置摄像头（仅适用于移动端）

◆ setAudioRoute()

int setAudioRoute ( TXAudioRoute route )

设置音频路由（仅适用于移动端）

手机有两个音频播放设备：一个是位于手机顶部的听筒，一个是位于手机底部的立体声扬声器。设置音频路由为听筒时，声音比较小，只有将耳朵凑近才能听清楚，隐私性较好，适合用于接听电话。设置音频路由为扬声器时，声音比较大，不用将手机贴脸也能听清，因此可以实现“免提”的功能。

◆ setCameraCapturerParam()

void setCameraCapturerParam ( TXCameraCaptureParam params )

设置摄像头采集偏好

◆ setCameraFocusPosition()

int setCameraFocusPosition	(	int	x,
		int	y
	)

设置摄像头的对焦位置（仅适用于移动端）

您可以通过该接口实现如下交互：

在本地摄像头的预览画面上，允许用户单击操作。
在用户的单击位置显示一个矩形方框，以示摄像头会在此处对焦。
随后将用户点击位置的坐标通过本接口传递给 SDK，之后 SDK 会操控摄像头按照用户期望的位置进行对焦。
注意
使用该接口的前提是先通过 enableCameraAutoFocus 关闭自动对焦功能。

参数

position 对焦位置，请传入期望对焦点的坐标值

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

◆ setCameraZoomRatio()

int setCameraZoomRatio ( float zoomRatio )

设置摄像头的缩放倍数（仅适用于移动端）

参数

zoomRatio 取值范围1 - 5，取值为1表示最远视角（正常镜头），取值为5表示最近视角（放大镜头）。

◆ setSystemVolumeType()

int setSystemVolumeType ( TXSystemVolumeType type )

设置系统音量类型（仅适用于移动端）

弃用:: v9.5 版本开始不推荐使用，建议使用 TRTCCloud 中的 startLocalAudio(quality) 接口替代之，通过 quality 参数来决策音质。

◆ switchCamera()

int switchCamera ( boolean frontCamera )

切换前置或后置摄像头（仅适用于移动端）