Flutter音频标签处理插件audiotags的使用

AudioTags 是一个用于在Flutter应用中读取和写入音频元数据的插件，支持多种音频格式。本文将介绍如何使用该插件，并提供一个完整的示例。

使用方法

读取音频标签

要读取音频文件的元数据，可以使用 AudioTags.read(path) 方法。下面是一个简单的例子：

import 'package:audiotags/audiotags.dart';

// 假设我们有一个音频文件路径
String path = "path/to/audio/file.mp3";

// 读取音频标签
Tag? tag = await AudioTags.read(path);

if (tag != null) {
    String? title = tag.title;
    String? trackArtist = tag.trackArtist;
    String? album = tag.album;
    String? albumArtist = tag.albumArtist;
    String? genre = tag.genre;
    int? year = tag.year;
    int? trackNumber = tag.trackNumber;
    int? trackTotal = tag.trackTotal;
    int? discNumber = tag.discNumber;
    int? discTotal = tag.discTotal;
    int? duration = tag.duration;
    List<Picture>? pictures = tag.pictures;

    print("Title: $title");
    print("Track Artist: $trackArtist");
    print("Album: $album");
    print("Album Artist: $albumArtist");
    print("Genre: $genre");
    print("Year: $year");
    print("Track Number: $trackNumber");
    print("Track Total: $trackTotal");
    print("Disc Number: $discNumber");
    print("Disc Total: $discTotal");
    print("Duration: $duration");
    print("Pictures: $pictures");
}

写入音频标签

要写入音频文件的元数据，可以使用 AudioTags.write(path, tag) 方法。以下是如何创建并写入一个新的 Tag 对象的例子：

import 'package:audiotags/audiotags.dart';

// 创建一个新的Tag对象
Tag tag = Tag(
    title: "Title",
    trackArtist: "Track Artist",
    album: "Album",
    albumArtist: "Album Artist",
    genre: "Genre",
    year: 2000,
    trackNumber: 1,
    trackTotal: 2,
    discNumber: 1,
    discTotal: 3,
    pictures: [
        Picture(
            bytes: Uint8List.fromList([0, 0, 0, 0]),
            mimeType: null,
            pictureType: PictureType.other
        )
    ]
);

// 假设我们有一个音频文件路径
String path = "path/to/audio/file.mp3";

// 写入音频标签
await AudioTags.write(path, tag);

支持的格式

该插件依赖于Rust库 lofty 来读取和写入元数据。支持的音频格式列表可以在 这里 查看。

完整示例 Demo

以下是完整的示例代码，包含用户界面、选择文件、读取和写入功能：

import 'dart:io';
import 'package:file_picker/file_picker.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:audiotags/audiotags.dart';
import 'package:permission_handler/permission_handler.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const MyApp());
}

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

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

class _MyAppState extends State<MyApp> {
  String path = "";

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('AudioTags Example'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                child: const Text("Open"),
                onPressed: () async {
                  if (Platform.isAndroid || Platform.isIOS) {
                    await Permission.storage.request();
                  }
                  FilePickerResult? r = await FilePicker.platform.pickFiles();
                  if (r != null) path = r.files.single.path!;
                },
              ),
              const SizedBox(height: 10),
              ElevatedButton(
                child: const Text("Write"),
                onPressed: () async {
                  Tag tag = Tag(
                      title: "Title",
                      trackArtist: "Track Artist",
                      album: "Album",
                      albumArtist: "Album Artist",
                      genre: "Genre",
                      year: 2000,
                      trackNumber: 1,
                      trackTotal: 2,
                      discNumber: 1,
                      discTotal: 3,
                      pictures: [
                        Picture(
                            bytes: Uint8List.fromList([0, 0, 0, 0]),
                            mimeType: null,
                            pictureType: PictureType.other)
                      ]);
                  await AudioTags.write(path, tag);
                },
              ),
              const SizedBox(height: 10),
              ElevatedButton(
                child: const Text("Read"),
                onPressed: () async {
                  Tag? tag = await AudioTags.read(path);
                  if (tag != null) {
                    debugPrint("Title: ${tag.title}");
                    debugPrint("Track Artist: ${tag.trackArtist}");
                    debugPrint("Album: ${tag.album}");
                    debugPrint("Album Artist: ${tag.albumArtist}");
                    debugPrint("Genre: ${tag.genre}");
                    debugPrint("Year: ${tag.year}");
                    debugPrint("Track Number: ${tag.trackNumber}");
                    debugPrint("Track Total: ${tag.trackTotal}");
                    debugPrint("Disc Number: ${tag.discNumber}");
                    debugPrint("Disc Total: ${tag.discTotal}");
                    debugPrint("Duration: ${tag.duration}");
                    debugPrint("Pictures: ${tag.pictures}");
                  }
                },
              ),
            ],
          ),
        ),
      ),
    );
  }
}

这个示例展示了如何在Flutter应用中使用 audiotags 插件来处理音频文件的元数据。通过这种方式，你可以轻松地在你的应用程序中添加对音频文件的支持。