`pyxen.Music`

Una pista de audio en streaming adjunta a un Entity como componente.

La música se decodifica bajo demanda (OGG Vorbis), lo que la hace adecuada para pistas largas como música de fondo y ambientación.

Para conceptos de audio, consulta Audio.

Constructor

Music(filename)

Un argumento posicional requerido: el nombre de un recurso de audio OGG Vorbis en el proyecto.

Parámetro	Tipo	Descripción
`filename`	`str`	Nombre del recurso OGG

theme = Music("theme")

Durante spawn:

bgm = world.spawn(music=Music("theme"))

O después:

entity.music = Music("theme")

Asignar música inicia la reproducción inmediatamente.

Acceso mediante entity.music:

Propiedad	Tipo	L/E	Descripción
`loop`	`bool`	L/E	Activar bucle
`volume`	`float`	L/E	Ganancia (limitada >= 0.0)
`pan`	`float`	L/E	Paneo estéreo (-1.0 a 1.0)
`time`	`float`	L	Posición actual de reproducción (segundos)
`duration`	`float`	L	Duración total (segundos)
`finished`	`bool`	L	True cuando la reproducción ha terminado

entity.music.loop = True

Cuando está activado, la pista se reinicia automáticamente al terminar. Típico para música de fondo.

entity.music.volume = 0.5

Los valores por debajo de 0.0 se limitan a 0.0.

entity.music.pan = -1.0  # totalmente a la izquierda
entity.music.pan =  1.0  # totalmente a la derecha
entity.music.pan =  0.0  # centro

Limitado al rango -1.0 a 1.0.

t = entity.music.time

Solo lectura. Posición actual de reproducción en segundos.

d = entity.music.duration

Solo lectura. Duración total de la pista en segundos.

if entity.music.finished:
    world.destroy(entity)

Solo lectura. True cuando la pista ha terminado de reproducirse (y loop es False).

Los recursos de música deben ser archivos OGG Vorbis.

A diferencia de Sound (WAV, cargado completamente en memoria), Music se transmite y decodifica bajo demanda — más adecuado para audio largo.

Music()

ValueError: Music must have a file

Music("nonexistent")

El objeto de música se crea pero la reproducción fallará silenciosamente con una advertencia registrada.