如何阻止WebView播放HTML5视频时获取音频焦点？

针对你遇到的这个问题，我有几个实践过的可行方案，你可以根据自己的业务场景选择：

1. 注入JavaScript强制初始静音 + Native层管控音频焦点 #

核心思路是通过JS强制网页中所有视频初始静音，再通过JS-Native交互，仅在用户主动取消静音时才申请音频焦点，从根源避免WebView自动抢占焦点。

实现步骤： #

• 首先，开启WebView的JS支持，并在页面加载完成后注入静音脚本：

WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true);

webView.setWebViewClient(new WebViewClient() {
    @Override
    public void onPageFinished(WebView view, String url) {
        super.onPageFinished(view, url);
        // 注入JS，强制所有视频初始静音
        view.evaluateJavascript(
            "var videos = document.getElementsByTagName('video'); " +
            "for(let i=0; i<videos.length; i++){ " +
            "   videos[i].muted = true; " +
            "   videos[i].volume = 0; " +
            "}",
            null
        );
    }
});

• 然后，定义JS接口，让网页的静音按钮点击事件通知Native层，由Native统一管理音频焦点：

private AudioManager audioManager;
private boolean isAudioFocusGranted = false;

// 初始化音频管理器
audioManager = (AudioManager) getSystemService(Context.AUDIO_SERVICE);

// 定义JS交互接口
class VideoAudioBridge {
    @JavascriptInterface
    public void onUserUnmute() {
        // 用户主动取消静音时，申请音频焦点
        int focusResult = audioManager.requestAudioFocus(
            focusChangeListener,
            AudioManager.STREAM_MUSIC,
            AudioManager.AUDIOFOCUS_GAIN
        );
        if (focusResult == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
            isAudioFocusGranted = true;
            // 通知网页取消视频静音
            webView.evaluateJavascript(
                "var videos = document.getElementsByTagName('video'); " +
                "for(let i=0; i<videos.length; i++){ videos[i].muted = false; }",
                null
            );
        }
    }

    @JavascriptInterface
    public void onUserMute() {
        // 用户静音时，释放音频焦点
        audioManager.abandonAudioFocus(focusChangeListener);
        isAudioFocusGranted = false;
        // 通知网页静音视频
        webView.evaluateJavascript(
            "var videos = document.getElementsByTagName('video'); " +
            "for(let i=0; i<videos.length; i++){ videos[i].muted = true; }",
            null
        );
    }
}

// 给WebView绑定JS接口
webView.addJavascriptInterface(new VideoAudioBridge(), "VideoAudioBridge");

• 最后，实现音频焦点变化的监听，确保焦点状态和视频静音状态同步：

private AudioManager.OnAudioFocusChangeListener focusChangeListener = new AudioManager.OnAudioFocusChangeListener() {
    @Override
    public void onAudioFocusChange(int focusChange) {
        switch (focusChange) {
            case AudioManager.AUDIOFOCUS_LOSS:
            case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
                // 失去焦点时，强制视频静音
                webView.evaluateJavascript(
                    "var videos = document.getElementsByTagName('video'); " +
                    "for(let i=0; i<videos.length; i++){ videos[i].muted = true; }",
                    null
                );
                isAudioFocusGranted = false;
                break;
        }
    }
};

2. 拦截WebView的自动播放行为（Android 11+） #

从Android 11开始，系统提供了更精细的媒体播放控制，你可以禁用WebView的自动播放权限，让视频必须由用户手动触发播放，此时再同步处理静音和焦点：

WebSettings webSettings = webView.getSettings();
// 要求媒体播放必须有用户手势触发
webSettings.setMediaPlaybackRequiresUserGesture(true);

这种方法适合不需要视频自动播放的场景，能直接避免WebView因自动播放抢占焦点。

3. 通过WebChromeClient监听视频播放状态 #

如果你无法修改网页代码，可以通过WebChromeClient拦截视频的展示事件，在视频开始播放前强制静音：

webView.setWebChromeClient(new WebChromeClient() {
    @Override
    public boolean onShowCustomView(View view, CustomViewCallback callback) {
        // 检查是否是视频视图，强制静音
        if (view instanceof VideoView) {
            ((VideoView) view).setVolume(0f);
        }
        return super.onShowCustomView(view, callback);
    }
});

这个方法的兼容性稍差，因为不同WebView内核对视频视图的封装可能不同，但在部分场景下可以快速生效。

注意事项： #

• 对于动态加载视频的网页，建议在JS中监听DOMContentLoaded或video元素的loadedmetadata事件，确保静音脚本能覆盖所有视频。
• 音频焦点的申请和释放要严格遵循Android规范，避免出现焦点泄漏导致其他应用无法正常播放音频的问题。

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