Audio
Hay dos formas de hacer sonar algo en Gobu: pedírselo a AudioManager desde el código (un
efecto que suena una vez y desaparece) o poner un actor reproductor en el documento (música,
sonidos continuos, algo que controlas con el inspector).
Sonidos de una vez: AudioManager
Sección titulada «Sonidos de una vez: AudioManager»Importa el sonido con use audio:: (por su nombre de archivo, sin ruta ni extensión) y
pásaselo a AudioManager:
use audio::coin as coin_snd
fn collect() void { AudioManager.play_sound(coin_snd)}AudioManager crea un reproductor, lo reproduce y lo borra al terminar. No tienes que
guardar nada.
Para sonidos con posición (se oyen más a la izquierda o más lejos según dónde ocurren):
AudioManager.play_sound_at_location(coin_snd, position) # 2D, un Vector2AudioManager.play_sound_at_location_3d(coin_snd, Vector3.ZERO) # 3D, un Vector3| Función | Crea |
|---|---|
play_sound(stream) | un AudioStreamPlayer (sin posición) |
play_sound_at_location(stream, Vector2) | un AudioStreamPlayer2D |
play_sound_at_location_3d(stream, Vector3) | un AudioStreamPlayer3D |
use se explica en Importar con use.
Actores reproductores
Sección titulada «Actores reproductores»Cuando el sonido tiene que seguir sonando, repetirse o pararse a voluntad (la música del nivel, el motor de un coche), añade un actor al documento:
- AudioStreamPlayer: sin posición. Música e interfaz.
- AudioStreamPlayer2D: en el mundo 2D.
- AudioStreamPlayer3D: en el mundo 3D.
En el inspector eliges el stream, el volumen, si empieza solo (autoplay) y el bus. Desde
el código lo controlas como cualquier actor:
use actor::Music as music : AudioStreamPlayer
fn _ready() void { music.play()}
fn pause_music() void { music.stream_paused = true}Este código va en el documento que tiene el actor Music.

Todo el audio pasa por buses: canales con su volumen y sus efectos (reverberación,
ecualizador, compresor…), que acaban en el bus Master. Se editan en el panel Audio
del editor y se guardan en un AudioBusLayout.

Lo habitual es un bus para la música y otro para los efectos, así el menú de opciones puede
bajar uno sin tocar el otro. Cada reproductor elige su bus con la propiedad bus. Desde el
código, el volumen de un bus se cambia con Audio:
fn set_music_volume(db: float) void { Audio.set_bus_volume_db(Audio.get_bus_index("Music"), db)}Música interactiva
Sección titulada «Música interactiva»Gobu incluye el módulo de música interactiva. Son tres tipos de stream que se asignan a un reproductor como cualquier otro sonido:
- AudioStreamInteractive: varios clips con transiciones entre ellos (por ejemplo, exploración → combate) que se sincronizan con el compás.
- AudioStreamPlaylist: una lista de pistas que se reproducen una tras otra.
- AudioStreamSynchronized: varias capas que suenan a la vez, cada una con su volumen (por ejemplo, añadir percusión cuando sube la tensión).
