75 lines
1.8 KiB
Markdown
75 lines
1.8 KiB
Markdown
|
# Notes d'installation pour PMOMusic
|
||
|
|
|
||
|
|
## Prérequis système
|
||
|
|
|
||
|
|
### libsoxr (obligatoire pour pmoaudio - resampling)
|
||
|
|
|
||
|
|
La bibliothèque `libsoxr` est requise pour le resampling audio dans `pmoaudio`.
|
||
|
|
|
||
|
|
### libasound2/ALSA (obligatoire pour pmoaudio - lecture audio sur Linux)
|
||
|
|
|
||
|
|
La bibliothèque ALSA est requise pour `AudioSink` via `cpal` sur Linux. Sur macOS et Windows, aucune dépendance externe n'est nécessaire (CoreAudio et WASAPI sont utilisés).
|
||
|
|
|
||
|
|
**Installation** :
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Debian/Ubuntu
|
||
|
|
sudo apt-get install libsoxr-dev libasound2-dev
|
||
|
|
|
||
|
|
# Fedora/RHEL
|
||
|
|
sudo dnf install libsoxr-devel alsa-lib-devel
|
||
|
|
|
||
|
|
# Arch Linux
|
||
|
|
sudo pacman -S libsoxr alsa-lib
|
||
|
|
|
||
|
|
# macOS (Homebrew) - ALSA non nécessaire sur macOS
|
||
|
|
brew install libsoxr
|
||
|
|
|
||
|
|
# Alpine Linux
|
||
|
|
apk add soxr-dev alsa-lib-dev
|
||
|
|
```
|
||
|
|
|
||
|
|
**Sans privilèges root** : Si vous n'avez pas les droits sudo, consultez `INSTALL_LIBSOXR.md` pour l'installation locale de `libsoxr` et `libasound2`.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Nouveaux composants
|
||
|
|
|
||
|
|
### PlaylistSource (pmoaudio-ext)
|
||
|
|
|
||
|
|
Source audio qui lit une playlist `pmoplaylist` et diffuse les pistes en continu.
|
||
|
|
|
||
|
|
**Feature** : `playlist`
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Compiler avec la feature playlist
|
||
|
|
cargo build --package pmoaudio-ext --features playlist
|
||
|
|
```
|
||
|
|
|
||
|
|
**⚠️ Important** : Cette source émet du PCM avec sample_rate et bit_depth **variables**. Pour un flux homogène, ajoutez dans le pipeline :
|
||
|
|
- `ResamplingNode` (normalise le sample_rate)
|
||
|
|
- `ToI24Node` / `ToI16Node` (normalise la profondeur de bits)
|
||
|
|
|
||
|
|
### ResamplingNode (pmoaudio)
|
||
|
|
|
||
|
|
Nœud générique qui normalise le sample_rate vers une valeur cible fixe.
|
||
|
|
|
||
|
|
**Usage** :
|
||
|
|
```rust
|
||
|
|
let mut resampler = ResamplingNode::new(48000); // Force 48kHz
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Compilation
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Compiler tout le workspace (nécessite libsoxr)
|
||
|
|
cargo build
|
||
|
|
|
||
|
|
# Compiler sans pmoaudio (si libsoxr manque)
|
||
|
|
cargo build --package pmoplaylist
|
||
|
|
cargo build --package pmoaudiocache
|
||
|
|
# etc.
|
||
|
|
```
|