RTC SDK为您提供了设备检测和管理的功能,您可以在加入频道之前检查硬件设备是否能正常工作。通过阅读本文,您可以了解设备检测和管理的方法。
功能简介
RTC SDK通过调用内部方法实现设备检测和管理。例如,您可以查询设备信息、检测摄像头是否正常工作、检测音频设备是否正常录音及播放、设置摄像头方向或者切换音频设备(麦克风和扬声器)等。
实现方法
以下为常用的设备检测和管理方法,更多信息,请参见DingRtcEngine。
GetCameraList:获取摄像头列表。
AliEngineDeviceInfoList* GetCameraList();
返回说明
返回摄像头列表。
GetCurrentCameraName:获取当前使用的摄像头名称。
String GetCurrentCameraName();
返回说明
返回当前使用的摄像头名称。
SetCurrentCameraName:选择摄像头名称。
int SetCurrentCameraName(const char* cameraName);
参数说明
名称
类型
描述
cameraName
const char*
摄像头名称。
返回说明
0表示方法调用成功,其他表示方法调用失败。
IsCameraOn:检查摄像头是否打开。
bool IsCameraOn();
返回说明
true表示摄像头已打开,false表示摄像头未打开。
GetRecordingDeviceList:获取系统中的录音设备列表。
RtcEngineDeviceInfoList* GetRecordingDeviceList();
返回说明
返回系统中的录音设备列表。
GetCurrentRecordingDeviceId:获取使用的录音设备ID。
String GetCurrentRecordingDeviceId();
返回说明
返回当前音频采集设备ID。
SetCurrentRecordingDeviceId:选择录音设备ID。
int SetCurrentRecordingDeviceId(const char* deviceId);
参数说明
名称
类型
描述
deviceId
const char*
音频采集设备ID
返回说明
0表示方法调用成功,其他表示方法调用失败。
GetPlayoutDeviceList:获取系统中的扬声器列表。
RtcEngineDeviceInfoList* GetPlayoutDeviceList();
返回说明
返回音频播放设备列表。
GetCurrentPlayoutDeviceId:获取当前使用的扬声器ID。
String GetCurrentPlayoutDeviceId();
返回说明
返回当前音频播放设备ID。
SetCurrentPlayoutDeviceId:选择播放设备ID。
int SetCurrentPlayoutDeviceId(const char* deviceId);
参数说明
名称
类型
描述
deviceId
const char*
音频播放设备ID。
返回说明
0表示方法调用成功,其他表示方法调用失败。