Flutter图片相册管理插件album_image的使用

Album Image 是基于 photo_manager 插件开发的，其概念与 image_picker 类似，但提供了更吸引人的界面来从设备的相册（无论是 Android 还是 iOS）中选择图片或视频。

功能特性

• [✓] 选择图片
• [✓] 选择视频
• [✓] 多选图片/视频
• [❌] 无法直接从相机拍摄图片或视频

示例图片

安装

1. 该插件仅在 Android 平台上测试过，请在 pubspec.yaml 文件中添加以下依赖：

   album_image: 0.0.1
   

2. 导入插件：

   import 'package:album_image/album_image.dart';
   

使用步骤

Android

在 AndroidManifest.xml 文件中添加读取外部存储权限：

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

iOS

在 Info.plist 文件中添加以下配置：

<key>NSPhotoLibraryUsageDescription</key>
<string>Privacy - Photo Library Usage Description</string>
<key>NSMotionUsageDescription</key>
<string>Motion usage description</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>NSPhotoLibraryAddUsageDescription</string>

示例代码

以下是一个完整的示例代码，展示如何使用 album_image 插件来选择图片：

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

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

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

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Builder(builder: (context) {
          // 计算缩略图的质量
          final thumbnailQuality = MediaQuery.of(context).size.width ~/ 3;

          return AlbumImagePicker(
            // 选择回调
            onSelected: (items) {
              print('Selected items: $items');
            },
            // 自定义选择图标
            selectionBuilder: (_, selected, index) {
              if (selected) {
                return Container(
                  decoration: BoxDecoration(
                    border: Border.all(),
                  ),
                );
              }
              return Container();
            },
            // 每行显示的列数
            crossAxisCount: 3,
            // 最大选择数量
            maxSelection: 4,
            // 达到最大选择时的回调
            onSelectedMax: () {
              print('达到最大选择数量');
            },
            // 相册背景颜色
            albumBackGroundColor: Colors.white,
            // 应用栏高度
            appBarHeight: 45,
            // 每个项目的背景颜色
            itemBackgroundColor: Colors.grey[100]!,
            // 应用栏颜色
            appBarColor: Colors.white,
            // 相册标题样式
            albumTextStyle: const TextStyle(color: Colors.black, fontSize: 14),
            // 相册子标题样式
            albumSubTextStyle: const TextStyle(color: Colors.grey, fontSize: 10),
            // 选择类型（图片或视频）
            type: AlbumType.image,
            // 关闭按钮
            closeWidget: const BackButton(
              color: Colors.black,
            ),
            // 缩略图质量
            thumbnailQuality: thumbnailQuality * 3,
          );
        }),
      ),
    );
  }
}