Skip to main content

Crate simple_decoder

Crate simple_decoder 

Source
Expand description

§Simple Decoder

Rust-крейт для МАКСИМАЛЬНО лёгкого декодирования и обработки аудио.

§Quick Start

Всё, что нужно для счастья:

use simple_decoder::SimpleDecoder;
use simple_decoder::decoders::AudioDecoder;

fn main() {
    let data = std::fs::read("melody.mp3").expect("Не удалось прочитать файл");
    let decoder = SimpleDecoder::new();
    
    // Декодируем, ресемплим в 48кГц и переводим в моно одной цепочкой
    let track = decoder.decode(&data).unwrap()
        .resample(48000).unwrap()
        .rechannel(1);
        
    println!("Готово: {} сэмплов", track.pcm.len());
}

§Основные сущности

  • SimpleDecoder — универсальный комбайн. Находится в корне, сам определяет формат файла.
  • .decode(&[u8]) — основной метод, возвращает структуру AudioTrack.
  • AudioTrack — контейнер с сырыми данными (f32) и методами трансформации.

§Архитектура проекта

Библиотека построена на базе symphonia (декодинг) и rubato (ресемплинг).

  • SimpleDecoderError — перечисление всех возможных бед.
  • SimpleDecoder — точка входа.
  • audio:
    • AudioTrack — структура с PCM-данными.
    • AudioFormat — перечисление форматов (MP3, WAV, FLAC и т.д.).
  • decoders (специализированные декодеры):
    • aac : AACDecoder
    • flac : FLACDecoder
    • mp3 : MP3Decoder
    • oggopus : OGGOpusDecoder
    • oggvorbis : OGGVorbisDecoder
    • simple : SimpleDecoder
    • wav : WAVDecoder

§Powerful Transformations

После декодирования доступен Chain API для подготовки аудио к воспроизведению:

let track = decoder.decode(&data)?
    .resample(48000)?  // Высококачественный FFT ресемплинг
    .rechannel(2);     // Изменение количества каналов

§Методы AudioTrack

МетодОписание
.resample(target_rate)Изменяет частоту дискретизации. Использует Sinc-интерполяцию (FFT).
.rechannel(target_channels)Изменяет кол-во каналов. Считает среднее при Downmix (Stereo -> Mono).
.pcmПрямой доступ к Vec<f32> (Interleaved PCM).
.formatВозвращает исходный формат файла (AudioFormat).
.channelsТекущее количество каналов (u16).
.sample_rateТекущая частота дискретизации (u64).

§Лицензия

Максимально просто — MIT.

Re-exports§

pub use crate::decoders::simple::SimpleDecoder;

Modules§

audio
decoders

Enums§

SimpleDecoderError