fix: play M4A/AAC music on macOS via WAV conversion

- detect audio containers by content instead of file extension
- convert ISO media/M4A/AAC with afconvert to mono PCM WAV
- handle mislabeled .mp3 files and already referenced old routines
- show a clear not-playable state and add audio tests
This commit is contained in:
torsten 2026-11-10 20:04:25 +01:00
parent e28f8976f2
commit 2edd756920
13 changed files with 563 additions and 40 deletions

View file

@ -0,0 +1,59 @@
# Findings – Musikwiedergabe auf macOS (2026-11-10)
## Problem
Die Logs zeigten:
```text
ERROR: Failed to decode mp3 file. Make sure it is a valid mp3 audio file.
ERROR: This AudioStreamMP3 does not have an audio file assigned to it.
```
Die betroffenen Dateien hießen `.mp3`, waren aber tatsächlich
**M4A/AAC-Container** (`ftypM4A`). Godot spielt nur MP3, OGG Vorbis und WAV
nativ ab. Zusätzlich wählt `afconvert` seinen Demuxer über die
Dateiendung, sodass eine M4A-Datei mit `.mp3`-Endung auch dort zunächst
scheiterte.
## Umsetzung
- Neue Hilfsklasse `AudioFile` (`src/core/io/audio_file.gd`):
- erkennt MP3, OGG, WAV und ISO-Container (M4A/AAC/MP4) an den echten
Dateibytes, nicht an der Endung;
- lädt MP3/OGG/WAV über die Godot-Audio-Streams.
- macOS-Konvertierung mit `/usr/bin/afconvert`:
- Ausgabe als mono PCM-WAV, 44,1 kHz, 16 Bit;
- `-l 1` verhindert `WAVE_FORMAT_EXTENSIBLE`, das Godots WAV-Loader nicht
akzeptiert;
- `--no-filler` entfernt den `FLLR`-Block, den Godot ebenfalls nicht
erwartet;
- Dateien mit falscher Endung (z. B. M4A als `.mp3`) werden für die
Konvertierung als temporäre `.m4a`-Kopie bereitgestellt.
- `load_music_from_path()` konvertiert M4A/AAC beim Import und speichert das
erzeugte WAV in `user://routines/`.
- `_load_music_stream()` konvertiert auch bereits referenzierte Altdateien
beim Laden automatisch und verwendet danach das WAV.
- `FileDialog` bietet zusätzlich `.m4a` und `.aac` an; `RoutineFile`
akzeptiert diese Endungen.
- Nicht abspielbare Dateien zeigen in der Playback-Leiste
„(nicht abspielbar)“ und einen erklärenden Tooltip.
## Tests
Neue `tests/run_audio_tests.gd`:
- Header-Erkennung für MP3, OGG, WAV und als `.mp3` getarntes M4A.
- Laden eines PCM-WAV.
- macOS: WAV→M4A mit `afconvert`, M4A→WAV über `AudioFile`, Laden des
Ergebnisses.
- macOS: M4A als `.mp3` wird über den Endungs-Fallback korrekt konvertiert.
`./tools/test.sh` führt den neuen Audiotest mit aus.
## Grenzen
- M4A/AAC wird nur auf macOS automatisch konvertiert. Windows/Linux brauchen
weiterhin MP3, OGG oder WAV.
- Die konvertierte WAV-Datei ist deutlich größer als das M4A-Original
(mono 44,1 kHz, ca. 5 MB pro Minute), bleibt aber unter dem 64-MB-Limit
für übliche Kür-Musik.