Android WebView音频通过听筒/蓝牙播放及扬声器切换方案问询

问题根因 #

原有代码不生效的核心原因是两个：一是VOIP场景误用了MODE_IN_CALL（该模式专为系统原生电话服务设计，第三方应用调用优先级低），二是未主动申请音频焦点、未适配蓝牙耳机的SCO通道，系统不会主动把WebView的音频路由到听筒/蓝牙耳机。

最优实现方案 #

1. 先添加必要权限

在AndroidManifest.xml中声明如下权限：

<!-- 音频控制基础权限 -->
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<!-- 蓝牙耳机适配权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

Android12及以上版本需要动态申请BLUETOOTH_CONNECT权限，否则蓝牙耳机路由逻辑不会生效。

2. 优化音频初始化逻辑

private fun setupAudio() {
    val am = getSystemService(AUDIO_SERVICE) as AudioManager
    // 主动申请语音通话类型的音频焦点，抢占系统音频路由优先级
    val focusAttr = AudioAttributes.Builder()
        .setUsage(AudioAttributes.USAGE_VOICE_COMMUNICATION)
        .setContentType(AudioAttributes.CONTENT_TYPE_SPEECH)
        .build()
    val focusRequest = AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN)
        .setAudioAttributes(focusAttr)
        .setWillPauseWhenDucked(true)
        .build()
    am.requestAudioFocus(focusRequest)
    
    // VOIP场景使用MODE_IN_COMMUNICATION，适配性远高于MODE_IN_CALL
    am.mode = AudioManager.MODE_IN_COMMUNICATION
    // 默认关闭扬声器，系统会自动优先路由到已连接的蓝牙耳机，无蓝牙则走听筒
    am.isSpeakerphoneOn = false
    // 开启蓝牙SCO通道，支持蓝牙耳机传输语音音频
    am.startBluetoothSco()
    am.isBluetoothScoOn = true
}

3. 扬声器切换功能实现

private fun switchSpeaker(isOpen: Boolean) {
    val am = getSystemService(AUDIO_SERVICE) as AudioManager
    am.isSpeakerphoneOn = isOpen
    // 适配蓝牙状态同步切换
    if (isOpen) {
        am.stopBluetoothSco()
        am.isBluetoothScoOn = false
    } else {
        am.startBluetoothSco()
        am.isBluetoothScoOn = true
    }
}

4. 页面销毁时重置音频状态

避免占用音频通道影响其他应用：

override fun onDestroy() {
    super.onDestroy()
    val am = getSystemService(AUDIO_SERVICE) as AudioManager
    am.mode = AudioManager.MODE_NORMAL
    am.stopBluetoothSco()
    am.isBluetoothScoOn = false
    am.abandonAudioFocusRequest(focusRequest) // 此处focusRequest要定义为全局变量存储
}

关于WebView的AudioStreamType修改说明 #

原生端没有直接修改WebView全局AudioStreamType的公开API，但有两种等价实现方案：

• 前端JS层适配：peer.js拿到远程MediaStream后，给绑定的audio元素调用setSinkId()方法，可直接指定音频输出设备，属于WebRTC标准能力，适配性最好。
• 原生端强制控制：WebView初始化时注入JS代码，覆盖全局音频输出逻辑，统一指定sinkId，无需前端修改代码。

兼容性注意事项 #

• 部分老机型开启WebView硬件加速时可能出现音频路由不生效的问题，可在对应Activity的Manifest配置中添加android:hardwareAccelerated="false"关闭硬件加速测试。
• 如果应用退到后台需要保留音频输出，要搭配前台服务使用，否则系统会自动回收音频焦点。

内容的提问来源于stack exchange，提问作者Sujith S Manjavana