Flutter缓存视频iOS无法播放问题排查及自定义扩展名需求

我用Flutter开发应用，通过flutter_cache_manager缓存视频，缓存文件默认以.bin格式存储。将缓存视频路径传入播放器时，Android端可正常运行，但iOS端无法完成初始化。以下是我的缓存类和视频初始化代码：

缓存类代码 #

class video_caching_config {

  Future<String> initVideo(String url) async {
    try {
      final cacheManager = CacheManager(Config("video_cache", stalePeriod: const Duration(days: 2, hours: 6,), maxNrOfCacheObjects: 100, fileService: LongCacheHttpFileService(),),);
      final _file = await cacheManager.getFileFromCache("${url}");

      if(_file != null) {
        print("Exists");
        print("${_file.file.path}");
        return _file.file.path;
      } else {
        print("Doesn't Exist!");
        final _nFile = await CacheManager(Config("video_cache", stalePeriod: const Duration(days: 2, hours: 6,), maxNrOfCacheObjects: 100, fileService: LongCacheHttpFileService(),),).getSingleFile(url, key: "${url}");
        print("${_nFile.path}");
        return _nFile.path;
      }
    } catch (e) {
      print("Video Caching Config: ${e}");
      return "Error Occurred! Please Try Again!";
    }
  }
}

class LongCacheHttpFileService extends HttpFileService {
  final http.Client _httpClient;

  LongCacheHttpFileService({http.Client? httpClient})
      : _httpClient = httpClient ?? http.Client();

  @override
  Future<FileServiceResponse> get(String url, {Map<String, String>? headers}) async {
    final req = http.Request('GET', Uri.parse(url));
    req.headers.addAll(headers ?? {});

    final httpResponse = await _httpClient.send(req);
    final headersWithCacheControl = Map<String, String>.from(httpResponse.headers);
    headersWithCacheControl['cache-control'] = 'max-age=${const Duration(days: 10).inSeconds}';

    final responseWithUpdatedHeaders = http.StreamedResponse(
      httpResponse.stream,
      httpResponse.statusCode,
      headers: headersWithCacheControl,
      contentLength: httpResponse.contentLength,
      request: httpResponse.request,
    );

    return HttpGetResponse(responseWithUpdatedHeaders);
  }
}

视频初始化代码 #

String videoPath = await video_caching_config().initVideo(_lVideoUrl);
_lVideoPath = videoPath;
var controller = VideoPlayerController.network(videoPath);
_videoController = controller;
if(mounted) {
  controller.initialize().then((_) {
    controller.addListener(_onControllerUpdate);
    if(mounted) {
      setState1(() {
        isVidInit = true;
      });
    }
  });
}

想问：哪里操作有误？如何适配iOS？怎么给缓存视频设置自定义扩展名？

1. iOS无法初始化的原因及修复 #

核心问题 #

• iOS视频播放器对文件扩展名校验严格，.bin格式会被判定为非视频文件，导致初始化失败。
• 错误使用VideoPlayerController.network()加载本地文件路径——该构造函数仅用于网络URL，本地文件需用VideoPlayerController.file()。

修复代码 #

修改视频初始化逻辑，替换播放器构造函数并添加错误捕获：

String videoPath = await video_caching_config().initVideo(_lVideoUrl);
_lVideoPath = videoPath;
// 改用File构造加载本地缓存文件
var controller = VideoPlayerController.file(File(videoPath));
_videoController = controller;
if(mounted) {
  controller.initialize().then((_) {
    controller.addListener(_onControllerUpdate);
    if(mounted) {
      setState1(() {
        isVidInit = true;
      });
    }
  }).catchError((error) {
    print("视频初始化失败: $error");
  });
}

2. 设置缓存视频自定义扩展名 #

flutter_cache_manager默认生成.bin后缀，需重写缓存管理器的文件路径生成逻辑，保留原视频扩展名：

步骤1：自定义CacheManager单例 #

class CustomVideoCacheManager extends CacheManager {
  static const key = 'video_cache';
  static CustomVideoCacheManager? _instance;

  factory CustomVideoCacheManager() {
    _instance ??= CustomVideoCacheManager._();
    return _instance!;
  }

  CustomVideoCacheManager._() : super(
    Config(
      key,
      stalePeriod: const Duration(days: 2, hours: 6),
      maxNrOfCacheObjects: 100,
      fileService: LongCacheHttpFileService(),
    ),
  );

  // 重写文件路径生成逻辑，替换默认.bin为原视频扩展名
  @override
  Future<String> getFilePath(String url, {String? key}) async {
    final originalFileName = Uri.parse(url).pathSegments.last;
    final fileExtension = originalFileName.split('.').last;
    final cachePath = await getFilePathFromKey(key ?? url);
    return cachePath.replaceAll('.bin', '.$fileExtension');
  }
}

步骤2：修改缓存类代码 #

替换原CacheManager为自定义单例，避免重复创建实例：

class VideoCachingConfig {

  Future<String> initVideo(String url) async {
    try {
      final cacheManager = CustomVideoCacheManager();
      final cachedFile = await cacheManager.getFileFromCache(url);

      if(cachedFile != null) {
        print("缓存已存在: ${cachedFile.file.path}");
        return cachedFile.file.path;
      } else {
        print("缓存不存在，开始下载");
        final newFile = await cacheManager.getSingleFile(url, key: url);
        print("下载完成: ${newFile.path}");
        return newFile.path;
      }
    } catch (e) {
      print("视频缓存出错: ${e}");
      return "Error Occurred! Please Try Again!";
    }
  }
}

3. 额外优化点 #

• 避免重复创建CacheManager实例：原代码每次调用initVideo都新建实例，会导致缓存管理混乱，单例模式可解决此问题。
• 添加错误捕获：在初始化逻辑中加入catchError，方便排查iOS端的具体错误。

内容的提问来源于stack exchange，提问作者Uraam Asif