使用video_player的File构造器时遭遇Permission Denied问题

嘿，我之前在使用video_player插件时也碰到过类似的File构造器权限报错的情况，咱们一步步来排查解决：

1. 先确认文件路径绝对正确 #

应用文档目录的路径获取一定要准确，推荐用path_provider插件来获取标准的应用文档目录，不要手动拼接路径（不同平台的路径结构差异很大）。你可以在初始化前先打印出文件路径，确认是不是指向了正确的文件：

final directory = await getApplicationDocumentsDirectory();
final file = File('${directory.path}/your_video.mp4');
print('文件路径：${file.path}'); // 打印出来验证路径是否正确

2. 检查文件是否真的存在 #

权限拒绝有时候可能是“假报错”，实际是文件根本不存在。在初始化控制器前，一定要先判断文件是否存在：

if (await file.exists()) {
  // 初始化播放器
} else {
  print('错误：目标视频文件不存在！');
}

3. 权限配置排查（针对不同平台） #

虽然应用的私有文档目录理论上不需要额外权限，但某些平台的特殊配置可能导致权限问题：

• Android平台：
  • 如果你的视频文件是从外部存储复制到文档目录的，需要确保在AndroidManifest.xml中添加读取外部存储的权限（Android 10及以上可以用android:requestLegacyExternalStorage="true"兼容旧存储模式）：

    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <application
        android:requestLegacyExternalStorage="true"
        ...>
    </application>
    

  • Android 13及以上，如果涉及媒体文件，可能需要添加READ_MEDIA_VIDEO权限。
• iOS平台：
  • 如果视频是从相册导入到文档目录的，需要在Info.plist中添加相册访问权限描述：

    <key>NSPhotoLibraryUsageDescription</key>
    <string>需要访问相册来获取视频文件</string>
    

4. 正确的初始化代码示例 #

给你一个完整的可参考的初始化流程，包含错误处理和路径校验：

import 'package:flutter/material.dart';
import 'package:video_player/video_player.dart';
import 'package:path_provider/path_provider.dart';
import 'dart:io';

class LocalVideoPlayer extends StatefulWidget {
  @override
  _LocalVideoPlayerState createState() => _LocalVideoPlayerState();
}

class _LocalVideoPlayerState extends State<LocalVideoPlayer> {
  VideoPlayerController? _videoController;
  bool _isLoading = true;
  String? _errorMessage;

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

  Future<void> _setupLocalVideo() async {
    try {
      // 获取应用文档目录
      final docDir = await getApplicationDocumentsDirectory();
      final videoFile = File('${docDir.path}/test_video.mp4');

      // 检查文件是否存在
      if (!await videoFile.exists()) {
        setState(() {
          _errorMessage = '视频文件不存在，请先将文件放入应用文档目录';
          _isLoading = false;
        });
        return;
      }

      // 初始化播放器
      _videoController = VideoPlayerController.file(videoFile)
        ..setLooping(true)
        ..initialize().then((_) {
          setState(() {
            _isLoading = false;
            _videoController?.play();
          });
        });
    } catch (e) {
      setState(() {
        _errorMessage = '初始化播放器失败：${e.toString()}';
        _isLoading = false;
      });
    }
  }

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('本地视频测试')),
      body: Center(
        child: _isLoading
            ? const CircularProgressIndicator()
            : _errorMessage != null
                ? Text(_errorMessage!)
                : AspectRatio(
                    aspectRatio: _videoController!.value.aspectRatio,
                    child: VideoPlayer(_videoController!),
                  ),
      ),
    );
  }
}

额外提示 #

如果你的视频文件是从Asset资源复制到文档目录的，一定要确保复制过程没有出错，比如用rootBundle读取Asset后完整写入文件，避免文件损坏导致的权限类报错（其实是文件无法解析，但系统可能返回权限错误）。

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