audio_exif 是一个用于在 Flutter 中管理音频和图片元数据的插件。它允许你读取和写入音频文件（如 MP3）和图片文件（如 JPEG）的元数据（EXIF、ID3 等）。以下是如何使用 audio_exif 插件的基本指南。

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  audio_exif: ^0.0.1  # 请检查最新版本

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

2. 导入插件

在你的 Dart 文件中导入 audio_exif 插件：

import 'package:audio_exif/audio_exif.dart';

3. 读取元数据

你可以使用 AudioExif 类来读取音频或图片文件的元数据。

读取图片元数据

Future<void> readImageMetadata() async {
  String imagePath = 'path/to/your/image.jpg';
  Map<String, dynamic> metadata = await AudioExif.readImageMetadata(imagePath);
  print('Image Metadata: $metadata');
}

读取音频元数据

Future<void> readAudioMetadata() async {
  String audioPath = 'path/to/your/audio.mp3';
  Map<String, dynamic> metadata = await AudioExif.readAudioMetadata(audioPath);
  print('Audio Metadata: $metadata');
}

4. 写入元数据

你也可以使用 AudioExif 类来写入元数据。

写入图片元数据

Future<void> writeImageMetadata() async {
  String imagePath = 'path/to/your/image.jpg';
  Map<String, dynamic> metadata = {
    'Title': 'My Image',
    'Artist': 'Flutter Developer',
    'Copyright': '2023',
  };
  await AudioExif.writeImageMetadata(imagePath, metadata);
  print('Image metadata written successfully');
}

写入音频元数据

Future<void> writeAudioMetadata() async {
  String audioPath = 'path/to/your/audio.mp3';
  Map<String, dynamic> metadata = {
    'Title': 'My Song',
    'Artist': 'Flutter Developer',
    'Album': 'Flutter Hits',
  };
  await AudioExif.writeAudioMetadata(audioPath, metadata);
  print('Audio metadata written successfully');
}

5. 处理权限

在 Android 和 iOS 上，访问文件系统可能需要权限。确保你已经在 AndroidManifest.xml 和 Info.plist 中添加了必要的权限。

Android

在 AndroidManifest.xml 中添加：

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

iOS

在 Info.plist 中添加：

<key>NSPhotoLibraryUsageDescription</key>
<string>We need access to your photo library to manage metadata.</string>

6. 错误处理

在实际使用中，可能会遇到文件不存在、权限不足等问题。确保你在代码中处理这些异常情况。

try {
  Map<String, dynamic> metadata = await AudioExif.readImageMetadata(imagePath);
  print('Image Metadata: $metadata');
} catch (e) {
  print('Failed to read metadata: $e');
}

7. 示例代码

以下是一个完整的示例，展示如何读取和写入图片和音频文件的元数据：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Audio Exif Example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: readImageMetadata,
                child: Text('Read Image Metadata'),
              ),
              ElevatedButton(
                onPressed: writeImageMetadata,
                child: Text('Write Image Metadata'),
              ),
              ElevatedButton(
                onPressed: readAudioMetadata,
                child: Text('Read Audio Metadata'),
              ),
              ElevatedButton(
                onPressed: writeAudioMetadata,
                child: Text('Write Audio Metadata'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  Future<void> readImageMetadata() async {
    String imagePath = 'path/to/your/image.jpg';
    try {
      Map<String, dynamic> metadata = await AudioExif.readImageMetadata(imagePath);
      print('Image Metadata: $metadata');
    } catch (e) {
      print('Failed to read image metadata: $e');
    }
  }

  Future<void> writeImageMetadata() async {
    String imagePath = 'path/to/your/image.jpg';
    Map<String, dynamic> metadata = {
      'Title': 'My Image',
      'Artist': 'Flutter Developer',
      'Copyright': '2023',
    };
    try {
      await AudioExif.writeImageMetadata(imagePath, metadata);
      print('Image metadata written successfully');
    } catch (e) {
      print('Failed to write image metadata: $e');
    }
  }

  Future<void> readAudioMetadata() async {
    String audioPath = 'path/to/your/audio.mp3';
    try {
      Map<String, dynamic> metadata = await AudioExif.readAudioMetadata(audioPath);
      print('Audio Metadata: $metadata');
    } catch (e) {
      print('Failed to read audio metadata: $e');
    }
  }

  Future<void> writeAudioMetadata() async {
    String audioPath = 'path/to/your/audio.mp3';
    Map<String, dynamic> metadata = {
      'Title': 'My Song',
      'Artist': 'Flutter Developer',
      'Album': 'Flutter Hits',
    };
    try {
      await AudioExif.writeAudioMetadata(audioPath, metadata);
      print('Audio metadata written successfully');
    } catch (e) {
      print('Failed to write audio metadata: $e');
    }
  }
}