Rust MP3编码库mp3lame-encoder的使用，高性能音频编码与LAME MP3格式转换

示例代码

use mp3lame_encoder::{Builder, Id3Tag, DualPcm, FlushNoGap};

// 创建LAME编码器构建器
let mut mp3_encoder = Builder::new().expect("Create LAME builder");
// 设置双声道
mp3_encoder.set_num_channels(2).expect("set channels");
// 设置采样率44.1kHz
mp3_encoder.set_sample_rate(44_100).expect("set sample rate");
// 设置比特率192kbps
mp3_encoder.set_brate(mp3lame_encoder::Bitrate::Kbps192).expect("set brate");
// 设置最高编码质量
mp3_encoder.set_quality(mp3lame_encoder::Quality::Best).expect("set quality");
// 设置ID3标签
mp3_encoder.set_id3_tag(Id3Tag {
    title: b"My title",
    artist: &[],
    album: b"My album",
    year: b"Current year",
    comment: b"Just my comment",
});
// 构建编码器
let mut mp3_encoder = mp3_encoder.build().expect("To initialize LAME encoder");

// 准备PCM音频数据(这里使用静音示例)
let input = DualPcm {
    left: &[0u16, 0],
    right: &[0u16, 0],
};

// 准备输出缓冲区
let mut mp3_out_buffer = Vec::new();
mp3_out_buffer.reserve(mp3lame_encoder::max_required_buffer_size(input.left.len()));
// 编码PCM数据
let encoded_size = mp3_encoder.encode(input, mp3_out_buffer.spare_capacity_mut()).expect("To encode");
unsafe {
    mp3_out_buffer.set_len(mp3_out_buffer.len().wrapping_add(encoded_size));
}

// 刷新编码器缓冲区
let encoded_size = mp3_encoder.flush::<FlushNoGap>(mp3_out_buffer.spare_capacity_mut()).expect("to flush");
unsafe {
    mp3_out_buffer.set_len(mp3_out_buffer.len().wrapping_add(encoded_size));
}
// 此时mp3_out_buffer包含完整的MP3数据

完整示例

use mp3lame_encoder::{Builder, Id3Tag, DualPcm, FlushNoGap};
use std::fs::File;
use std::io::Write;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 1. 初始化MP3编码器
    let mut mp3_encoder = Builder::new().expect("创建LAME构建器失败");
    
    // 设置编码参数
    mp3_encoder.set_num_channels(2).expect("设置声道数失败");
    mp3_encoder.set_sample_rate(44_100).expect("设置采样率失败");
    mp3_encoder.set_brate(mp3lame_encoder::Bitrate::Kbps192).expect("设置比特率失败");
    mp3_encoder.set_quality(mp3lame_encoder::Quality::Best).expect("设置质量失败");
    
    // 设置ID3标签
    mp3_encoder.set_id3_tag(Id3Tag {
        title: b"示例音频",
        artist: b"艺术家",
        album: b"示例专辑",
        year: b"2023",
        comment: b"使用mp3lame-encoder编码",
    });
    
    // 构建编码器实例
    let mut mp3_encoder = mp3_encoder.build().expect("初始化LAME编码器失败");

    // 2. 准备模拟PCM数据(2秒双声道静音)
    let pcm_data_left: Vec<i16> = vec![0; 44100 * 2]; 
    let pcm_data_right: Vec<i16> = vec![0; 44100 * 2];
    
    // 3. 初始化MP3输出缓冲区
    let mut mp3_buffer = Vec::new();
    mp3_buffer.reserve(mp3lame_encoder::max_required_buffer_size(pcm_data_left.len()));
    
    // 分块编码处理(使用LAME推荐的1152帧大小)
    let chunk_size = 1152;
    for i in (0..pcm_data_left.len()).step_by(chunk_size) {
        let end = std::cmp::min(i + chunk_size, pcm_data_left.len());
        
        let input = DualPcm {
            left: &pcm_data_left[i..end],
            right: &pcm_data_right[i..end],
        };
        
        let encoded_size = mp3_encoder.encode(input, mp3_buffer.spare_capacity_mut())
            .expect("编码失败");
        
        unsafe {
            mp3_buffer.set_len(mp3_buffer.len() + encoded_size);
        }
    }
    
    // 刷新编码器获取剩余数据
    let encoded_size = mp3_encoder.flush::<FlushNoGap>(mp3_buffer.spare_capacity_mut())
        .expect("刷新失败");
    unsafe {
        mp3_buffer.set_len(mp3_buffer.len() + encoded_size);
    }
    
    // 4. 写入MP3文件
    let mut file = File::create("output.mp3")?;
    file.write_all(&mp3_buffer)?;
    
    println!("MP3编码完成，文件已保存为output.mp3");
    Ok(())
}

关于mp3lame-encoder

mp3lame-encoder是一个基于LAME MP3编码器的高性能Rust封装库，通过Rust友好的API提供音频编码功能。

主要特点：

• 支持多种音频参数配置：比特率、采样率、声道数等
• 完整的ID3标签支持
• 优化的编码性能
• 符合Rust惯用法的API设计

安装方法

在Cargo.toml中添加依赖：

[dependencies]
mp3lame-encoder = "0.2.1"

或者使用cargo命令安装：

cargo add mp3lame-encoder

许可证说明

该库采用LGPL许可证，与底层LAME库保持一致。