World > Sound

World > Sound#

API-Referenz#

class miniworlds.worlds.manager.sound_manager.SoundManager(app)[Quellcode]#

Verwaltet das Abspielen kurzer Soundeffekte für eine Welt.

Zugriff über world.sound.

Anders als world.music können Sounds sich überlagern und sind für kurze Effekte im Spiel gedacht.

Beispiele

world.sound.play("assets/explosion.wav")
world.sound.play("assets/jump.wav", volume=80)
is_playing(path)[Quellcode]#

Gibt zurück, ob der angegebene Sound gerade abgespielt wird.

Rückgabetyp:

bool

Parameter:

path – Pfad zum Sound.

Rückgabe:

True, wenn der Sound abgespielt wird.

Verursacht:

ValueError – Wenn der Pfad leer ist.

Beispiele

if world.sound.is_playing("sounds/explosion.wav"):
    world.sound.stop("sounds/explosion.wav")
is_registered(path)[Quellcode]#

Gibt zurück, ob ein Sound bereits registriert ist.

Rückgabetyp:

bool

Parameter:

path – Pfad zum Sound.

Rückgabe:

True, wenn der Sound registriert ist.

Verursacht:

ValueError – Wenn der Pfad leer ist.

Beispiele

if not world.sound.is_registered("sounds/explosion.wav"):
    world.sound.register("sounds/explosion.wav")
play(path, volume=100)[Quellcode]#

Spielt einen Sound ab.

Rückgabetyp:

None

Parameter:

  • path – Pfad zum Sound.

  • volume – Lautstärke zwischen 0 und 100.

Verursacht:

ValueError – Wenn der Pfad leer ist oder die Lautstärke außerhalb des gültigen Bereichs liegt.

Beispiele

world.sound.play("sounds/explosion.wav", volume=80)
register(path)[Quellcode]#

Registriert einen Sound zur späteren Verwendung.

Rückgabetyp:

None

Parameter:

path – Pfad zum Sound.

Verursacht:

ValueError – Wenn der Pfad leer ist.

Beispiele

world.sound.register("sounds/explosion.wav")
stop(path)[Quellcode]#

Stoppt einen abgespielten Sound.

Rückgabetyp:

None

Parameter:

path – Pfad zum Sound, der gestoppt werden soll.

Verursacht:

ValueError – Wenn der Pfad leer ist.

Beispiele

world.sound.stop("sounds/explosion.wav")
Inhalt