Tutorial 4 — Sound und Musik

$this->sound() (der SoundManager) spielt Effekte und Musik ab, auf dem Desktop wie im Browser. Ohne Soundkarte bleibt alles still, es gibt nie einen Fehler.

In PHP erzeugte Sounds

Synth erzeugt Retro-Sounds ganz ohne Dateien:

use JumPHP\Audio\Synth;

if (!$this->sound()->hasSfx('jump')) {                        // nur ein einziges Mal
    $this->sound()->synth('jump', Synth::sweep(250, 600, 0.12));               // eine aufsteigende Frequenz
    $this->sound()->synth('coin', Synth::sequence([[988, 0.05], [1319, 0.12]])); // zwei Töne
    $this->sound()->synth('hit', Synth::noise(0.15));                          // ein Rauschen
    $this->sound()->synth('bass', Synth::tone(110, 0.3, 'triangle'));          // square, triangle, sine, saw
}
$this->sound()->playSfx('jump');

Dateien

$this->sound()->loadSfx('explosion', 'assets/sfx/explosion.wav');     // wav, ogg, mp3
$this->sound()->loadMusic('level', 'assets/music/level.ogg');
$this->sound()->playMusic('level');
$this->sound()->stopMusic();

Die Lautstärke

setSfxVolume(0.8), setMusicVolume(0.5), setMuted(true): Diese Einstellungen werden mit den Optionen des Spielers gespeichert. Ein Optionsmenü macht daraus Zeilen wie ['VOLUME', fn () => ..., null, fn (int $dir) => ...] (siehe die Menüs).

Es gibt auch 3D-Sound (im Raum positioniert): $this->engine->audio3d().