Flutter HLS直播集成Chewie控制器报错求助

错误原因拆解 #

1. Bad state: Future already completed #

你同时触发了两次VideoPlayerController初始化操作：

• 手动调用videoPlayerController.initialize()
• ChewieController设置了autoInitialize: true
  这会导致初始化Future被重复标记为完成，直接抛出该异常。

2. ExoPlayer缓冲卡住错误 #

• 直播场景下默认的LoadControl缓冲参数不匹配，目标缓冲量不足500ms时就停止加载，导致播放卡住
• 播放器初始化时机混乱，未等待VideoPlayerController就绪就创建ChewieController，引发状态异常

解决方案 #

方案1：修复重复初始化问题 #

删除手动调用的videoPlayerController.initialize()，依赖Chewie的autoInitialize自动处理初始化：

@override
void initState() {
  super.initState();
  final videoPlayerController = VideoPlayerController.networkUrl(
    Uri.parse(widget.url),
  );

  chewieController = ChewieController(
    videoPlayerController: videoPlayerController,
    aspectRatio: 16 / 9,
    autoPlay: true,
    looping: false,
    fullScreenByDefault: true,
    draggableProgressBar: false,
    showControlsOnInitialize: false,
    isLive: true,
    autoInitialize: true,
  );
}

方案2：手动控制初始化时机（更稳妥） #

如果需要手动控制初始化流程，关闭Chewie的autoInitialize，等待VideoPlayer初始化完成后再创建ChewieController：

@override
void initState() {
  super.initState();
  _initPlayer();
}

void _initPlayer() async {
  final videoPlayerController = VideoPlayerController.networkUrl(
    Uri.parse(widget.url),
  );
  await videoPlayerController.initialize();
  
  chewieController = ChewieController(
    videoPlayerController: videoPlayerController,
    aspectRatio: 16 / 9,
    autoPlay: true,
    looping: false,
    fullScreenByDefault: true,
    draggableProgressBar: false,
    showControlsOnInitialize: false,
    isLive: true,
    autoInitialize: false, // 关闭自动初始化
  );
  setState(() {}); // 更新UI
}

方案3：优化直播缓冲配置 #

针对HLS直播场景，自定义ExoPlayer的LoadControl参数，增加缓冲时长：

1. 在Android项目的android/app/src/main/res/raw目录下创建player_config.xml：

<?xml version="1.0" encoding="utf-8"?>
<exoplayer>
    <load-control>
        <!-- 直播场景建议设置更高的缓冲目标 -->
        <buffer-size value="10000" /> <!-- 目标缓冲时长10秒 -->
        <min-buffer-size value="5000" /> <!-- 最小缓冲时长5秒 -->
        <max-buffer-size value="20000" /> <!-- 最大缓冲时长20秒 -->
        <buffer-for-playback value="1000" /> <!-- 开始播放需要的缓冲时长1秒 -->
        <buffer-for-playback-after-rebuffer value="3000" /> <!-- 缓冲后恢复播放需要的时长3秒 -->
    </load-control>
</exoplayer>

2. 在AndroidManifest.xml的<application>标签下添加配置：

<meta-data
    android:name="com.google.android.exoplayer2.DEFAULT_PLAYER_CONFIG"
    android:resource="@raw/player_config" />

方案4：检查依赖兼容性 #

确保video_player和chewie版本兼容，建议使用最新稳定版：

# pubspec.yaml
dependencies:
  flutter:
    sdk: flutter
  video_player: ^2.8.1
  chewie: ^1.7.0

额外注意事项 #

• 直播场景下isLive: true必须设置正确，Chewie会针对直播优化控制栏逻辑
• 记得在dispose方法中释放资源：

@override
void dispose() {
  chewieController?.dispose();
  super.dispose();
}

内容的提问来源于stack exchange，提问作者Hadi Khan