Flutter视频存储查询插件video_storage_query的使用

该插件用于从手机存储中返回所有视频列表，并生成视频缩略图。

当前仅支持Android平台。

开始使用

为了确保此插件正常工作，必须授予以下权限：

• 读取媒体视频
• 读取外部存储

在你的 AndroidManifest.xml 文件中添加以下标签：

<manifest>
    <!-- Android 13或更高版本 -->
    <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

    <!-- Android 12或更低版本 -->
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
</manifest>

你可以使用 permission_handler 包来请求权限。

方法

queryVideos

此方法返回一个包含所有视频数据的 List<VideoItem> 对象列表。

List<VideoItem> videos = await VideoQuery().queryVideos();

VideoItem 类定义

class VideoItem {
  VideoItem({
    required this.name,
    required this.duration,
    required this.path,
    required this.dateAdded,
    required this.dateModified,
    required this.size,
  });

  /// 视频文件名。
  final String name;

  /// 视频时长（毫秒）。
  final String duration;

  /// 视频文件路径。
  final String path;

  /// 视频添加到存储的时间。
  final String dateAdded;

  /// 视频最后修改的时间。
  final String dateModified;

  /// 视频文件大小（字节）。
  /// 你可能需要将其转换为千字节、兆字节或吉字节。
  final String size;
}

getVideoThumbnail

此方法用于根据视频文件路径生成视频缩略图。它返回 Uint8List，你可以将其用作内存图像或转换为文件。

final bytes = await VideoStorage().getVideoThumbnail(filePath);

// 你可以这样显示图像
Image.memory(bytes);
or
Image(image: MemoryImage(bytes));

示例代码

以下是一个完整的示例代码，展示了如何使用 video_storage_query 插件获取并显示视频缩略图。

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:video_storage_query/video_storage_query.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final query = VideoStorageQuery();

  [@override](/user/override)
  void initState() {
    super.initState();
    // 请求用户存储权限
    const MethodChannel("channel").invokeMethod("initialize_permissions");
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        backgroundColor: Colors.black,
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: StreamBuilder(
          stream: query.queryVideos().asStream(),
          builder: (context, snapshot) {
            if (snapshot.connectionState == ConnectionState.waiting) {
              return const Center(child: CircularProgressIndicator());
            }

            if (snapshot.data == null) {
              return const Center(
                child: Text(
                  "错误：无法返回数据",
                  style: TextStyle(color: Colors.white),
                ),
              );
            }
            final videos = snapshot.data!;
            return GridView.builder(
              gridDelegate:
                  const SliverGridDelegateWithFixedCrossAxisCount(crossAxisCount: 3),
              itemCount: videos.length > 10 ? 10 : videos.length,
              itemBuilder: (context, index) {
                final item = videos[index];
                return Column(
                  crossAxisAlignment: CrossAxisAlignment.start,
                  children: [
                    Text(
                      item.duration,
                      style: const TextStyle(color: Colors.white),
                    ),
                    FutureBuilder<Uint8List>(
                      future: query.getVideoThumbnail(item.path),
                      builder: (context, snap) {
                        if (snap.connectionState == ConnectionState.waiting) {
                          return const CircularProgressIndicator();
                        }
                        return Image.memory(
                          snap.data!,
                          width: 75,
                          height: 75,
                          fit: BoxFit.cover,
                        );
                      },
                    )
                  ],
                );
              },
            );
          },
        ),
      ),
    );
  }
}