Android 12/13设备WebView视频渲染失败（类Yacine TV应用）

可能的触发原因 #

• Android 12+（API 31）引入了更严格的媒体渲染权限和进程管理机制，部分设备的WebView默认禁用了特定视频编码的硬件加速，或对H.265/AV1等格式的支持存在兼容性缺口。
• 跨域资源共享（CORS）策略执行更严格：若视频流的服务器未正确配置CORS响应头，WebView会阻止视频帧加载，仅保留音频流。
• WebView渲染上下文冲突：Android 12+对WebView的进程隔离机制升级，应用内的WebView配置与系统WebView的进程设置冲突，导致视频渲染线程异常终止。

可行修复方案 #

1. 补充WebView媒体相关配置 #

在初始化WebView时，添加缺失的权限和渲染配置：

WebView webView = findViewById(R.id.webView);
WebSettings settings = webView.getSettings();

// 基础配置
settings.setJavaScriptEnabled(true);
settings.setDomStorageEnabled(true);
settings.setMediaPlaybackRequiresUserGesture(false);

// 媒体访问权限
settings.setAllowContentAccess(true);
settings.setAllowFileAccess(true);
settings.setAllowFileAccessFromFileURLs(true);
settings.setAllowUniversalAccessFromFileURLs(true);

// 强制硬件加速（需配合Activity配置）
webView.setLayerType(View.LAYER_TYPE_HARDWARE, null);

同时在AndroidManifest.xml中给承载WebView的Activity开启硬件加速：

<activity 
    android:name=".StreamPlayActivity" 
    android:hardwareAccelerated="true" />

2. 监听WebView媒体加载事件，主动触发渲染 #

通过WebChromeClient监听页面加载状态，在页面加载完成后强制触发视频播放，避免渲染上下文未初始化：

webView.setWebChromeClient(new WebChromeClient() {
    @Override
    public void onProgressChanged(WebView view, int newProgress) {
        super.onProgressChanged(view, newProgress);
        if (newProgress == 100) {
            // 执行JS触发视频播放（适配网页端的视频标签选择器）
            view.evaluateJavascript("document.querySelector('video')?.play();", null);
        }
    }

    @Override
    public void onShowCustomView(View view, CustomViewCallback callback) {
        super.onShowCustomView(view, callback);
        // 处理全屏播放场景，确保视频视图正常启动
        if (view instanceof VideoView) {
            ((VideoView) view).start();
        }
    }
});

3. 兼容视频编码格式 #

若视频流使用H.265/AV1编码，部分Android 12/13设备的WebView硬件解码不支持，可尝试：

• 网页端降级视频编码为H.264（兼容性更广）；
• 强制WebView使用软件解码作为 fallback（API 29+支持）：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    webView.getSettings().setMediaCodecEnabled(false);
}

4. 集成独立WebView包规避系统差异 #

若测试系统WebView版本无效，可集成AndroidX WebView包，脱离对系统WebView的依赖：
在build.gradle（Module级别）中添加依赖：

implementation 'androidx.webkit:webkit:1.6.0'

替换代码中的android.webkit.WebView为androidx.webkit.WebView，并使用AndroidX的相关API配置。

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