media_gallery2 是一个 Flutter 插件，用于访问和管理设备上的媒体库（照片、视频等）。它允许你从设备的相册中获取媒体文件，并在 Flutter 应用程序中显示它们。以下是如何使用 media_gallery2 插件的步骤：

1. 添加依赖

首先，在你的 pubspec.yaml 文件中添加 media_gallery2 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  media_gallery2: ^0.1.0 # 请检查最新版本

然后运行 flutter pub get 来安装依赖。

2. 请求权限

在访问设备的媒体库之前，你需要请求相应的权限。通常需要 READ_EXTERNAL_STORAGE 权限。你可以使用 permission_handler 插件来请求权限。

首先，添加 permission_handler 插件的依赖：

dependencies:
  permission_handler: ^10.0.0 # 请检查最新版本

然后，在代码中请求权限：

import 'package:permission_handler/permission_handler.dart';

Future<void> requestPermissions() async {
  if (await Permission.storage.request().isGranted) {
    // 权限已授予
  } else {
    // 权限被拒绝
  }
}

3. 初始化 MediaGallery

在获取权限后，你可以初始化 MediaGallery 并开始获取媒体文件。

import 'package:media_gallery2/media_gallery2.dart';

Future<void> initMediaGallery() async {
  await MediaGallery.initialize();
}

4. 获取相册列表

你可以使用 MediaGallery.listAlbums 方法来获取设备上的相册列表。

Future<List<Album>> getAlbums() async {
  return await MediaGallery.listAlbums();
}

5. 获取相册中的媒体文件

你可以使用 MediaGallery.listMedia 方法来获取特定相册中的媒体文件。

Future<List<Media>> getMedia(Album album) async {
  return await MediaGallery.listMedia(album: album);
}

6. 显示媒体文件

你可以使用 MediaPage 来显示媒体文件的内容。例如，显示图片：

import 'package:flutter/material.dart';
import 'package:media_gallery2/media_gallery2.dart';

class MediaPage extends StatelessWidget {
  final Media media;

  MediaPage({required this.media});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Media'),
      ),
      body: Center(
        child: FutureBuilder<MediaFile>(
          future: media.getFile(),
          builder: (context, snapshot) {
            if (snapshot.connectionState == ConnectionState.done) {
              if (snapshot.hasData) {
                return Image.file(snapshot.data!.file);
              } else {
                return Text('Failed to load media');
              }
            } else {
              return CircularProgressIndicator();
            }
          },
        ),
      ),
    );
  }
}

7. 完整示例

以下是一个完整的示例，展示了如何使用 media_gallery2 插件来获取并显示设备相册中的图片：

import 'package:flutter/material.dart';
import 'package:media_gallery2/media_gallery2.dart';
import 'package:permission_handler/permission_handler.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await requestPermissions();
  await MediaGallery.initialize();
  runApp(MyApp());
}

Future<void> requestPermissions() async {
  if (await Permission.storage.request().isGranted) {
    print('Permission granted');
  } else {
    print('Permission denied');
  }
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Media Gallery Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MediaGalleryScreen(),
    );
  }
}

class MediaGalleryScreen extends StatefulWidget {
  @override
  _MediaGalleryScreenState createState() => _MediaGalleryScreenState();
}

class _MediaGalleryScreenState extends State<MediaGalleryScreen> {
  List<Album> albums = [];
  List<Media> media = [];

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

  Future<void> _loadAlbums() async {
    albums = await MediaGallery.listAlbums();
    if (albums.isNotEmpty) {
      _loadMedia(albums.first);
    }
    setState(() {});
  }

  Future<void> _loadMedia(Album album) async {
    media = await MediaGallery.listMedia(album: album);
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Media Gallery'),
      ),
      body: Column(
        children: [
          DropdownButton<Album>(
            value: albums.isNotEmpty ? albums.first : null,
            onChanged: (Album? album) {
              if (album != null) {
                _loadMedia(album);
              }
            },
            items: albums.map<DropdownMenuItem<Album>>((Album album) {
              return DropdownMenuItem<Album>(
                value: album,
                child: Text(album.name),
              );
            }).toList(),
          ),
          Expanded(
            child: GridView.builder(
              gridDelegate: SliverGridDelegateWithFixedCrossAxisCount(
                crossAxisCount: 3,
              ),
              itemCount: media.length,
              itemBuilder: (context, index) {
                return GestureDetector(
                  onTap: () {
                    Navigator.push(
                      context,
                      MaterialPageRoute(
                        builder: (context) => MediaPage(media: media[index]),
                      ),
                    );
                  },
                  child: FutureBuilder<MediaFile>(
                    future: media[index].getFile(),
                    builder: (context, snapshot) {
                      if (snapshot.connectionState == ConnectionState.done) {
                        if (snapshot.hasData) {
                          return Image.file(
                            snapshot.data!.file,
                            fit: BoxFit.cover,
                          );
                        } else {
                          return Center(child: Text('Failed to load media'));
                        }
                      } else {
                        return Center(child: CircularProgressIndicator());
                      }
                    },
                  ),
                );
              },
            ),
          ),
        ],
      ),
    );
  }
}

class MediaPage extends StatelessWidget {
  final Media media;

  MediaPage({required this.media});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Media'),
      ),
      body: Center(
        child: FutureBuilder<MediaFile>(
          future: media.getFile(),
          builder: (context, snapshot) {
            if (snapshot.connectionState == ConnectionState.done) {
              if (snapshot.hasData) {
                return Image.file(snapshot.data!.file);
              } else {
                return Text('Failed to load media');
              }
            } else {
              return CircularProgressIndicator();
            }
          },
        ),
      ),
    );
  }
}

8. 注意事项

• 确保在 AndroidManifest.xml 文件中添加了必要的权限：

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

• 在 iOS 上，你需要在 Info.plist 文件中添加相应的权限描述：

  <key>NSPhotoLibraryUsageDescription</key>
  <string>We need access to your photo library to display your photos.</string>