Flutter自定义相册选择器本地视频播放异常及切换需求求助

问题1：页面首次加载时VideoPlayerController初始化失败（assets未加载完成） #

直接在initState里调用视频播放逻辑会因为assets还在异步加载导致初始化失败，必须等assets加载完成后再触发控制器初始化。

修改方案：

• 将_playVideo()调用移到assets加载异步方法的末尾，确保assets数据已就绪
• 若用FutureBuilder渲染相册列表，仅在快照完成且有数据时初始化默认视频控制器

示例代码片段：

// Gallery.dart 中的资源加载方法
Future<void> _loadAssets() async {
  final albums = await PhotoManager.getAssetPathList(type: RequestType.video);
  final recentAlbum = albums.first;
  final assets = await recentAlbum.getAssetListPaged(page: 0, size: 50);
  setState(() {
    this.assets = assets;
  });
  // 资源加载完成后再初始化默认视频
  if (assets.isNotEmpty) {
    _playVideo(assets.first);
  }
}

@override
void initState() {
  super.initState();
  _loadAssets(); // 仅触发资源加载，不直接调用_playVideo
}

问题2：AssetThumbnail点击事件修改controller抛出LateInitializationError #

该错误源于late标记的控制器未初始化就被修改，或切换时未正确释放旧控制器。

修改方案：

• 将控制器类型改为VideoPlayerController?（允许空值），操作前判空
• 点击事件中先释放旧控制器，再初始化新控制器

示例代码片段：

// AssetThumbnail 点击事件处理
GestureDetector(
  onTap: () async {
    // 释放旧控制器
    if (_videoController != null) {
      await _videoController!.dispose();
    }
    // 初始化新控制器
    _videoController = VideoPlayerController.file(
      File(asset.filePath!),
    )..initialize().then((_) {
        setState(() {});
        _videoController!.play();
      });
    // 更新选中状态
    setState(() {
      selectedAsset = asset;
    });
  },
  child: AssetThumbnail(asset: asset),
)

问题3：VideoScreen组件切换视频时无法更新播放内容 #

VideoScreen未监听传入视频文件的变化，导致控制器未重新初始化。

修改方案：

• 使用didUpdateWidget生命周期方法，对比新旧视频文件路径，不同则重新初始化控制器
• 始终先释放旧控制器再创建新实例，避免资源泄漏

示例代码片段：

class VideoScreen extends StatefulWidget {
  final File videoFile;
  const VideoScreen({Key? key, required this.videoFile}) : super(key: key);

  @override
  State<VideoScreen> createState() => _VideoScreenState();
}

class _VideoScreenState extends State<VideoScreen> {
  VideoPlayerController? _controller;

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

  @override
  void didUpdateWidget(covariant VideoScreen oldWidget) {
    super.didUpdateWidget(oldWidget);
    // 视频文件变化时重新初始化控制器
    if (oldWidget.videoFile.path != widget.videoFile.path) {
      _initController();
    }
  }

  Future<void> _initController() async {
    // 释放旧控制器
    if (_controller != null) {
      await _controller!.dispose();
    }
    // 初始化新控制器
    _controller = VideoPlayerController.file(widget.videoFile)
      ..initialize().then((_) {
        setState(() {});
        _controller!.play();
      });
  }

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: _controller != null && _controller!.value.isInitialized
          ? VideoPlayer(_controller!)
          : const Center(child: CircularProgressIndicator()),
    );
  }
}

内容的提问来源于stack exchange，提问作者Mohammed Bekele