本文为您介绍了阿里云 RTC 的设备检测和管理功能,您可以在加入频道之前检查硬件设备是否能正常工作。
功能简介
AliRTCSDK 提供了检测和管理设备的功能,方便您测试和检测设备。例如,您可以查询设备信息、检测摄像头是否正常工作、检测音频设备是否正常录音及播放、设置摄像头方向或者切换音频设备(麦克风和扬声器)等。
实现方法
在实现该功能之前,需要您已经搭建 AppServer、实现基本功能等操作。详情请参见入门概述。
具体实现方法如下所示。
- getCameraList:获取摄像头列表。
void getCameraList(AliRtc::StringArray& array)
参数 | 类型 | 描述 |
array | AliRtc::StringArray& | 摄像头列表。 |
- getCurrentCamera:获取当前使用的摄像头名称。
AliRtc::String getCurrentCamera()
- setCurrentCamera:选择摄像头。必须先调用 getCameraList 接口获取设备列表后再调用此接口设置。
void setCurrentCamera(const AliRtc::String& camera)
参数 | 类型 | 描述 |
camera | const AliRtc::String& | 摄像头名称。 |
- isCameraOn:检查摄像头是否打开。返回 true 表示摄像头已打开,false 表示摄像头未打开。
bool isCameraOn()
- getAudioCaptures:获取系统中的录音设备列表。
void getAudioCaptures(AliRtc::StringArray& array)
参数 | 类型 | 描述 |
array | AliRtc::StringArray& | 音频采集设备列表。 |
- getCurrentAudioCapture:获取当前使用的音频采集设备名称。
AliRtc::String getCurrentAudioCapture()
- setCurrentAudioCapture:选择音频采集设备。必须先调用 getAudioCaptures 接口获取设备列表后再调用此接口设置。
void setCurrentAudioCapture(const AliRtc::String& capture)
参数 | 类型 | 描述 |
capture | String | 音频采集设备名称。 |
- getAudioRenderers:获取系统中的扬声器列表。
void getAudioRenderers(AliRtc::StringArray& array)
参数 | 类型 | 描述 |
array | AliRtc::StringArray& | 音频播放设备列表。 |
- getCurrentAudioRenderer:获取当前使用的音频播放设备。
AliRtc::String getCurrentAudioRenderer()
- setCurrentAudioRenderer:选择音频播放设备。必须先调用 getAudioRenderers 接口获取设备列表后再调用此接口设置。
void setCurrentAudioRenderer(const AliRtc::String &renderer)
参数 | 类型 | 描述 |
renderer | String | 音频播放设备名称。 |
更多接口实现方法,请参见 AliRtcEngine 接口。
「视频云技术」你最值得关注的音视频技术公众号,每周推送来自阿里云一线的实践技术文章,在这里与音视频领域一流工程师交流切磋。