Ir al contenido
Descargar
Guía de Gobu

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).

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 Vector2
AudioManager.play_sound_at_location_3d(coin_snd, Vector3.ZERO) # 3D, un Vector3
FunciónCrea
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.

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:

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.

Un actor Music (AudioStreamPlayer) en el nivel: el Inspector muestra su Stream (win.ogg), Autoplay activado y el bus 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.

El panel Audio: el bus Master y dos más, Music con un compresor y SFX con reverberación, los dos enviando a Master

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)
}

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).

Un AudioStreamInteractive como Stream de un reproductor en el Inspector: dos clips, Explore y Combat, el clip inicial y el botón Edit Transitions