Flutter媒体存储管理插件media_store_plus的使用

media_store_plus简介

media_store_plus 插件用于在Flutter中使用Android MediaStore API，支持所有Android版本的读写操作，并根据需要请求适当的权限。从API级别30开始，必须使用Scoped Storage来写文件；而从API级别33开始，读取文件也需要遵循这一规则。

动机

• API 30+: 必须使用Scoped Storage进行文件写入。
• API 32及以下: 可以通过直接路径读取文件。
• API 33及以上: 需要使用Scoped Storage进行读取，并引入了特定的权限（如READ_MEDIA_IMAGES, READ_MEDIA_AUDIO, READ_MEDIA_VIDEO）来访问图片、音频和视频文件。

由于这些限制，在Flutter中直接使用MediaStore API变得复杂，因此创建了media_store_plus插件来简化这些操作。

使用方法

添加依赖

首先，在pubspec.yaml文件中添加media_store_plus依赖：

dependencies:
  media_store_plus: ^0.1.3

然后运行flutter pub get以获取依赖包。

Android配置

编辑AndroidManifest.xml文件，添加必要的权限声明：

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

<uses-permission
    android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />

<uses-permission
    android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="29" />

<application
    ...
    android:requestLegacyExternalStorage="true">
</application>

此外，根据GSON的要求修改proguard-rules.pro文件。

示例代码

下面是一个完整的示例应用程序，展示了如何使用media_store_plus插件进行文件的保存和读取操作：

import 'dart:async';
import 'dart:io';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:media_store_plus/media_store_plus.dart';
import 'package:permission_handler/permission_handler.dart';

final mediaStorePlugin = MediaStore();

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  if (Platform.isAndroid) {
    await MediaStore.ensureInitialized();
  }

  List<Permission> permissions = [Permission.storage];

  if ((await mediaStorePlugin.getPlatformSDKInt()) >= 33) {
    permissions.addAll([Permission.photos, Permission.audio, Permission.videos]);
  }

  await permissions.request();

  MediaStore.appFolder = "MediaStorePlugin";

  runApp(
    MaterialApp(
      theme: ThemeData(primarySwatch: Colors.teal),
      home: const MyApp(),
    ),
  );
}

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  int _platformSDKVersion = 0;

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

  Future<void> initPlatformState() async {
    try {
      _platformSDKVersion = await mediaStorePlugin.getPlatformSDKInt();
    } on PlatformException {
      _platformSDKVersion = -1;
    }

    if (!mounted) return;

    setState(() {
      _platformSDKVersion = _platformSDKVersion;
    });

    print(await mediaStorePlugin.getFilePathFromUri(
        uriString: 'content://media/external/images/media/1000000056'));
    print(await mediaStorePlugin.getFilePathFromUri(
        uriString: 'content://media/external_primary/images/media/1000000057'));
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('media_store_plus_example'),
      ),
      body: Center(
        child: Column(
          mainAxisSize: MainAxisSize.max,
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text.rich(
              TextSpan(text: 'Running on: ', children: [
                TextSpan(
                    text: _platformSDKVersion.toString(),
                    style: const TextStyle(fontWeight: FontWeight.bold)),
              ]),
            ),
            const SizedBox(height: 10),
            const Text(
              'Save file in...',
              style: TextStyle(fontWeight: FontWeight.bold, fontSize: 20),
            ),
            const SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                // Navigate to ImageSaveScreen
              },
              child: const Text("Image Folder"),
            ),
            ElevatedButton(
              onPressed: () {
                // Navigate to AudioSaveScreen
              },
              child: const Text("Audio Folder"),
            ),
            ElevatedButton(
              onPressed: () {
                // Navigate to VideoSaveScreen
              },
              child: const Text("Video Folder"),
            ),
            ElevatedButton(
              onPressed: () {
                // Navigate to Download folder screen
              },
              child: const Text("Download Folder"),
            ),
            ElevatedButton(
              onPressed: () {
                // Navigate to ReadWriteScreenAPI33OrUp
              },
              child: const Text("Read/Write API 33 or Upper Folder"),
            ),
          ],
        ),
      ),
    );
  }
}

此示例代码包括了初始化插件、请求必要权限、设置应用专属文件夹以及展示当前设备的API级别等基本功能。每个按钮点击后可以导航到不同的页面，实现对不同类型的媒体文件（图像、音频、视频）的保存和读取操作。

更多信息

更多详细文档请参阅官方文档。此外，查看插件源码也能帮助理解其工作原理。如果您有任何问题或建议，欢迎通过GitHub Issues提交反馈。