Audio
Pyxen unterstützt zwei Arten von Audio: Sounds für kurze Effekte und Music für längere Tracks. Beide werden als Komponenten an Entitäten angehängt.
Sounds
Ein Sound ist ein kurzer Audioclip — ein Sprung, ein Treffer, eine Münze aufheben. Du spielst einen Sound ab, indem du eine Entität mit einer Sound-Komponente erzeugst:
world.spawn(sound=Sound("jump"))Der Sound wird sofort abgespielt. Du kannst Wiedergabeeigenschaften steuern:
world.spawn(sound=Sound("laser", loop=True, gain=0.5, pan=-0.5))| Eigenschaft | Bedeutung |
|---|---|
loop | Ob der Sound wiederholt wird |
gain | Lautstärke (0.0 = stumm, 1.0 = voll) |
pan | Stereoposition (-1.0 = links, 0.0 = Mitte, 1.0 = rechts) |
Sounds werden aus Audiodateien in deinen Projekt-Assets geladen.
Music
Music funktioniert wie Sound, ist aber für längere Tracks gedacht. Music wird gestreamt statt komplett in den Speicher geladen:
world.spawn(music=Music("theme", loop=True))Music unterstützt dieselben Eigenschaften: loop, gain und pan.
Audio als Komponenten
Weil Audio an Entitäten angehängt ist, verwaltest du es auf dieselbe Weise wie alles andere:
# Hintergrundmusik starten
bgm = world.spawn(name="bgm", music=Music("overworld", loop=True))
# später stoppen
world.destroy(bgm)Das fügt sich natürlich in das ECS-Modell ein — Audio ist einfach eine weitere Komponente auf einer Entität, sichtbar im Frame-Inspektor wie alles andere.
Unterstützte Formate
- Sounds: WAV
- Music: OGG Vorbis
Füge Audiodateien über den Asset-Manager in Pyxen zu deinem Projekt hinzu.