安卓应用无法播放部分m3u8直播流的兼容实现咨询

问题根因 #

当前使用原生VideoView搭配系统MediaPlayer的实现对HLS（m3u8）协议的兼容能力极弱，仅支持符合最基础规范的公开流，出现部分流可播、部分流失败的核心原因如下：

• 原生播放器HLS规范覆盖不全：仅兼容HLS v3基础标准，不支持索引内相对路径分片解析、非标准响应头适配、高版本TLS握手、HTTP/HTTPS跨协议重定向等常见场景。无法播放的tolotv流m3u8索引托管在静态资源服务上，内部分片地址为相对路径，原生播放器解析时会出现路径拼接错误，根本拉取不到实际分片资源
• 默认请求参数容易被源站拦截：原生播放器默认使用系统组件标识作为请求UA，不少直播源会拦截非浏览器、非官方客户端的拉流请求
• 错误捕获逻辑缺失：现有代码仅能捕获同步抛出的异常，播放器拉流、解码过程中触发的异步错误完全无法捕获，播放失败时没有明确提示

落地方案 #

使用AndroidX Media3套件中的ExoPlayer作为播放核心替换原生组件，该播放器对HLS协议的兼容度覆盖全版本规范，原生支持相对路径自动拼接、AES-128加密流播放、多码率自适应、跨协议重定向、自定义请求头等能力，无需针对单个流做特殊适配即可兼容99%以上的公开m3u8直播流。

具体实现步骤 #

1. 替换布局控件
   将原有布局中的VideoView替换为Media3提供的PlayerView，该控件自带完整播放控制栏，无需单独实现MediaController。

2. 添加依赖
   在模块级build.gradle的dependencies块中引入播放组件：

implementation "androidx.media3:media3-exoplayer:1.2.0"
implementation "androidx.media3:media3-exoplayer-hls:1.2.0"
implementation "androidx.media3:media3-ui:1.2.0"

3. 替换原有播放逻辑
   删除原有playVideo方法中的原生播放器逻辑，替换为以下通用HLS播放实现：

private Player exoPlayer;
private void playVideo() {
    // 释放之前的播放器实例
    if (exoPlayer != null) {
        exoPlayer.release();
    }
    // 初始化播放器，优先使用硬解码器
    DefaultRenderersFactory renderersFactory = new DefaultRenderersFactory(this)
            .setExtensionRendererMode(DefaultRenderersFactory.EXTENSION_RENDERER_MODE_PREFER);
    exoPlayer = new ExoPlayer.Builder(this, renderersFactory).build();
    // 绑定播放器到UI控件
    myPlayerView.setPlayer(exoPlayer);
    // 配置HLS拉流参数
    DefaultHttpDataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory()
            .setAllowCrossProtocolRedirects(true)
            .setConnectTimeoutMs(15000)
            .setReadTimeoutMs(15000)
            // 配置通用浏览器UA，绕过大部分源站UA拦截
            .setUserAgent("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36");
    // 构建HLS媒体源
    HlsMediaSource hlsMediaSource = new HlsMediaSource.Factory(dataSourceFactory)
            .createMediaSource(MediaItem.fromUri(Uri.parse(url)));
    // 准备并自动播放
    exoPlayer.setMediaSource(hlsMediaSource);
    exoPlayer.prepare();
    exoPlayer.setPlayWhenReady(true);
    // 统一错误监听
    exoPlayer.addListener(new Player.Listener() {
        @Override
        public void onPlayerError(PlaybackException error) {
            Toast.makeText(AfghanistanTvAct.this, "播放失败：" + error.getMessage(), Toast.LENGTH_SHORT).show();
        }
    });
}

// 绑定页面生命周期，避免内存泄漏
@Override
protected void onDestroy() {
    super.onDestroy();
    if (exoPlayer != null) {
        exoPlayer.release();
        exoPlayer = null;
    }
}

额外兼容优化 #

• 针对校验Referer的直播源，可在DefaultHttpDataSource.Factory中通过setDefaultRequestProperties方法添加对应Referer请求头，即可绕过限制正常播放
• 若遇到硬解码不支持的特殊编码格式，可集成FFmpeg软解码扩展，覆盖几乎所有音视频编码格式
• 不要自行在业务层做m3u8索引拉取、分片路径拼接逻辑，ExoPlayer内部已经做了全场景适配，自行处理反而容易引入解析错误

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