本文为您介绍了阿里云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接口。