腾讯云实时音视频TXDeviceManager_音视频解决方案_同尘科技

Copyright (c) 2021 Tencent. All rights reserved.
Module: 音视频设备管理模块
Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬件设备
TXDeviceManager

TXDeviceManager

函数列表	描述
isFrontCamera	判断当前是否为前置摄像头（仅适用于移动端）
switchCamera	切换前置或后置摄像头（仅适用于移动端）
getCameraZoomMaxRatio	获取摄像头的最大缩放倍数（仅适用于移动端）
setCameraZoomRatio	设置摄像头的缩放倍数（仅适用于移动端）
isAutoFocusEnabled	查询是否支持自动识别人脸位置（仅适用于移动端）
enableCameraAutoFocus	开启自动对焦功能（仅适用于移动端）
setCameraFocusPosition	设置摄像头的对焦位置（仅适用于移动端）
enableCameraTorch	开启/关闭闪光灯，也就是手电筒模式（仅适用于移动端）
setAudioRoute	设置音频路由（仅适用于移动端）
setExposureCompensation	设置摄像头的曝光参数，取值范围从-1到1
setCameraCapturerParam	设置摄像头采集偏好
setSystemVolumeType	设置系统音量类型（仅适用于移动端）

结构体类型

函数列表	描述
TXCameraCaptureParam	摄像头采集参数

枚举类型

枚举类型	描述
TXSystemVolumeType	系统音量类型（仅适用于移动设备）
TXAudioRoute	音频路由（即声音的播放模式）
TXCameraCaptureMode	摄像头采集偏好

isFrontCamera

isFrontCamera

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

switchCamera

switchCamera

int switchCamera

(boolean frontCamera)

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

getCameraZoomMaxRatio

getCameraZoomMaxRatio

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

setCameraZoomRatio

setCameraZoomRatio

int setCameraZoomRatio

(float zoomRatio)

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

参数	描述
zoomRatio	取值范围1 – 5，取值为1表示最远视角（正常镜头），取值为5表示最近视角（放大镜头）。最大值推荐为5，若超过5，视频数据会变得模糊不清。

isAutoFocusEnabled

isAutoFocusEnabled

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

enableCameraAutoFocus

enableCameraAutoFocus

int enableCameraAutoFocus

(boolean enabled)

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

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

setCameraFocusPosition

setCameraFocusPosition

int setCameraFocusPosition	(int x
	int y)

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

您可以通过该接口实现如下交互：1. 在本地摄像头的预览画面上，允许用户单击操作。2. 在用户的单击位置显示一个矩形方框，以示摄像头会在此处对焦。3. 随后将用户点击位置的坐标通过本接口传递给 SDK，之后 SDK 会操控摄像头按照用户期望的位置进行对焦。

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

注意使用该接口的前提是先通过 enableCameraAutoFocus 关闭自动对焦功能。

返回值说明：

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

enableCameraTorch

enableCameraTorch

boolean enableCameraTorch

(boolean enable)

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

setAudioRoute

setAudioRoute

int setAudioRoute

(TXAudioRoute route)

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

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

setExposureCompensation

setExposureCompensation

int setExposureCompensation

(float value)

设置摄像头的曝光参数，取值范围从-1到1

setCameraCapturerParam

setCameraCapturerParam

void setCameraCapturerParam

(TXCameraCaptureParam params)

设置摄像头采集偏好

setSystemVolumeType

setSystemVolumeType

int setSystemVolumeType

(TXSystemVolumeType type)

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

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

TXSystemVolumeType(Deprecated)

TXSystemVolumeType(Deprecated)

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

@deprecated v9.5 版本开始不推荐使用。
现代智能手机中一般都具备两套系统音量类型，即“通话音量”和“媒体音量”。 通话音量：手机专门为接打电话所设计的音量类型，自带回声抵消（AEC）功能，并且支持通过蓝牙耳机上的麦克风进行拾音，缺点是音质比较一般。当您通过手机侧面的音量按键下调手机音量时，如果无法将其调至零（也就是无法彻底静音），说明您的手机当前处于通话音量。 媒体音量：手机专门为音乐场景所设计的音量类型，无法使用系统的 AEC 功能，并且不支持通过蓝牙耳机的麦克风进行拾音，但具备更好的音乐播放效果。当您通过手机侧面的音量按键下调手机音量时，如果能够将手机音量调至彻底静音，说明您的手机当前处于媒体音量。
SDK 目前提供了三种系统音量类型的控制模式：自动切换模式、全程通话音量模式、全程媒体音量模式。

枚举	取值	描述
TXSystemVolumeTypeAuto	Not Defined	自动切换模式
TXSystemVolumeTypeMedia	Not Defined	全程媒体音量
TXSystemVolumeTypeVOIP	Not Defined	全程通话音量

TXAudioRoute

TXAudioRoute

音频路由（即声音的播放模式）

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

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

TXCameraCaptureMode

TXCameraCaptureMode

摄像头采集偏好

该枚举类型用于摄像头采集参数设置。

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

TXCameraCaptureParam

TXCameraCaptureParam

摄像头采集参数

该设置能决定本地预览图像画质。

枚举类型	描述
height	字段含义： 采集图像宽度
mode	字段含义： 摄像头采集偏好，请参见 TXCameraCaptureMode
width	字段含义： 采集图像长度

对音视频的解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家

腾讯云限时活动1折起，即将结束： 马上收藏

同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠

阿里云解决方案也看看？： 点击对比阿里云的解决方案