Musik und Geräusche einfügen

Diese Anleitung erklärt das Einbinden von Soundeffekten und/oder Musik in ein Twine-Spiel. Da das Storyformat Harlowe dies von Haus aus nicht untestützt, kommt dabei die Harlowe Audio Library (HAL) zum Einsatz.

Hinweis: Wer das Storyformat Sugarcube nutzt, kann die integrierte Funktionalität zum Abspielen von Sounds nutzen.

1. Besuche die Seite https://github.com/ChapelR/harlowe-audio/releases.
2. Lade die aktuellste ZIP-Datei herunter.
3. Entpacke die ZIP-Datei. Sie enthält folgende Dateien:
4. Öffne das Twine-Spiel, in welches du Sound einbauen möchtest.
5. Klicke im Menü auf Geschichte -> JavaScript.
6. Öffne die Datei harlowe-audio.min.js (die obere in der Abbildung) mit einem Texteditor (keine Textverarbeitung wie Word, sondern z. B. Notepad).
7. Kopiere den Inhalt der Datei in das Twine-Kästchen.
8. Klicke im Menü auf Geschichte -> Stylesheet.
9. Öffne die Datei harlowe-audio.min.css (die mittlere in der Abbildung) mit einem Texteditor.
10. Kopiere den Inhalt der Datei in das Twine-Kästchen.
11. Erzeuge einen neuen Twine-Abschnitt und benenne ihn in hal.tracks um. Dieser Abschnitt dient als Inhaltsverzeichnis aller verwendeten Sounddateien, die dann in den einzelnen Abschnitten erklingen sollen.
12. Lege in dem neuen Abschnitt für jeden Sound eine eigene Zeile an wie folgt:

    klaviermusik: chopin-nocturne.mp3, chopin-nocturne.ogg

    Vorn steht der Name, den wir verwenden, um den Sound abzuspielen, dahinter der Dateiname. Es wird empfohlen, die Sounddateien sowohl im ogg-Format als auch im mp3-Format zu hinterlegen, da nicht jeder Browser jedes Format abspielt. Zum Umwandeln in ein anderes Format kann ein Online-Konverter verwendet werden.
13. Speichere die Sounddateien in demselben Ordner ab, in welchem später auch das fertige Spiel liegen wird.
14. Um im Spiel einen der definierten Sounds abzuspielen, schreibe folgenden Code in den jeweiligen Abschnitt:

    (track: 'klaviermusik', 'play')

    Hinweis: Da sich Browser manchmal weigern, beim Aufrufen einer Seite sofort Sound abzuspielen, muss für eine Hintergrundmusik, die bei Spielbginn startet, folgender Code verwendet werden:

    (track: 'klaviermusik', 'loop', true)(track: 'klaviermusik', 'playwhenpossible')

    Der Abschnitt mit diesem Code muss den Tag startup enthalten ODER sich im Startabschnitt befinden (nicht beides). Selbst dann ist es oft noch nötig, mit der Seite zu interagieren, indem man z. B. mit der Maus hineinklickt, bevor der Sound abgespielt wird.
15. Um im Spiel die Wiedergabe eines Sounds abzubrechen, schreibe folgenden Code in den jeweiligen Abschnitt:

    (track: 'klaviermusik', 'stop')

    Um alle Sounds zu stoppen, kann folgender Code verwendet werden:

    (masteraudio: 'stopall')

Sounds verlinken

Folgender Code erzeugt einen Link, den man immer wieder anklicken kann, um einen Sound abzuspielen:

(link-repeat: 'Musik abspielen')[(track: 'klaviermusik', 'play')]