Flutter中如何实现视频缓存？仿Instagram视频播放缓存方案求助

1. 基于flutter_cache_manager+video_player自定义缓存逻辑 #

这是最可控的方案，绕开第三方缓存播放器的适配问题，实现边下边播+本地缓存：

• 集成flutter_cache_manager包，它支持断点续传、自动缓存文件，且可自定义缓存规则。
• 核心思路：先通过缓存管理器获取视频的本地缓存文件，存在则直接用本地路径初始化播放器；不存在则自动下载，同时支持边下边播（缓存管理器会逐步写入文件，播放器可读取已下载部分）。
• 补充：可自定义缓存目录、最大缓存容量、缓存过期时间，避免占用过多存储空间。

代码示例 #

import 'package:flutter_cache_manager/flutter_cache_manager.dart';
import 'package:video_player/video_player.dart';
import 'package:flutter/material.dart';

class CachedVideoPlayer extends StatefulWidget {
  final String videoUrl;
  const CachedVideoPlayer({super.key, required this.videoUrl});

  @override
  State<CachedVideoPlayer> createState() => _CachedVideoPlayerState();
}

class _CachedVideoPlayerState extends State<CachedVideoPlayer> {
  late VideoPlayerController _controller;
  final _customCacheManager = CacheManager(
    Config(
      'video_cache',
      stalePeriod: const Duration(days: 7), // 缓存有效期7天
      maxNrOfCacheObjects: 50, // 最多缓存50个视频文件
    ),
  );

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

  Future<void> _setupVideoController() async {
    final fileInfo = await _customCacheManager.getFile(widget.videoUrl);
    if (fileInfo?.file.existsSync() == true) {
      // 存在缓存，用本地文件初始化播放器
      _controller = VideoPlayerController.file(fileInfo!.file);
    } else {
      // 无缓存，用网络URL初始化，缓存管理器后台自动下载
      _controller = VideoPlayerController.network(widget.videoUrl);
    }
    await _controller.initialize();
    setState(() {});
  }

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

  @override
  Widget build(BuildContext context) {
    if (!_controller.value.isInitialized) {
      return const Center(child: CircularProgressIndicator());
    }
    return AspectRatio(
      aspectRatio: _controller.value.aspectRatio,
      child: VideoPlayer(_controller),
    );
  }
}

2. 排查cached_video_player/better_player的iOS适配问题 #

你在模拟器测试缓存无效，可能是以下原因：

• 模拟器缓存行为差异：iOS模拟器的文件系统缓存机制和真机不同，建议优先在真机上测试，很多插件的缓存逻辑仅在真机正常工作。
• 权限配置：确保Info.plist中添加了网络权限（如配置ATS例外允许HTTP请求），以及文件读取权限。
• 插件版本：更新插件到最新稳定版，旧版本可能存在iOS特定的缓存bug。

3. 优化列表滑动的播放器生命周期 #

即使有缓存，频繁销毁重建播放器也会影响体验，建议：

• 滑动时仅保留当前可见的3-5个播放器实例，不可见的播放器暂停并保留缓存引用，避免被系统清理。
• 使用PageView或ListView的keepAlive机制，维持播放器状态，减少重复初始化。

内容的提问来源于stack exchange，提问作者Sajjad Javadi