React Native Video 在 Android 平台上的 HLS 播放问题解析

在 React Native 开发中，react-native-video 是一个广泛使用的视频播放组件。近期有开发者反馈在 Android 平台上遇到 HLS 流媒体无法播放的问题，错误提示为"HLS is not enabled!"。本文将深入分析这一问题的成因和解决方案。

问题现象

当开发者尝试播放 HLS 格式的直播流时，应用抛出 IllegalStateException 异常，明确指出 HLS 功能未被启用。错误堆栈显示问题发生在 ReactExoplayerView 的 buildMediaSource 方法中。

根本原因

这个问题通常由以下两种情况导致：

1. 配置缺失：在项目配置中未正确启用 ExoPlayer 的 HLS 支持
2. 版本兼容性问题：使用的 react-native-video 版本可能存在已知问题

解决方案

配置检查与修正

对于使用 Expo 的项目，需要在 app.json 文件中正确配置 androidExtensions 参数：

{
  "plugins": [
    [
      "react-native-video",
      {
        "androidExtensions": {
          "useExoplayerHls": true,
          "useExoplayerRtsp": true,
          "useExoplayerSmoothStreaming": true
        }
      }
    ]
  ]
}

注意：extensionRendererMode 参数并非有效配置项，不应包含在配置中。

构建验证

完成配置后，必须验证构建过程是否正确应用了这些设置。在 Android 构建日志中应能看到类似输出：

Configure project :react-native-video
useExoplayerHls: true
useExoplayerSmoothStreaming: true
useExoplayerRtsp: true

如果日志中显示 HLS 仍为禁用状态，则说明配置未被正确应用。

版本升级建议

当前问题报告使用的是 6.6.2 版本，而该库已有更新版本。建议开发者：

1. 升级到最新稳定版
2. 检查更新日志中是否有相关问题的修复
3. 在新版本中重新测试 HLS 功能

深入理解

HLS (HTTP Live Streaming) 是苹果公司提出的流媒体传输协议，现已被广泛支持。在 Android 平台上，react-native-video 通过 ExoPlayer 实现 HLS 支持。当出现"HLS is not enabled"错误时，实际上是 ExoPlayer 的 HlsMediaSource 未被正确初始化。

对于需要支持多种流媒体格式的项目，建议同时启用以下配置：

• useExoplayerDash: 启用 DASH 流支持
• useExoplayerSmoothStreaming: 启用 SmoothStreaming 支持
• useExoplayerRtsp: 启用 RTSP 协议支持

总结

Android 平台上 react-native-video 的 HLS 支持问题通常源于配置不当。开发者应仔细检查构建配置，确保相关功能被正确启用，同时保持库版本更新。通过正确的配置和验证流程，可以确保应用能够稳定播放 HLS 格式的流媒体内容。