Rust音频元数据处理库moosicbox_lofty_attr的使用

安装

在你的项目目录中运行以下Cargo命令：

cargo add moosicbox_lofty_attr

或者在Cargo.toml中添加以下行：

moosicbox_lofty_attr = "0.1.0"

示例代码

以下是使用moosicbox_lofty_attr处理音频文件元数据的完整示例：

use moosicbox_lofty_attr::LoftyAttr;
use lofty::{AudioFile, TaggedFileExt};

// 定义音频元数据结构体，使用LoftyAttr派生宏
#[derive(LoftyAttr)]
struct AudioMetadata {
    title: String,
    artist: String,
    album: String,
    year: Option<u32>,
    track_number: Option<u32>,
    genre: Option<String>,
}

fn main() {
    // 读取音频文件
    let path = "example.mp3";
    let tagged_file = lofty::read_from_path(path).expect("Failed to read file");
    
    // 提取元数据到自定义结构体
    let metadata: AudioMetadata = tagged_file.into();
    
    // 打印元数据信息
    println!("音频元数据:");
    println!("标题: {}", metadata.title);
    println!("艺术家: {}", metadata.artist);
    println!("专辑: {}", metadata.album);
    
    if let Some(year) = metadata.year {
        println!("年份: {}", year);
    }
    
    if let Some(track) = metadata.track_number {
        println!("音轨号: {}", track);
    }
    
    if let Some(genre) = metadata.genre {
        println!("流派: {}", genre);
    }
    
    // 修改并保存元数据
    let mut tagged_file = lofty::read_from_path(path).expect("Failed to read file");
    tagged_file.set_title("新标题");
    tagged_file.set_artist("新艺术家");
    
    tagged_file.save_to_path(path).expect("Failed to save changes");
}

完整示例代码扩展

以下是一个更完整的示例，展示如何处理多个音频文件并添加更多元数据字段：

use moosicbox_lofty_attr::LoftyAttr;
use lofty::{AudioFile, TaggedFileExt};
use std::path::PathBuf;

// 扩展元数据结构体
#[derive(LoftyAttr, Debug)]
struct EnhancedAudioMetadata {
    title: String,
    artist: String,
    album: String,
    year: Option<u32>,
    track_number: Option<u32>,
    track_total: Option<u32>,
    genre: Option<String>,
    comment: Option<String>,
    composer: Option<String>,
    duration: Option<u32>, // 以秒为单位
}

fn process_audio_file(path: &str) -> anyhow::Result<()> {
    // 读取音频文件
    let tagged_file = lofty::read_from_path(path)?;
    
    // 提取元数据到增强结构体
    let metadata: EnhancedAudioMetadata = tagged_file.into();
    
    println!("处理文件: {}", path);
    println!("{:#?}", metadata);
    
    // 修改元数据
    let mut tagged_file = lofty::read_from_path(path)?;
    
    // 更新部分字段
    tagged_file.set_album(format!("{} (Remastered)", metadata.album));
    tagged_file.set_comment("Processed by moosicbox_lofty_attr".to_string());
    
    // 保存更改
    tagged_file.save_to_path(path)?;
    println!("文件 {} 的元数据已更新", path);
    
    Ok(())
}

fn main() -> anyhow::Result<()> {
    let audio_files = vec![
        "song1.mp3",
        "song2.flac",
        "song3.ogg",
    ];
    
    for file in audio_files {
        if let Err(e) = process_audio_file(file) {
            eprintln!("处理文件 {} 时出错: {}", file, e);
        }
    }
    
    Ok(())
}

功能说明

1. 支持多种音频格式的元数据解析，包括MP3、FLAC、OGG等
2. 提供宏支持简化元数据结构的定义和处理
3. 可读写ID3标签和其他音频元数据
4. 支持常见元数据字段如标题、艺术家、专辑、年份等
5. 支持可选字段处理，如音轨号、流派、评论等

许可证

本crate采用MIT或Apache-2.0许可证。