Flutter配置flutter_vlc_player后显示空白页问题排查及替代方案咨询

遗漏配置检查项 #

• Android端必加配置
  1. 在android/app/src/main/AndroidManifest.xml的manifest标签下添加网络权限：

     <uses-permission android:name="android.permission.INTERNET" />
     

  2. 同文件的application标签添加明文访问权限（适配高版本安卓HTTP播放需求）：

     android:usesCleartextTraffic="true"
     

  3. 把android/app/build.gradle里的minSdkVersion调整到21及以上，低于16会直接无法编译运行。
• iOS端必加配置
  1. 在ios/Runner/Info.plist中添加网络权限配置：

     <key>NSAppTransportSecurity</key>
     <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
     </dict>
     <key>NSLocalNetworkUsageDescription</key>
     <string>需要访问局域网来播放视频流</string>
     

  2. 把iOS项目的最低部署版本调整到12.0及以上。
• 代码逻辑问题修正
  你设置了autoPlay: false，又没有手动触发播放逻辑，播放器初始化完成后会停在初始状态，看起来就是空白。可以在initState中添加状态监听，初始化完成后手动调用播放：

  @override
  void initState() {
    super.initState();
    _videoPlayerController = VlcPlayerController.network(
      'https://local.clift.mdu1.net/3ABN/index.m3u8',
      hwAcc: HwAcc.FULL,
      autoPlay: false,
      options: VlcPlayerOptions(),
    );
    // 新增监听逻辑
    _videoPlayerController.addListener(() {
      if (_videoPlayerController.value.isInitialized && !_videoPlayerController.value.isPlaying) {
        _videoPlayerController.play();
        setState(() {});
      }
    });
  }
  

• 其他兼容问题排查
  你用的测试流是局域网域名，首先确认测试设备和流服务在同一局域网下；另外部分设备对硬解兼容性差，可以把hwAcc参数改为HwAcc.DISABLED测试是否能正常加载。

• video_player：Flutter官方维护的播放器插件，性能轻量稳定，支持常见的MP4、m3u8等主流格式，适合基础播放需求，缺点是自定义控制UI需要自行封装，小众格式兼容性一般。
• better_player：基于video_player二次封装的开源插件，内置常用的播放控制UI，支持缓存、字幕、倍速、全屏等常用功能，配置简单易上手，是国内中小项目的常用选择。
• fijkplayer：基于ijkplayer封装的插件，格式支持非常全面，对直播流的兼容性远高于官方video_player，适合有复杂播放、多格式兼容需求的场景。

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