Audio
Pyxen prend en charge deux types d’audio : les sons pour les effets courts et la musique pour les pistes plus longues. Les deux sont attachés aux entités sous forme de components.
Sons
Un Sound est un clip audio court — un saut, un impact, une pièce ramassée. Vous jouez un son en créant une entity avec un component Sound :
world.spawn(sound=Sound("jump"))Le son est joué immédiatement. Vous pouvez contrôler les propriétés de lecture :
world.spawn(sound=Sound("laser", loop=True, gain=0.5, pan=-0.5))| Propriété | Signification |
|---|---|
loop | Indique si le son se répète |
gain | Volume (0.0 = silence, 1.0 = maximum) |
pan | Position stéréo (-1.0 = gauche, 0.0 = centre, 1.0 = droite) |
Les sons sont chargés à partir des fichiers audio présents dans les assets de votre projet.
Musique
La musique fonctionne comme Sound mais est conçue pour les pistes plus longues. La musique est diffusée en streaming plutôt que chargée entièrement en mémoire :
world.spawn(music=Music("theme", loop=True))La musique prend en charge les mêmes propriétés : loop, gain et pan.
L’audio en tant que components
Puisque l’audio est attaché aux entités, vous le gérez de la même manière que tout le reste :
# démarrer la musique de fond
bgm = world.spawn(name="bgm", music=Music("overworld", loop=True))
# l'arrêter plus tard
world.destroy(bgm)Cela s’intègre naturellement avec le modèle ECS — l’audio est simplement un component supplémentaire sur une entity, visible dans l’inspecteur de frames comme tout le reste.
Formats pris en charge
- Sons : WAV
- Musique : OGG Vorbis
Ajoutez des fichiers audio à votre projet via le gestionnaire d’assets dans Pyxen.