Audio
Pyxen soporta dos tipos de audio: sonidos para efectos cortos y música para pistas más largas. Ambos se adjuntan a entidades como componentes.
Sonidos
Un Sound es un clip de audio corto — un salto, un golpe, recoger una moneda. Reproduces un sonido generando una entidad con un componente Sound:
world.spawn(sound=Sound("jump"))El sonido se reproduce inmediatamente. Puedes controlar las propiedades de reproducción:
world.spawn(sound=Sound("laser", loop=True, gain=0.5, pan=-0.5))| Propiedad | Significado |
|---|---|
loop | Si el sonido se repite |
gain | Volumen (0.0 = silencio, 1.0 = máximo) |
pan | Posición estéreo (-1.0 = izquierda, 0.0 = centro, 1.0 = derecha) |
Los sonidos se cargan desde archivos de audio en los assets de tu proyecto.
Música
La música funciona como Sound pero está diseñada para pistas más largas. La música se transmite en flujo en vez de cargarse completamente en memoria:
world.spawn(music=Music("theme", loop=True))La música soporta las mismas propiedades: loop, gain y pan.
Audio como componentes
Como el audio se adjunta a entidades, lo gestionas de la misma forma que todo lo demás:
# iniciar música de fondo
bgm = world.spawn(name="bgm", music=Music("overworld", loop=True))
# detenerla después
world.destroy(bgm)Esto encaja naturalmente con el modelo ECS — el audio es solo otro componente en una entidad, visible en el inspector de fotogramas como todo lo demás.
Formatos soportados
- Sonidos: WAV
- Música: OGG Vorbis
Añade archivos de audio a tu proyecto a través del gestor de assets en Pyxen.