Android音频输出广播监听与强制路由实现问题咨询

需求背景 #

开发音频路由管控功能，目标为每当音频输出路由发生变更时，自动将音频强制路由至用户选定的设备，能力需同时覆盖通话场景与媒体/音乐播放场景。
典型验证场景：用户已接入有线/蓝牙耳机接听来电，若手动点击手机通话界面的扬声器图标切换到外放，应用需要自动将音频路由重新切回耳机。

目前已实现按钮触发的音频输出切换功能：

• 有线耳机场景，点击按钮可通过以下代码成功完成路由切换：

mAudioManager.setMode(AudioManager.MODE_IN_CALL);
mAudioManager.setSpeakerphoneOn(false);

• 蓝牙耳机非通话场景（仅媒体/音乐播放生效），通过以下代码可成功完成路由切换：

mAudioManager.setMode(AudioManager.MODE_IN_COMMUNICATION);
mAudioManager.startBluetoothSco();
mAudioManager.setBluetoothScoOn(true);
mAudioManager.setSpeakerphoneOn(false);

现存问题 #

1. 通话场景下，点击通话界面的扬声器图标停止使用蓝牙耳机输出后，调用上述蓝牙耳机切换代码无法将音频重新路由回蓝牙耳机，功能失效。
2. 暂未找到可监听全类型音频输出路由变更的广播方案，无法实现路由自动切换（无需用户手动点击应用按钮触发）。目前仅找到适配蓝牙耳机的相关广播代码，该方案不支持有线耳机场景，且实际测试中蓝牙场景下也未正常生效，对应实现代码如下：

private final BroadcastReceiver broadcastReceiver = new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
            if (intent.getAction().equals(BluetoothHeadset.ACTION_AUDIO_STATE_CHANGED)) {
                int state = intent.getIntExtra(BluetoothHeadset.EXTRA_STATE, -1);
                switch (state) {
                    case BluetoothHeadset.STATE_AUDIO_CONNECTED:
                        Toast.makeText(context, "Bluetooth Connected", Toast.LENGTH_SHORT).show();
                    case BluetoothHeadset.STATE_AUDIO_DISCONNECTED:
                        Toast.makeText(context, "Bluetooth Disconnected", Toast.LENGTH_SHORT).show();
                        mAudioManager.setMode(AudioManager.MODE_IN_CALL);
                        mAudioManager.startBluetoothSco();
                        mAudioManager.setBluetoothScoOn(true);
                        mAudioManager.setSpeakerphoneOn(false);
                        break;
                }
            }
        }
    };

可落地方案 #

一、修复通话场景下蓝牙耳机路由切回失效问题 #

通话场景下系统原生通话界面会持有音频焦点，直接调用SCO相关接口会被系统通话服务的路由策略覆盖，按以下逻辑调整即可生效：

1. 不要在检测到路由变化后立刻调用切换接口，加150-300ms的延迟，等系统通话界面的路由切换操作完全执行完毕再执行自定义路由逻辑，避免自己的操作被系统后续的状态更新覆盖。
2. 通话场景下设置蓝牙路由前，先显式重置扬声器、SCO状态，再按顺序调用接口，完整可复用代码如下：

// 通话场景切回蓝牙耳机的正确逻辑
new Handler(Looper.getMainLooper()).postDelayed(() -> {
    mAudioManager.setSpeakerphoneOn(false);
    mAudioManager.setBluetoothScoOn(false);
    if (!mAudioManager.isBluetoothScoOn()) {
        mAudioManager.startBluetoothSco();
    }
    mAudioManager.setBluetoothScoOn(true);
}, 200);

3. Android 12及以上版本，必须提前申请BLUETOOTH_CONNECT权限，否则SCO相关接口调用会静默失败，没有任何报错提示。

二、实现全类型音频路由变更监听 #

不要依赖零散的设备连接广播，直接用AudioDeviceCallback实现全类型输出设备的路由变更监听，该方案从API 23（Android 6.0）开始支持，可同时监听有线耳机、蓝牙耳机、内置扬声器、USB音频设备等所有输出类型的路由变化，维护成本远低于多广播组合方案，注册方式如下：

// 获取AudioManager实例
AudioManager mAudioManager = (AudioManager) getSystemService(Context.AUDIO_SERVICE);
// 定义音频设备变更回调
AudioDeviceCallback deviceCallback = new AudioDeviceCallback() {
    @Override
    public void onAudioDevicesAdded(AudioDeviceInfo[] addedDevices) {
        super.onAudioDevicesAdded(addedDevices);
        // 新音频设备接入时触发，可在这里更新用户可选设备列表
        checkCurrentRouteAndForceSwitch();
    }

    @Override
    public void onAudioDevicesRemoved(AudioDeviceInfo[] removedDevices) {
        super.onAudioDevicesRemoved(removedDevices);
        // 音频设备拔出时触发
        checkCurrentRouteAndForceSwitch();
    }
};

// 注册回调：在页面/服务onCreate时注册，onDestroy时注销避免内存泄漏
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    mAudioManager.registerAudioDeviceCallback(deviceCallback, new Handler(Looper.getMainLooper()));
}

在checkCurrentRouteAndForceSwitch()方法中，先获取当前实际生效的音频输出设备，和用户预先选定的目标设备做对比，如果不一致就执行对应路由切换逻辑：

private void checkCurrentRouteAndForceSwitch() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        // 遍历当前活跃的输出设备，判断是否和用户选定的目标设备匹配
        boolean isTargetDeviceActive = false;
        if (/* 用户选定目标为有线耳机 */) {
            isTargetDeviceActive = mAudioManager.isWiredHeadsetOn();
        } else if (/* 用户选定目标为蓝牙耳机 */) {
            isTargetDeviceActive = mAudioManager.isBluetoothScoOn() || mAudioManager.isBluetoothA2dpOn();
        } else if (/* 用户选定目标为扬声器 */) {
            isTargetDeviceActive = mAudioManager.isSpeakerphoneOn();
        }
        // 如果当前路由不是用户选定设备，执行强制切换
        if (!isTargetDeviceActive) {
            // 在这里根据目标设备类型，调用之前验证过的路由切换代码即可
        }
    }
}

三、原有广播方案失效的核心问题 #

你之前写的广播代码有两个明确bug：

1. STATE_AUDIO_CONNECTED分支后面没有加break，会出现case穿透，蓝牙连接成功时也会执行断开分支的切换逻辑，直接导致状态混乱。
2. 仅监听BluetoothHeadset.ACTION_AUDIO_STATE_CHANGED只能收到蓝牙通话音频的状态变化，有线耳机插拔需要额外监听AudioManager.ACTION_HEADSET_PLUG广播，USB音频设备需要额外监听USB设备插拔广播，适配成本高且兼容性差。

适配提示：部分厂商定制ROM上，系统原生通话应用会配置更高的路由优先级，如果遇到回调触发后切换仍然失效的情况，可以把路由管控逻辑放到前台服务里运行，同时提升服务优先级，避免被系统权限策略拦截。

内容的提问来源于stack exchange，提问作者Kali C