如何将WebView音频输出从扬声器切换为听筒？现有代码不生效如何解决？

算力阿峰

2026-10-2

解决方法

1. 修正音频设置代码

原代码的参数设置顺序错误、缺少高版本系统适配是不生效的主要原因，修改后代码如下：

private fun setupAudio() {
    val am = getSystemService(AUDIO_SERVICE) as AudioManager
    // 先关闭扬声器，再设置通信模式，顺序颠倒会导致配置被覆盖不生效
    am.isSpeakerphoneOn = false
    am.mode = AudioManager.MODE_IN_COMMUNICATION
    // 不需要蓝牙音频输出时关闭SCO连接
    am.stopBluetoothSco()
    // Android 10及以上系统强制指定通信设备为听筒
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        am.setCommunicationDevice(android.media.AudioDeviceInfo.TYPE_BUILTIN_EARPIECE)
    }
    Log.e("Foo", "Current mode: ${am.mode}, speaker status: ${am.isSpeakerphoneOn}")
}

2. 补充必要配置

调用时机：必须在WebView加载音频/视频资源之前调用setupAudio()，音频已经开始播放后再修改配置不会主动触发路由切换。

WebView基础配置：添加WebView媒体播放支持配置：

webView.settings.apply {
    javaScriptEnabled = true
    mediaPlaybackRequiresUserGesture = false
}

权限配置：你已经添加的MODIFY_AUDIO_SETTINGS权限已经满足需求，无需额外权限。

3. 页面销毁时重置音频配置

避免影响其他应用的音频输出逻辑，在页面销毁时还原音频模式：

override fun onDestroy() {
    super.onDestroy()
    val am = getSystemService(AUDIO_SERVICE) as AudioManager
    am.mode = AudioManager.MODE_NORMAL
    am.isSpeakerphoneOn = true
    webView.destroy()
}