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:
parent
e28f8976f2
commit
2edd756920
13 changed files with 563 additions and 40 deletions
|
|
@ -396,8 +396,11 @@ Fahrtrichtung.
|
|||
sich innerhalb von zwei Sekunden aus. Steuerung: Icon-Knöpfe für
|
||||
Start/Pause und Reset (Rekorder-Symbole, Tooltips nennen die Aktion),
|
||||
Timeline-Scrubbing und Geschwindigkeit 0,25×–2,0×. Ein optionales
|
||||
Musikstück (MP3/OGG/WAV) liegt neben der Kür-JSON in `user://routines/`
|
||||
und läuft über einen `AudioStreamPlayer` auf derselben Zeitbasis: Start,
|
||||
Musikstück liegt neben der Kür-JSON in `user://routines/` und läuft über
|
||||
einen `AudioStreamPlayer` auf derselben Zeitbasis. `AudioFile` erkennt
|
||||
MP3/OGG/WAV an den echten Dateibytes; M4A/AAC und falsch als `.mp3`
|
||||
benannte ISO-Container werden auf macOS mit `afconvert` zu mono
|
||||
PCM-WAV (44,1 kHz) konvertiert. Start,
|
||||
Pause, Reset, Scrubbing und Geschwindigkeit wirken auf Bild und Ton. Über
|
||||
der Timeline liegt eine Label-Spur: Labels von Segmenten und Kürzel von
|
||||
Elementen ohne Freitext erscheinen schräg an ihrem Startzeitpunkt (auch
|
||||
|
|
@ -527,7 +530,8 @@ ggf. eines nach `touchend` (300-ms-Guard).
|
|||
Öffnen-Dialog zeigt `.json` und Legacy-`.tres`, wobei eine vorhandene
|
||||
`.json` die gleichnamige `.tres` verdeckt.
|
||||
`music_file` nennt nur den Dateinamen; die Audiodatei liegt flach daneben
|
||||
in `user://routines/` und wird vom Sync mitübertragen.
|
||||
in `user://routines/` und wird vom Sync mitübertragen. Nach einer
|
||||
M4A/AAC-Konvertierung verweist `music_file` auf das erzeugte WAV.
|
||||
`timeline_labels` speichert freie Timeline-Annotationen als
|
||||
`{time_seconds, text}`.
|
||||
- **Autosave** schreibt nach 1,5 s Inaktivität nur bei ungespeicherten
|
||||
|
|
|
|||
59
docs/findings-2026-11-10-mac-music.md
Normal file
59
docs/findings-2026-11-10-mac-music.md
Normal 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.
|
||||
|
|
@ -143,9 +143,15 @@ die 2D-Funktionen sind davon nicht betroffen.
|
|||
## Musik
|
||||
|
||||
Ein Musikstück gehört optional zur Kür. **Musik…** in der Playback-Leiste
|
||||
öffnet die Dateiauswahl für **MP3** (auch OGG/WAV). Die Datei wird in den
|
||||
Kür-Ordner kopiert und in der Kür-JSON als Dateiname vermerkt.
|
||||
öffnet die Dateiauswahl für **MP3**, **OGG** und **WAV**. Auf macOS werden
|
||||
zusätzlich **M4A/AAC** angeboten; sie werden beim Import automatisch in ein
|
||||
PCM-WAV umgewandelt. Das erkennt auch Dateien, die nur falsch als `.mp3`
|
||||
benannt sind. Auf anderen Systemen müssen M4A/AAC vorher extern konvertiert
|
||||
werden. Die Datei wird in den Kür-Ordner kopiert und in der Kür-JSON als
|
||||
Dateiname vermerkt.
|
||||
|
||||
- Kann eine Datei nicht geladen werden, zeigt die Leiste
|
||||
„(nicht abspielbar)“ und einen Tooltip mit den unterstützten Formaten.
|
||||
- Die Symbolknöpfe **Start/Pause** (▶/⏸) und **Reset** (⏮) steuern Bild und
|
||||
Musik gemeinsam; die Tooltips nennen die jeweilige Aktion.
|
||||
- **Timeline-Scrubbing** setzt auch die Musik an die entsprechende Stelle.
|
||||
|
|
|
|||
|
|
@ -32,9 +32,9 @@ Voraussetzung für Phase 1.
|
|||
Session-Restore (Legacy-`.tres` lesbar)
|
||||
- [x] Playback-Dot mit Blickrichtung, Timeline, Play/Pause/Reset und
|
||||
Geschwindigkeit 0,25×–2,0×
|
||||
- [x] Musikstück (MP3/OGG/WAV) je Kür laden; Wiedergabe, Scrubbing und
|
||||
Geschwindigkeit laufen synchron zum Läufer; der Cloud-Sync überträgt die
|
||||
Musikdatei mit der Kür
|
||||
- [x] Musikstück (MP3/OGG/WAV; M4A/AAC auf macOS automatisch nach WAV
|
||||
konvertiert) je Kür laden; Wiedergabe, Scrubbing und Geschwindigkeit laufen
|
||||
synchron zum Läufer; der Cloud-Sync überträgt die Musikdatei mit der Kür
|
||||
- [x] Timeline-Labels: Kür-Labels schräg auf der Timeline, eigene Labels per
|
||||
Klick anlegen, bearbeiten und löschen
|
||||
- [x] Abschnittswechsel setzt Abspielfigur und Timeline an den
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue