Tutorial 4 — Sonidos y música

$this->sound() (el SoundManager) reproduce los efectos y la música, tanto en el escritorio como en el navegador. Sin tarjeta de sonido, todo queda en silencio, nunca da error.

Sonidos fabricados en PHP

Synth crea sonidos retro sin ningún archivo:

use JumPHP\Audio\Synth;

if (!$this->sound()->hasSfx('jump')) {                        // una sola vez
    $this->sound()->synth('jump', Synth::sweep(250, 600, 0.12));               // una frecuencia que sube
    $this->sound()->synth('coin', Synth::sequence([[988, 0.05], [1319, 0.12]])); // dos notas
    $this->sound()->synth('hit', Synth::noise(0.15));                          // un ruido
    $this->sound()->synth('bass', Synth::tone(110, 0.3, 'triangle'));          // square, triangle, sine, saw
}
$this->sound()->playSfx('jump');

Archivos

$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();

El volumen

setSfxVolume(0.8), setMusicVolume(0.5), setMuted(true): estos ajustes se guardan con las opciones del jugador. Un menú de opciones los convierte en líneas ['VOLUME', fn () => ..., null, fn (int $dir) => ...] (consulta los menús).

También existe el sonido en 3D (posicionado en el espacio): $this->engine->audio3d().