Adminator
1e51ef7def
- Konzept/, didaktik_geografie/, didaktik_simulation/, v2-modules/, v2-platform/ - 12 code-workspace-Files - STATUS-*.md - viele M/D/R-Änderungen an bereits getrackten Files - .gitignore verstärkt: **/.humaninput/, **/secret_keys.txt Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
99 lines
6.6 KiB
Markdown
99 lines
6.6 KiB
Markdown
# Farmer — Sound-Effekte + Musik (TODO via ElevenLabs Sound-Effects API + Musik-Quelle)
|
||
|
||
Aktueller Stand: `playSound(name, opts)` ist als **Stub** in `game.html`
|
||
implementiert (loggt nur in die Konsole). Mute-Toggle 🔊/🔇 ist in der
|
||
Topbar vorbereitet. Sobald MP3-Dateien unter `assets/sounds/` liegen,
|
||
ersetzt der Stub durch echtes `Audio.play()` und der Mute-Toggle wird
|
||
funktional.
|
||
|
||
## Workflow zum Generieren (sobald API-Zugang da ist)
|
||
|
||
1. **ElevenLabs Sound Effects API**: `POST /v1/sound-generation`
|
||
mit Prompt + duration_seconds
|
||
2. MP3 unter `App/sims/farmer/assets/sounds/<name>.mp3` ablegen
|
||
3. `playSound()`-Stub durch echtes Audio-Play ersetzen (siehe
|
||
`// TODO ElevenLabs`-Marker im Code)
|
||
4. Audio-Cache: alle Sounds beim Boot mit `new Audio()` vorladen,
|
||
damit die erste Wiedergabe nicht stockt
|
||
5. Mute-Toggle ist schon eingebaut — wird automatisch aktiv wenn
|
||
Audio-Dateien da sind
|
||
|
||
## Sound-Effekte (15 Stück)
|
||
|
||
| Name (Datei) | Wann wird abgespielt | ElevenLabs-Prompt | Dauer |
|
||
|---|---|---|---|
|
||
| `plant.mp3` | Nach jeder Pflanzung (Karten-Klick) | "Soft natural sound of seeds being scattered onto soil, single brief gesture, no music" | 0.6 s |
|
||
| `harvest_start.mp3` | Klick auf „Erntejahr starten" | "Distant farm bell ringing twice, calling workers to harvest, warm ambient countryside" | 1.2 s |
|
||
| `report_open.mp3` | Wenn eine Bericht-Card erscheint | "Soft paper page turning, gentle crisp sound" | 0.4 s |
|
||
| `report_next.mp3` | Klick auf „Weiter" zwischen Cards | "Soft tap on wooden table, very brief" | 0.2 s |
|
||
| `vehicle_truck.mp3` | Beim Start einer LKW-Animation | "Heavy diesel truck engine starting and driving away, departing motor sound" | 1.5 s |
|
||
| `vehicle_ship.mp3` | Beim Start einer Schiff-Animation | "Cargo ship horn, deep low blast, single foghorn" | 2.0 s |
|
||
| `vehicle_plane.mp3` | Beim Start einer Flugzeug-Animation | "Cargo plane taking off, jet engine spinning up and lifting" | 2.0 s |
|
||
| `vehicle_arrive.mp3` | Wenn Vehicle den Hub erreicht | "Cash register cha-ching sound, coins falling into drawer, brief and bright" | 0.7 s |
|
||
| `disease_outbreak.mp3` | Bei Krankheits-Ausbruch im Bericht | "Ominous low drone with subtle crackling and whispering wind, foreboding agricultural disaster" | 1.5 s |
|
||
| `monoculture_warn.mp3` | Sanfte Warnung wenn Bodenmüdigkeit > 30 % im Bericht | "Subtle dry rustling of leaves, gentle warning tone" | 0.8 s |
|
||
| `year_advance.mp3` | Beim Übergang ins nächste Jahr | "Soft mechanical calendar page flipping, with gentle clock chime" | 0.8 s |
|
||
| `unlock_crop.mp3` | Wenn eine neue Sorte freigeschaltet wird | "Bright magical chime, discovery sound, hopeful and brief" | 1.0 s |
|
||
| `negative_balance.mp3` | Wenn Geld-Anzeige negativ wird | "Sad descending two-note tone, very subtle, regretful" | 0.7 s |
|
||
| `end_report_open.mp3` | Wenn der Endbericht-Modal aufgeht | "Triumphant ascending chime, festive but warm, harvest celebration" | 1.5 s |
|
||
| `reset.mp3` | Beim Neustart-Klick | "Soft swoosh, gentle reset, brief and clean" | 0.5 s |
|
||
|
||
## Hintergrundmusik
|
||
|
||
Empfohlener Stil: **Ambient-akustisch mit leichten Folk-Elementen.**
|
||
- Sanftes Klavier oder akustische Gitarre
|
||
- Sehr dezente Naturgeräusche (Wind, ferne Vögel)
|
||
- Keine starken Rhythmen, keine Vocals
|
||
- Tonart: meistens Dur-Variationen
|
||
- Lautstärke: bewusst leise (Vordergrund: Lernarbeit + Sound-Effekte)
|
||
|
||
**Referenz-Stile** (zur Orientierung wenn mit Suno/Stable Audio generiert):
|
||
- Banished-Soundtrack (Mark Engberg) — landwirtschaftlich-ambient
|
||
- Stardew Valley „Spring" — sanft, melodisch, nicht zu süßlich
|
||
- Brian Eno „Music for Airports" — minimalistisch
|
||
- Ludovico Einaudi (Klavier-Minimalismus)
|
||
|
||
**Empfohlene Musik-Dateien** (mehrere Loops für Abwechslung):
|
||
|
||
| Datei | Stil | Dauer | Generierungs-Prompt |
|
||
|---|---|---|---|
|
||
| `music_main.mp3` | Hauptloop (default) | 3–5 min, loop-tauglich | "Gentle ambient acoustic guitar with soft piano, peaceful pastoral atmosphere, subtle nature sounds wind and distant birds, no vocals, calm tempo around 70 BPM, in C major, loopable seamlessly" |
|
||
| `music_hamburg.mp3` (optional) | EU-Markt aktiv | 2–3 min | "Slow folk waltz with accordion and acoustic guitar, gentle European countryside feel, no vocals, 80 BPM" |
|
||
| `music_shanghai.mp3` (optional) | Asien-Markt aktiv | 2–3 min | "Peaceful East Asian instrumental with guzheng and bamboo flute, no vocals, slow 70 BPM" |
|
||
| `music_saopaulo.mp3` (optional) | Südamerika-Markt aktiv | 2–3 min | "Gentle bossa nova guitar instrumental, no vocals, warm and laid-back, 80 BPM" |
|
||
| `music_dubai.mp3` (optional) | Naher Osten aktiv | 2–3 min | "Atmospheric instrumental with oud and ney flute, peaceful desert evening, no vocals, 70 BPM" |
|
||
| `music_newyork.mp3` (optional) | NA-Markt aktiv | 2–3 min | "Gentle Americana acoustic with light banjo and harmonica, no vocals, 80 BPM" |
|
||
|
||
**Hinweis zur Generierung:** ElevenLabs Sound Effects ist primär für kurze
|
||
Sounds — für Musik-Loops empfehle ich **Suno** (suno.com) oder
|
||
**Stable Audio** (Stability AI). Beide können 2–5 Min lange Loops mit
|
||
deutschen oder englischen Prompts erzeugen. Lizenz prüfen für Schul-
|
||
Einsatz (Suno gibt CC-BY für Free-Tier, Pro-Plan kommerzielle Rechte).
|
||
|
||
## Aufruf-Stellen im Code (bereits eingebaut als Stub)
|
||
|
||
| Funktion in `game.html` | Aufruf |
|
||
|---|---|
|
||
| `onMapClick` (nach erfolgreichem `plant`) | `playSound('plant')` |
|
||
| `onHarvest` | `playSound('harvest_start')` |
|
||
| `showReportCard` (Eintritt) | `playSound('report_open')` ODER `playSound('disease_outbreak')` falls Disease |
|
||
| `onReportNext` (mittendrin) | `playSound('report_next')` |
|
||
| `animateOneTrade` (Start) | `playSound('vehicle_' + modeKey)` |
|
||
| `animateOneTrade` (Ankunft) | `playSound('vehicle_arrive')` |
|
||
| `onReportNext` (letzte Card → nextYear) | `playSound('year_advance')` |
|
||
| `unlockNewCrops` (wenn neue Sorte freigeschaltet) | `playSound('unlock_crop')` |
|
||
| `updateMoneyDisplay` (Übergang positiv→negativ) | `playSound('negative_balance')` |
|
||
| `showEndReport` | `playSound('end_report_open')` (TODO einfügen) |
|
||
| `resetGame` | `playSound('reset')` (TODO einfügen) |
|
||
| Boot | Hintergrundmusik starten (wenn audioEnabled) |
|
||
| `toggleAudio` | Hintergrundmusik mute/unmute |
|
||
|
||
## API-Zugangsdaten (TODO Thomas)
|
||
|
||
- **ElevenLabs API-Key** in `App/.env.local` als `ELEVENLABS_API_KEY=...`
|
||
- **Suno API-Key** (für Musik) in `App/.env.local` als `SUNO_API_KEY=...`
|
||
- Generierungs-Skript wird unter `scripts/generate-sounds.sh` analog zum
|
||
Bildstil-Generator (Logistik) angelegt sobald Keys da sind
|
||
- **Keine Live-API-Calls im Produkt** — Sounds + Musik werden vorab generiert,
|
||
als statische MP3-Dateien ausgeliefert (Memory `feedback_no_ai_in_product`)
|