Flutter音频标签解析插件taglib_ffi的使用

仅在MacOS上构建/测试！

目前，该插件仅在MacOS上构建和测试。

支持格式：

• MP3
• FLAC
• MP4 (也称为M4A，也称为ALAC)

支持的功能：

• 读取/更新/删除标签（见下文）
• 读取/更新/删除封面艺术
• 读取/更新/删除歌词

依赖项

MacOS

brew install cmake
brew install taglib

设置

MacOS

需要定义HOMEBREW_PREFIX变量：

export HOMEBREW_PREFIX="$(brew --prefix)" 

使用

将插件添加到pubspec.yaml依赖项中。

读取/写入标签：

TagLib tagLib = TagLib();
Tags tags = tagLib.getAudioTags(filename);
if (tags.valid) {
  // 处理标签
}
// 更新标签
tagLib.setAudioTag(filename, tags);

显示封面艺术：

TagLib tagLib = TagLib();
FutureBuilder(
  future: tagLib.getArtworkBytes(filename),
  builder: (_, snapshot) => Image.memory(snapshot.data)
)

读取/写入歌词：

TagLib tagLib = TagLib();
String lyrics = tagLib.getLyrics(filename);
// 更新歌词
tagLib.setLyrics(filename, lyrics);

支持的标签

• 标题
• 专辑
• 艺术家（专辑艺术家）
• 表演者
• 作曲者
• 风格
• 版权
• 注释
• 年份
• 合辑
• 卷/专辑编号
• 卷/专辑数量
• 轨道编号
• 轨道数量

示例代码

以下是完整的示例代码，展示了如何使用taglib_ffi插件来读取和显示文件的音频标签和封面艺术。

import 'package:file_picker/file_picker.dart';
import 'package:flutter/material.dart';
import 'package:taglib_ffi/taglib_ffi.dart';

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

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

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

class _MyAppState extends State<MyApp> {
  final TagLib _tagLib = TagLib();
  String? _filename;
  Tags? _tags;

  [@override](/user/override)
  void initState() {
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('TagLib FFI'),
        ),
        body: SingleChildScrollView(
          child: Container(
            width: double.infinity,
            padding: const EdgeInsets.all(10),
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.center,
              children: [
                ElevatedButton(
                    child: const Text('选择一个文件...'),
                    onPressed: () async {
                      FilePickerResult? result = await FilePicker.platform.pickFiles();
                      if (result != null) {
                        setState(() {
                          _filename = result.files.single.path;
                          _tags = _tagLib.getAudioTags(_filename!);
                        });
                      }
                    }),
                if (_filename != null) ...[
                  const SizedBox(height: 32),
                  Text(
                    _filename!,
                    style: const TextStyle(fontWeight: FontWeight.bold),
                  ),
                  const SizedBox(height: 16),
                  FutureBuilder(
                      future: _tagLib.getArtworkBytes(_filename!),
                      builder: (context, snapshot) {
                        if (snapshot.hasData && snapshot.data != null) {
                          return Container(
                            margin: const EdgeInsets.only(bottom: 16),
                            child: Image.memory(
                              snapshot.data!,
                              height: 64,
                            ),
                          );
                        } else {
                          return Container();
                        }
                      }),
                  if (_tags != null) ...[
                    if (!_tags!.valid)
                      const Text('无标签')
                    else ...[
                      Text('标题: ${_tags!.title}'),
                      Text('专辑: ${_tags!.album}'),
                      Text('艺术家: ${_tags!.artist}'),
                      Text('表演者: ${_tags!.performer}'),
                      Text('作曲者: ${_tags!.composer}'),
                      Text('风格: ${_tags!.genre}'),
                      Text('版权: ${_tags!.copyright}'),
                      Text('注释: ${_tags!.comment}'),
                      Text('年份: ${_tags!.year}'),
                      Text('合辑: ${_tags!.compilation}'),
                      Text('卷: ${_tags!.volumeIndex} / ${_tags!.volumeCount}'),
                      Text('轨道: ${_tags!.trackIndex} / ${_tags!.trackCount}'),
                      Text('时长: ${_tags!.duration}'),
                      Text('声道数: ${_tags!.numChannels}'),
                      Text('采样率: ${_tags!.sampleRate}'),
                      Text('每样本位数: ${_tags!.bitsPerSample}'),
                      Text('比特率: ${_tags!.bitrate}'),
                    ],
                  ],
                ],
              ],
            ),
          ),
        ),
      ),
    );
  }
}