Android

BRTC 设备管理接口

详细信息

isFrontCamera
判断当前是否为前置摄像头

boolean isFrontCamera()     

switchCamera
切换摄像头

int switchCamera(boolean frontCamera)   

调用此接口会尝试在前置和后置摄像头之间进行切换。但是目前有些设备的后置摄像头不止一个，因此，调用此接口会依次切换下一个后置摄像头。

getCameraZoomMaxRatio
获取摄像头的最大缩放倍数

float getCameraZoomMaxRatio()   

setCameraZoomRatio
设置摄像头的缩放倍数

int setCameraZoomRatio(float zoomRatio)

参数

isAutoFocusEnabled
查询是否支持自动识别人脸位置

boolean isAutoFocusEnabled()   

enableCameraAutoFocus
开启自动对焦功能

boolean enableCameraAutoFocus(boolean enable)

参数

详情

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

setCameraFocusPosition
设置摄像头的对焦位置

int setCameraFocusPosition(int x, int y)    

参数

详情

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

enableCameraTorch
开启/关闭闪光灯，也就是手电筒模式

boolean enableCameraTorch(boolean enable)            

参数

setAudioRoute
设置音频路由

int setAudioRoute(BRTCAudioRoute route)         

参数

详情

设置“音频路由”，即设置声音是从设备的扬声器还是从听筒中播放出来。
手机有两个音频播放设备：一个是位于手机顶部的听筒，一个是位于手机底部的立体声扬声器。

• 设置音频路由为听筒时，声音比较小，只有将耳朵凑近才能听清楚，隐私性较好，适合用于接听电话。
• 设置音频路由为扬声器时，声音比较大，不用将手机贴脸也能听清，因此可以实现“免提”的功能。

setSystemVolumeType
设置 SDK 使用的系统音量类型

int setSystemVolumeType(BRTCSystemVolumeType type)

参数

详情

• 通常 Android 系统存在多种系统声音类型，BRTC SDK 目前支持在【通话】与【媒体】两种系统音量类型下切换。默认是 BRTCSystemVolumeTypeAuto 自动模式。

• 【通话音量】通常比较适合需要上麦的场景。在这种模式下， 可以最大程度利用硬件设备的回声消除等能力来保障语音效果

• 【媒体音量】通常在直播场景下用的较多，即不需要上麦，只是收看主播的场景。
• 【通话音量】和【媒体音量】之间在大多数设备上都存在相互抑制的情况，因此，除非您特别了解具体的应用场景，我们建议您保持自动模式

isCameraZoomSupported
判断当前摄像头是否支持变焦

boolean isCameraZoomSupported()

isCameraTorchSupported
判断当前摄像头是否支持闪光灯

boolean isCameraTorchSupported()

getCameraNames
获取摄像头名称列表

String[] getCameraNames();

getCameraSupportFormat
获取摄像头支持的分辨率列表

List<BRTCDef.BRTCCameraCaptureFormat> getCameraSupportFormat(String cameraName);

参数

返回值

enableAutoRequestAudioFocus
开启/关闭自动请求音频焦点

int enableAutoRequestAudioFocus(boolean enable);

setPreferredAudioInput
设置首选音频输入设备

int setPreferredAudioInput(AudioDeviceInfo deviceInfo);

参数

返回值
0 表示成功，小于 0 的值表示失败