通话前检测

---

1 功能简介

为了保证实时通信体验，通话前可以进行网络与设备的检测，提前识别并排查问题。

• 网络检测：检测网络环境，可用于判断或预测网络环境是否适合推/拉指定码率的流。
• 设备检测：检测本地麦克风、摄像头以及扬声器是否能正常工作。

本文将介绍如何使用 ZEGO SDK 接口，实现上述两个角度的检测。

2 网络检测

请参考 网络与性能 进行操作。

3 设备检测

3.1 麦克风检测

3.1.1 检测逻辑

麦克风设备检测流程如下图所示：

3.1.2 对应接口

1. 启动麦克风

调用 startPreview 接口在不推流的情况下启动音频采集。

    zegoLiveRoom.startPreview();

2. 检测麦克风权限

ZEGO SDK 会自动检查麦克风权限。如果用户未授权，则会请求用户同意；如果用户拒绝，则需要用户手动去系统设置里开启权限。

3. 检测麦克风是否可用

调用 onDeviceError 接口检测设备是否异常，若未检测到任何异常反馈（可同步启动“4. 检测麦克风收音数据”），且麦克风收音数据检测正常，则麦克风设备可用。

public interface IZegoDeviceEventCallback {
    /**
     * 音视频设备错误通知
     * @param deviceName 设备类型名称。返回值参考 {@link com.zego.zegoliveroom.constants.ZegoConstants.DeviceNameType}
     * @param errorCode 错误码。返回值参考 {@link com.zego.zegoliveroom.constants.ZegoConstants.DeviceError}
     */
    void onDeviceError(String deviceName, int errorCode);
}

4. 检测麦克风收音数据

调用 getCaptureSoundLevel 接口获取麦克风采集到声音的能量值。如果数据无异常则麦克风正常，可用于通话。

    float soundLevel = zegoLiveRoom.getCaptureSoundLevel();

3.2 摄像头检测

3.2.1 检测逻辑

摄像头设备检测流程如下图所示：

3.2.2 对应接口

1. 启动摄像头

调用 startPreview 接口绑定摄像头预览画面的视图，在不推流的情况下启动视频采集并预览。

    zegoLiveRoom.setPreviewView(getView());
    zegoLiveRoom.startPreview();

2. 检测摄像头权限

ZEGO SDK 会自动检查摄像头权限。如果用户未授权，则会请求用户同意；如果用户拒绝，则需要用户手动去系统设置里开启权限。

3. 检测摄像头是否可用

调用 onDeviceError 接口检测设备是否异常，若未检测到任何异常反馈（可同步启动“4. 检测画面是否正常”），且画面显示正常，则设备可用。

public interface IZegoDeviceEventCallback {
    /**
     * 音视频设备错误通知
     * @param deviceName 设备类型名称。返回值参考 {@link com.zego.zegoliveroom.constants.ZegoConstants.DeviceNameType}
     * @param errorCode 错误码。返回值参考 {@link com.zego.zegoliveroom.constants.ZegoConstants.DeviceError}
     */
    void onDeviceError(String deviceName, int errorCode);
}

4. 检测画面是否正常

若此时画面显示正常，则摄像头正常，可用于通话。

3.3 扬声器检测

3.3.1 检测逻辑

播放设备检测流程如下图所示：

3.3.2 对应接口

1. 使用媒体播放器播放音频文件

调用 ZegoMediaPlayer 接口播放您用于测试的音频文件。

    zegoMediaPlayer = new ZegoMediaPlayer();
    zegoMediaPlayer.init(ZegoMediaPlayer.PlayerTypePlayer, ZegoMediaPlayer.PlayerIndex.First);
    zegoMediaPlayer.start("path", 0);

2. 检测是否听到声音

如果可以听到相应的音频，则播放设备正常，可用于通话。

4 API 参考列表

5 常见错误码

当开发者收到 onDeviceError 设备回调不为 0 时，相关的错误码如下：