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表示方法调用成功,其他表示方法调用失败。