Android 4.4.2设备中如何为VideoView启用TLS 1.2协议？

我之前也碰到过一模一样的问题——Android 4.4.2（KitKat）本身支持TLS 1.2，但默认没启用，而VideoView依赖的系统MediaPlayer又没开放直接设置SSL Socket Factory的接口，导致没法和只支持TLS 1.2的服务器通信。下面是两种亲测可行的解决办法：

方案一：全局强制启用TLS 1.2（适合API 16-20） #

Android 4.4.2其实已经内置了TLS 1.2的支持，只是没把它设为默认协议。我们可以通过反射修改系统默认的SSL Socket Factory，让所有HTTP连接（包括VideoView的）都优先用TLS 1.2。

在你的Application类的onCreate()方法里加入这段代码：

private void enableTls12OnPreLollipop() {
    if (Build.VERSION.SDK_INT >= 16 && Build.VERSION.SDK_INT < 22) {
        try {
            // 创建支持TLS 1.2的SSL上下文
            SSLContext sc = SSLContext.getInstance("TLSv1.2");
            sc.init(null, null, null);
            // 反射获取系统默认的SSL Socket Factory字段并替换
            Class<?> sslSocketFactoryClass = SSLSocketFactory.class;
            Field field = sslSocketFactoryClass.getDeclaredField("defaultFactory");
            field.setAccessible(true);
            field.set(null, sc.getSocketFactory());
        } catch (Exception e) {
            Log.e("TLS1.2 Setup", "Failed to enable TLS 1.2", e);
        }
    }
}

调用这个方法后，系统所有的HTTP请求都会自动使用TLS 1.2，VideoView自然也能正常连接服务器了。不过要注意，这种全局修改可能会影响其他依赖系统HTTP栈的组件，好在API 16-20的设备基本不会有兼容性问题。

方案二：自定义VideoView，用OkHttp接管HTTP请求 #

如果你不想全局修改系统设置，可以自定义一个VideoView，用OkHttp来处理视频流的请求——OkHttp在Android 4.4.2及以上版本默认就支持TLS 1.2，而且能灵活控制SSL配置。

步骤1：添加OkHttp依赖 #

在你的app/build.gradle里加入OkHttp的依赖：

implementation 'com.squareup.okhttp3:okhttp:4.12.0'

步骤2：实现自定义OkHttpVideoView #

public class OkHttpVideoView extends VideoView {
    private OkHttpClient okHttpClient;
    private Call currentRequestCall;

    public OkHttpVideoView(Context context) {
        super(context);
        initClient();
    }

    public OkHttpVideoView(Context context, AttributeSet attrs) {
        super(context, attrs);
        initClient();
    }

    public OkHttpVideoView(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        initClient();
    }

    private void initClient() {
        // 初始化OkHttp客户端，可根据需求添加超时、拦截器等配置
        okHttpClient = new OkHttpClient.Builder()
                .connectTimeout(30, TimeUnit.SECONDS)
                .readTimeout(30, TimeUnit.SECONDS)
                .build();
    }

    // 自定义加载视频的方法，替代原生的setVideoURI
    public void loadVideoFromUrl(String videoUrl) {
        // 取消之前未完成的请求，避免内存泄漏
        if (currentRequestCall != null && !currentRequestCall.isCanceled()) {
            currentRequestCall.cancel();
        }

        Request request = new Request.Builder()
                .url(videoUrl)
                .build();

        currentRequestCall = okHttpClient.newCall(request);
        currentRequestCall.enqueue(new Callback() {
            @Override
            public void onFailure(@NonNull Call call, @NonNull IOException e) {
                Log.e("OkHttpVideoView", "Failed to fetch video stream", e);
                // 这里可以添加请求失败的UI提示
            }

            @Override
            public void onResponse(@NonNull Call call, @NonNull Response response) throws IOException {
                if (!response.isSuccessful()) {
                    throw new IOException("Unexpected response code: " + response.code());
                }

                // 获取视频输入流，注意要在UI线程操作MediaPlayer
                InputStream videoStream = response.body().byteStream();
                post(() -> {
                    try {
                        // 重置VideoView的MediaPlayer
                        stopPlayback();
                        setMediaPlayer(new MediaPlayer());
                        getMediaPlayer().setDataSource(videoStream.getFD());
                        getMediaPlayer().prepareAsync();
                        getMediaPlayer().setOnPreparedListener(mp -> start());
                    } catch (IOException e) {
                        Log.e("OkHttpVideoView", "Failed to set video data source", e);
                    }
                });
            }
        });
    }

    @Override
    public void stopPlayback() {
        super.stopPlayback();
        // 停止播放时取消请求
        if (currentRequestCall != null) {
            currentRequestCall.cancel();
        }
    }
}

步骤3：在布局和代码中使用 #

在XML布局里替换原生VideoView：

<com.yourpackage.OkHttpVideoView
    android:id="@+id/custom_video_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

然后在Activity/Fragment中调用加载方法：

OkHttpVideoView videoView = findViewById(R.id.custom_video_view);
videoView.loadVideoFromUrl("https://your-server.com/video.mp4");

注意事项 #

• 方案一的反射方法在部分定制ROM上可能失效，如果遇到这种情况，建议改用方案二。
• 方案二中要注意处理好请求的生命周期，比如在Activity销毁时调用stopPlayback()，避免OkHttp请求持续占用资源。
• 无论用哪种方案，都要确保服务器的TLS证书是有效的，否则会出现SSL验证失败的问题。

内容的提问来源于stack exchange，提问作者Serdar Samancıoğlu