std.audio.playback — Wiedergabe-Fassade

→ std.audio Übersicht · std.audio.alsa · std.audio.mpg123 · Guide: Audio & Video

Vereinheitlichte Wiedergabe-Schnittstelle über ALSA (WP-05). Die Unit nimmt dem Aufrufer die ALSA-Konfiguration ab: Format, Samplerate und Kanalanzahl werden aus dem WAV-Header bzw. aus dem MP3-Stream übernommen. Zwei Ebenen: AudioOpen + AudioPlay* + AudioClose für mehrere Wiedergaben auf einem Handle, und PlayWAV / PlayMP3 als Einzeiler.

Geeignet für Soundeffekte, Systembenachrichtigungen, Alarme und einfache Player.

Quelle: std/audio/playback.lyx

<WRAP center round important 90%> Die Wiedergabe arbeitet (#1930, nachgemessen mit lyxc 1.2.2B). Frühere Fassungen dieser Seite meldeten das Gegenteil: ALSASetFormat galt als dauerhaft defekt und damit die ganze Fassade. Ursache war die Fehlerprüfung in std.audio.alsa (!= 0 statt < 0) — ALSA meldet Fehler negativ, und positive Rückgaben sind Erfolg mit Zusatzinformation. </WRAP>

Imports

import std.audio.playback;

Zieht std.audio, std.audio.alsa und std.audio.mpg123 mit. MP3-Wiedergabe setzt daher zusätzlich libmpg123 voraus, WAV-Wiedergabe nur libasound.so.2.

@capabilities([fs.meta, fs.read, fs.write])

Funktionen

Signatur Sichtbarkeit Beschreibung
AudioOpen(device: pchar): int64 pub Öffnet das Standard-PCM-Gerät. Rückgabe: ALSA-Handle, 0 bei Fehler (kein negativer Wert). Der Parameter device wird derzeit ignoriert — intern wird immer ALSAAudioOpen() aufgerufen
AudioPlayWAV(handle: int64, path: pchar): int64 pub Parst den WAV-Header, setzt Format, liest die PCM-Daten und schreibt sie ans Gerät. Gibt den Puffer selbst wieder frei. AUDIO_OK oder negativer Fehlercode
AudioPlayPCM(handle: int64, buffer: int64, dataSize: int64, sampleRate: int64, channels: int64, bitsPerSample: int64): int64 pub Gibt rohe PCM-Daten aus (interleaved, Little-Endian). bitsPerSample: 8 oder 16. Der Puffer bleibt Eigentum des Aufrufers
AudioPlayMP3(handle: int64, path: pchar): int64 pub Dekodiert die Datei über libmpg123 und schreibt blockweise (16 KB) ans Gerät. Format kommt aus MP3GetFormatFull; Rückfall auf 44100 Hz / 2 Kanäle / 16 Bit, wenn der Stream nichts meldet
AudioClose(handle: int64) pub Schließt das Gerät (ALSAClose, drained vorher)
PlayWAV(path: pchar): int64 pub Öffnen, WAV abspielen, schließen — in einem Aufruf
PlayMP3(path: pchar): int64 pub Öffnen, MP3 abspielen, schließen — in einem Aufruf

Fehlercodes sind die Konstanten aus std.audio (AUDIO_OK, AUDIO_ERROR).

Codebeispiel

unit main;
import std.audio.playback;
import std.io;

fn main(): int64 {
    // Einzeiler
    if (PlayWAV("ton.wav"c) != AUDIO_OK) {
        PrintLn("Wiedergabe fehlgeschlagen");
    }

    // Mehrere Dateien auf einem Handle
    var h: int64 := AudioOpen("default"c);
    if (h == 0) { return 1; }          // 0 = Fehler, nicht -1
    AudioPlayWAV(h, "eins.wav"c);
    AudioPlayMP3(h, "zwei.mp3"c);
    AudioClose(h);
    return 0;
}

Fallstricke

Thema Details
Fehlerwert von AudioOpen 0 bedeutet Fehler — die Prüfung < 0 greift nicht
device-Parameter wirkungslos Es wird immer das ALSA-Standardgerät geöffnet
Kein PlayWAVSystem Eine Variante über den aplay-Systemaufruf existiert in der Unit nicht; frühere Fassungen dieser Seite führten sie fälschlich auf
Format je Aufruf neu gesetzt Jedes AudioPlay* ruft ALSASetFormat + ALSAPrepare — Wechsel zwischen Dateien mit unterschiedlicher Samplerate ist damit erlaubt
MP3 nur 16 Bit AudioPlayMP3 setzt das Ausgabeformat fest auf 16 Bit
Linux only ALSA bzw. PipeWire-ALSA-Brücke vorausgesetzt

Letzte Aktualisierung: 2026-09-05 (#1930, nachgemessen mit lyxc 1.2.2B) — Defektkasten ersetzt: die Wiedergabe arbeitet.

Vorherige letzte Aktualisierung: 2026-09-02 — Seite gegen std/audio/playback.lyx abgeglichen: AudioOpen, AudioPlayWAV, AudioPlayPCM, AudioPlayMP3, AudioClose und PlayMP3 ergänzt, das nicht existierende PlayWAVSystem und der falsche std.os-Import entfernt.