Android端Voximplant应用如何切换扬声器？

安全阿岳

2026-8-2

Android平台Voximplant应用切换扬声器的实现方法

核心实现逻辑

Voximplant Android SDK通过AudioDeviceManager类管理音频输出设备，切换扬声器本质就是将音频输出设备设置为SPEAKER_PHONE类型。

步骤1：添加必要权限

在AndroidManifest.xml中声明音频设置权限：

<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

步骤2：切换扬声器的代码实现

在需要切换的时机（比如点击切换按钮、通话接通后）执行以下代码：

// 获取AudioDeviceManager实例
AudioDeviceManager audioDeviceManager = Voximplant.getInstance().getAudioDeviceManager();

// 切换到扬声器
audioDeviceManager.setAudioDevice(AudioDevice.SPEAKER_PHONE, new CompletionHandler() {
    @Override
    public void onSuccess() {
        // 切换成功，可在此更新UI（比如切换按钮图标/文本）
    }

    @Override
    public void onFail(VoximplantException exception) {
        // 切换失败，处理错误逻辑（比如提示用户）
    }
});

如果需要切回听筒，只需将AudioDevice.SPEAKER_PHONE替换为AudioDevice.EARPIECE即可。

可选：监听音频设备状态变化

若需同步UI与当前音频设备状态，可添加监听：

audioDeviceManager.addAudioDeviceListener(new AudioDeviceListener() {
    @Override
    public void onAudioDeviceChanged(AudioDevice currentDevice) {
        // 根据当前设备更新UI
        boolean isSpeakerActive = currentDevice == AudioDevice.SPEAKER_PHONE;
        // 示例：更新按钮选中状态
        speakerToggleButton.setChecked(isSpeakerActive);
    }
});