Rust MP4元数据处理库mp4ameta_proc的使用：高效解析和操作MP4音频文件元数据

安装

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

cargo add mp4ameta_proc

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

mp4ameta_proc = "0.6.0"

使用示例

以下是使用mp4ameta_proc库解析和操作MP4音频文件元数据的完整示例：

use mp4ameta_proc::{Tag, Data};
use std::fs::File;
use std::io::BufReader;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 打开MP4文件
    let file = File::open("audio.mp4")?;
    let mut reader = BufReader::new(file);

    // 读取元数据标签
    let tag = Tag::read_from(&mut reader)?;

    // 打印所有元数据
    println!("MP4文件元数据:");
    for data in tag.data() {
        match data {
            Data::Album(album) => println!("专辑: {}", album),
            Data::Artist(artist) => println!("艺术家: {}", artist),
            Data::Title(title) => println!("标题: {}", title),
            Data::Genre(genre) => println!("流派: {}", genre),
            Data::TrackNumber(track) => println!("音轨号: {}", track),
            Data::DiscNumber(disc) => println!("光盘号: {}", disc),
            Data::Year(year) => println!("年份: {}", year),
            Data::Comment(comment) => println!("注释: {}", comment),
            Data::CoverArt { data, format } => {
                println!("封面艺术: {}格式, {}字节", format, data.len())
            }
            _ => {} // 其他元数据类型
        }
    }

    // 修改元数据
    let mut tag = tag;
    tag.set_title("新标题");
    tag.set_artist("新艺术家");
    tag.set_album("新专辑");

    // 将修改后的元数据写回文件
    let file = File::create("audio_modified.mp4")?;
    let mut writer = BufReader::new(file);
    tag.write_to(&mut writer)?;

    Ok(())
}

完整示例代码

以下是一个更完整的示例，展示了如何批量处理MP4文件的元数据：

use mp4ameta_proc::{Tag, Data};
use std::fs::{self, File};
use std::io::{BufReader, BufWriter};
use std::path::Path;

// 处理单个MP4文件的元数据
fn process_mp4_metadata(file_path: &str) -> Result<(), Box<dyn std::error::Error>> {
    // 打开文件
    let file = File::open(file_path)?;
    let mut reader = BufReader::new(file);
    
    // 读取元数据
    let tag = Tag::read_from(&mut reader)?;
    
    // 打印文件基本信息
    println!("\n处理文件: {}", file_path);
    println!("包含的元数据类型:");
    
    // 统计各类元数据的数量
    let mut metadata_count = 0;
    for data in tag.data() {
        match data {
            Data::Album(_) => println!("- 专辑信息"),
            Data::Artist(_) => println!("- 艺术家信息"),
            Data::Title(_) => println!("- 标题信息"),
            Data::Genre(_) => println!("- 流派信息"),
            Data::TrackNumber(_) => println!("- 音轨号"),
            Data::DiscNumber(_) => println!("- 光盘号"),
            Data::Year(_) => println!("- 年份信息"),
            Data::Comment(_) => println!("- 注释信息"),
            Data::CoverArt { .. } => println!("- 封面图片"),
            _ => println!("- 其他元数据类型"),
        }
        metadata_count += 1;
    }
    
    println!("共找到 {} 个元数据项", metadata_count);
    
    // 创建修改后的文件
    let modified_path = Path::new(file_path)
        .with_file_name("modified_audio.mp4");
    
    // 修改并写入元数据
    let mut tag = tag;
    tag.set_title("修改后的标题");
    tag.set_artist("修改后的艺术家");
    
    let output_file = File::create(modified_path)?;
    let mut writer = BufWriter::new(output_file);
    tag.write_to(&mut writer)?;
    
    println!("已创建修改后的文件: {:?}", modified_path);
    
    Ok(())
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 示例：处理当前目录下的MP4文件
    let dir_entries = fs::read_dir(".")?;
    
    for entry in dir_entries {
        let entry = entry?;
        let path = entry.path();
        
        if path.extension().map_or(false, |ext| ext == "mp4") {
            if let Some(file_name) = path.to_str() {
                process_mp4_metadata(file_name)?;
            }
        }
    }
    
    Ok(())
}

功能说明

1. 读取MP4元数据：Tag::read_from方法可以从MP4文件中读取所有元数据
2. 访问元数据：通过tag.data()可以遍历所有元数据项
3. 修改元数据：提供set_*系列方法来修改各种元数据
4. 写入元数据：write_to方法将修改后的元数据写回文件

支持的元数据类型

• 标题(title)
• 艺术家(artist)
• 专辑(album)
• 流派(genre)
• 音轨号(track number)
• 光盘号(disc number)
• 年份(year)
• 注释(comment)
• 封面艺术(cover art)

许可证

该库采用MIT或Apache-2.0双重许可证。