RTC SDK为您提供了设备检测和管理的功能，您可以在加入频道之前检查硬件设备是否能正常工作。通过阅读本文，您可以了解设备检测和管理的方法。

功能简介

RTC SDK通过调用内部方法实现设备检测和管理。例如，您可以查询设备信息、检测摄像头是否正常工作、检测音频设备是否正常录音及播放、设置摄像头方向或者切换音频设备（麦克风和扬声器）等。

实现方法

以下为常用的设备检测和管理方法，更多信息，请参见AliRtcEngine接口。

  • getCurrentCameraDirection：获取当前摄像头方向。
    public abstract AliRTCCameraDirection getCurrentCameraDirection();
    返回说明
    • 返回 CAMERA_REAR(0) 表示后置摄像头。
    • 返回 CAMERA_FRONT(1) 表示前置摄像头。
    • 返回 CAMERA_INVALID(-1) 表示无效。
    说明 此接口需要在摄像头打开之后调用，否则会返回 CAMERA_INVALID(-1)。
  • isCameraOn：检查摄像头是否打开。
    public abstract boolean isCameraOn();
    返回说明

    true表示摄像头已打开，false表示摄像头未打开。

  • isSpeakerOn：获取当前音频输出为听筒还是扬声器。
    public abstract boolean isSpeakerOn();
    返回说明

    true 为扬声器，false 为听筒。

  • switchCamera：切换前后摄像头（默认为前置摄像头）。
    public abstract int switchCamera();
    返回说明

    0表示方法调用成功，其他表示方法调用失败。

  • setCameraZoom：设置摄像头缩放比例。
    public abstract int setCameraZoom(float zoom);
    参数说明
    参数类型描述
    zoomfloatzoom的级别。默认值为1.0。
    返回说明

    0表示方法调用成功，其他表示方法调用失败。

  • setCameraFlash：设置摄像头闪光灯是否打开。
    public abstract int setCameraFlash(boolean flash);
    参数说明
    参数类型描述
    flashboolean摄像头闪光灯是否打开，取值：
    • true：开启。
    • false（默认值）：关闭。
    返回说明

    0表示方法调用成功，其他表示方法调用失败。

  • setCameraAutoFocusFaceModeEnabled：设置摄像头人脸对焦。
    public abstract boolean setCameraAutoFocusFaceModeEnabled(boolean enable);
    参数说明
    参数类型描述
    enableboolean是否开启摄像头人脸对焦，取值：
    • true：开启。
    • false（默认值）：关闭。
    返回说明

    true表示方法调用成功，false方法调用失败。

  • enableSpeakerphone：设置音频输出为听筒还是扬声器。
    public abstract int enableSpeakerphone(boolean enable);
    参数说明
    参数类型描述
    enableboolean音频输出为听筒还是扬声器，取值：
    • true（默认值）：扬声器模式。
    • false：听筒模式。
    返回说明

    0表示方法调用成功，其他表示方法调用失败。