# Busfahrt — Sound-Liste

**Stand:** 2026-05-03 (Vorschlag, wartet auf Thomas-Abnahme)

Pfad-Konvention: `App/sims/busfahrt/assets/sounds/<slug>.mp3` (oder `.ogg`).
Lautstärke per JS-Volume-Setting (default ~0.4 für Effekte, ~0.15 für Musik).
Lehrkraft-Schalter `audioEnabled` als Plattform-Hook (Default: an).

---

## UI-Effekte (kurz, < 1 s)

| Slug | Wann | Charakter |
|------|------|-----------|
| `tap-map.mp3` | Karten-Tap registriert | Holziges „klick-tock", trocken |
| `pin-drop.mp3` | Tipp-Pin landet auf Karte | Kurzes „bip" + Pin-Aufprall |
| `hit-perfect.mp3` | < 50 km Treffer (3 Punkte) | Heller, freundlicher Erfolgs-Akkord, 3 Töne aufsteigend |
| `hit-ok.mp3` | 50–200 km (1 Punkt, „knapp daneben") | Warmer, neutraler Halbton, einzelner Glockenton |
| `hit-miss.mp3` | > 200 km Fehlversuch | Sanft fallender Doppelton, nicht negativ-laut |
| `attempts-empty.mp3` | 3. Fehlversuch verbraucht | Leiser, leicht melancholischer Akkord (kein Fail-Buzz) |
| `choice-right.mp3` | Single-Choice richtig | Kurzes „ping", harmonisch |
| `choice-wrong.mp3` | Single-Choice falsch | Leiser Bass-Plopp, neutraler Hinweis |
| `order-resolved.mp3` | Auftrag abgeschlossen, Info-Card geht auf | Sanfter Whoosh + zufriedener Akkord |
| `bid-win.mp3` | Phase 2: Konkurrenz-Preis unterboten | Kasse klingelt kurz, leicht heiter |
| `bid-lose.mp3` | Phase 2: Auftrag verloren weil zu teuer | Trockener Plopp, kein Drama |
| `tour-end.mp3` | Tour beendet, End-Screen erscheint | Kleine 4-Ton-Fanfare, Akustik-Bus-Hupe schließend |

## Hintergrund-Loops

| Slug | Wann | Länge | Charakter |
|------|------|-------|-----------|
| `bg-l1-europe.mp3` | L1 Europa-Tour läuft | 2–3 Min Loop | Sanfter europäischer Reise-Soundtrack, leichte Akustikgitarre + Klavier, fröhlich |
| `bg-l2-asia.mp3` | L2 mit Asien | 2–3 Min Loop | Wie L1, aber mit Hauch fernöstlicher Tonleiter (Pentatonik, Bambusflöte als Gastinstrument) |
| `bg-l3-world.mp3` | L3 Welt | 2–3 Min Loop | Etwas weiter, orchestraler — Streicher kommen dazu, dezente Trommeln |
| `bg-welcome.mp3` | Welcome-Modal & End-Screen | 30 s Loop | Kurzes Atmo-Pad, Klavier-Tropfen, „du startest gleich" |

Alle Loops müssen **nahtlos schleifenfähig** sein (Anfang/Ende kompatibel) und sollen **leise im Hintergrund** sitzen — primärer Fokus bleibt das Karten-Tippen.

## Optionale „Wo bin ich"-Stinger pro Region (später)

Sehr kurze (< 1 s) Region-Idents, die beim Auflösen einer Stadt mit dem Info-Card-Auftauchen co-spielen. Können später kommen, nicht V1-Pflicht:

- `region-dach.mp3` — Alphorn-Andeutung
- `region-mediterran.mp3` — Mandoline-Akkord
- `region-osteuropa.mp3` — Akkordeon-Tropfen
- `region-skandinavien.mp3` — Glockenspiel kalt
- `region-asien-ost.mp3` — Pentatonik-Klimperton
- `region-asien-süd.mp3` — Sitar-Klimperton
- `region-nahostmittel.mp3` — Oud-Anschlag
- `region-amerika-nord.mp3` — Akustik-Westerngitarre
- `region-amerika-süd.mp3` — Pan-Flöte / Charango
- `region-afrika.mp3` — Djembe-Klangfolge
- `region-ozeanien.mp3` — Ukulele-Akkord

## Bus-Animation-Sound (für die Hintergrund-Busse)

| Slug | Charakter |
|------|-----------|
| `bus-pass-by.mp3` | Sehr leiser Vorbeifahrt-Sound, wenn ein Hintergrund-Bus die sichtbare Karte überquert. Kurze Doppler-Andeutung. Optional, default off. |

---

# Musik-Stil-Brief (für Hintergrund-Loops)

Verbindlicher Stil, analog zum Bildstil-Brief. Ein einheitlicher Sound für die ganze Sim, mit Level-Variationen.

## Verbindlicher Prompt-Block

```
Calm, gentle instrumental travel ambience. Low-key acoustic palette: soft
upright piano, fingerpicked acoustic guitar, gentle pizzicato strings,
warm pads. Tempo around 80–95 BPM, rolling triplet feel.
No drums beyond soft brushed hand-percussion. No vocals, no lyrics.
Major-key, optimistic but understated — feels like watching the landscape
pass through a bus window. Mix sits low so it never competes with
spoken content or UI clicks. Loop-ready, seamless start-to-end transition.
```

## Eckdaten

- **Format:** MP3 oder OGG, 128–192 kbps (klein, schnell zu laden)
- **Sample-Rate:** 44.1 kHz, Stereo
- **Länge je Loop:** 2–3 Min (so dass es nicht zu schnell repetitiv wirkt)
- **Lautstärke-Standard:** -18 LUFS integrated (leise im Mix)
- **Loop-Punkt:** identisches erstes/letztes 0.5 s, kein hörbarer Sprung
- **Tabu:** Drum-Beats > Bass-Drum, schnelle Synth-Arpeggien, Vocal-Chops, alles was an Werbe-Jingle erinnert

## Level-Variationen (gleicher Grundstil, aber Akzent-Instrument)

| Level | Akzent | Stimmung |
|-------|--------|----------|
| **L1 Europa** | Klavier + Akustikgitarre | Bekannt, freundlich, Reisestart |
| **L2 + Asien** | + Bambusflöte / Shakuhachi (vereinzelt) | Etwas weiter, leicht meditativ |
| **L3 Welt** | + dezente Streicher + Mallet-Percussion | Größerer Horizont, leicht orchestral |

## Empfohlene Referenzkünstler:innen / Tracks

(Nur als Stil-Anhalt für eine spätere Auftragsbeschreibung an Komponist:in oder beim Generieren via Suno/Udio:)

- **Yann Tiersen** — leichte Akkordeon/Klavier-Skizzen aus „Goodbye Lenin" oder „Amélie"
- **Joe Hisaishi** — die ruhigeren Momente aus „Kiki's Delivery Service" (Reise-Stimmung, kein Action-Score)
- **Nils Frahm** — klare Klavier-Pads, „Says"
- **Ólafur Arnalds** — leichter Streicher-Klang
- **Studio Ghibli Lo-Fi Remixe** — generelle Atmo-Vibe

Kein 80s-Synthwave, keine Modern-Beats, keine Filmtrailer-Drums.

## Beschaffungsoptionen

1. **Suno / Udio** (KI-Komposition aus dem Prompt): generierbar, Lizenz prüfen.
2. **Pixabay-Music** (CC0): einige Akustik-Loops kostenfrei.
3. **Freesound** (Creative Commons, Attribution prüfen).
4. **Eigenkomposition** (Logic / GarageBand / Ableton).
5. **Lizenz von Kompositions-Bibliotheken** (Artlist, Epidemic Sound — kostet, aber sauber lizenziert für Bildungs-Webapp).

## Sound-Implementation in der Sim (technisch)

- **WebAudio API** statt `<audio>`-Tags für UI-Sounds (geringere Latenz, mehrfach abspielbar)
- **Howler.js** ist eine bekannte Lib dafür — kompakt (~13 KB), funktioniert auch auf iPad
- **Lautstärke-Slider** in einem späteren Lehrkraft-Cockpit (Plattform-Param `audioVolume`)
- **Mute-Toggle** in der Topbar — kleines 🔊/🔇-Icon
- **Audio darf nicht autoplayen** auf iPad — erstes Audio-Event wird beim ersten User-Tap entsperrt

## Empfehlung Reihenfolge

1. **V1 jetzt:** UI-Effekte (12 Stück) und 1 Hintergrund-Loop reichen für Veröffentlichung
2. **V1.1:** drei Level-Loops aufteilen
3. **V2:** Region-Stinger + Bus-Pass-By

---

## Frage an Thomas

- **Schon Komponist:in / Lieferquelle im Hinterkopf**, oder sollen wir mit
  CC0-Pixabay starten und später ersetzen?
- **OK mit Howler.js** oder lieber pure WebAudio API?
- **Mute-Toggle** als persistentes localStorage-Setting pro Schüler:in
  oder als Lehrkraft-Param im Cockpit?