winsound — Schnittstelle zur Sound-Wiedergabe für Windows

---

Das Modul winsound bietet Zugriff auf die grundlegenden Sound-Wiedergabemechanismen, die von Windows-Plattformen bereitgestellt werden. Es enthält Funktionen und mehrere Konstanten.

winsound.Beep(frequency, duration)

Gibt einen Piepton über den PC-Lautsprecher aus. Der Parameter frequency gibt die Frequenz des Tons in Hertz an und muss im Bereich von 37 bis 32.767 liegen. Der Parameter duration gibt die Dauer des Tons in Millisekunden an. Wenn das System keinen Piepton ausgeben kann, wird ein RuntimeError ausgelöst.

winsound.PlaySound(sound, flags)

Ruft die zugrunde liegende Funktion PlaySound() aus der Platform API auf. Der Parameter sound kann ein Dateiname, ein System-Sound-Alias, Audiodaten als bytes-ähnliches Objekt oder None sein. Seine Interpretation hängt vom Wert von flags ab, welches eine bitweise ODER-Kombination der unten beschriebenen Konstanten sein kann. Wenn der Parameter sound None ist, wird jeder aktuell spielende Wellenform-Sound gestoppt. Wenn das System einen Fehler meldet, wird ein RuntimeError ausgelöst.

winsound.MessageBeep(type=MB_OK)

Ruft die zugrunde liegende Funktion MessageBeep() aus der Platform API auf. Diese spielt einen Sound ab, wie er in der Registrierung angegeben ist. Das Argument type gibt an, welcher Sound abgespielt werden soll; mögliche Werte sind -1, MB_ICONASTERISK, MB_ICONEXCLAMATION, MB_ICONHAND, MB_ICONQUESTION und MB_OK, die alle unten beschrieben sind. Der Wert -1 erzeugt einen "einfachen Piepton"; dies ist die letzte Fallback-Option, wenn ein Sound anderweitig nicht abgespielt werden kann. Wenn das System einen Fehler meldet, wird ein RuntimeError ausgelöst.

winsound.SND_FILENAME

Der Parameter sound ist der Name einer WAV-Datei. Nicht zusammen mit SND_ALIAS verwenden.

winsound.SND_ALIAS

Der Parameter sound ist ein Sound-Zuordnungsname aus der Registrierung. Wenn die Registrierung keinen solchen Namen enthält, wird der Systemstandard-Sound abgespielt, es sei denn, SND_NODEFAULT ist ebenfalls angegeben. Wenn kein Standard-Sound registriert ist, wird ein RuntimeError ausgelöst. Nicht zusammen mit SND_FILENAME verwenden.

Alle Win32-Systeme unterstützen mindestens die folgenden; die meisten Systeme unterstützen viele mehr

PlaySound() name	Entsprechender Name des Sounds in der Systemsteuerung
'SystemAsterisk'	Asterisk
'SystemExclamation'	Ausrufezeichen
'SystemExit'	Windows beenden
'SystemHand'	Kritischer Stopp
'SystemQuestion'	Fragezeichen

Zum Beispiel

import winsound
# Play Windows exit sound.
winsound.PlaySound("SystemExit", winsound.SND_ALIAS)

# Probably play Windows default sound, if any is registered (because
# "*" probably isn't the registered name of any sound).
winsound.PlaySound("*", winsound.SND_ALIAS)

winsound.SND_LOOP

Spielt den Sound wiederholt ab. Das Flag SND_ASYNC muss ebenfalls verwendet werden, um Blockierung zu vermeiden. Kann nicht mit SND_MEMORY verwendet werden.

winsound.SND_MEMORY

Der Parameter sound für PlaySound() ist ein Speicherabbild einer WAV-Datei, als bytes-ähnliches Objekt.

Hinweis

Dieses Modul unterstützt die Wiedergabe aus einem Speicherabbild nicht asynchron, sodass eine Kombination dieses Flags und von SND_ASYNC einen RuntimeError auslöst.

winsound.SND_PURGE

Stoppt die Wiedergabe aller Instanzen des angegebenen Sounds.

Hinweis

Dieses Flag wird auf modernen Windows-Plattformen nicht unterstützt.

winsound.SND_ASYNC

Kehrt sofort zurück und erlaubt die asynchrone Wiedergabe von Sounds.

winsound.SND_NODEFAULT

Wenn der angegebene Sound nicht gefunden werden kann, wird nicht der Systemstandard-Sound abgespielt.

winsound.SND_NOSTOP

Unterbricht keine aktuell spielenden Sounds.

winsound.SND_NOWAIT

Kehrt sofort zurück, wenn der Soundtreiber beschäftigt ist.

Hinweis

Dieses Flag wird auf modernen Windows-Plattformen nicht unterstützt.

winsound.SND_APPLICATION

Der Parameter sound ist ein anwendungsspezifischer Alias in der Registrierung. Dieses Flag kann mit dem Flag SND_ALIAS kombiniert werden, um einen anwendungsdefinierten Sound-Alias anzugeben.

winsound.SND_SENTRY

Löst ein SoundSentry-Ereignis aus, wenn der Sound abgespielt wird.

Hinzugefügt in Version 3.14.

winsound.SND_SYNC

Der Sound wird synchron abgespielt. Dies ist das Standardverhalten.

Hinzugefügt in Version 3.14.

winsound.SND_SYSTEM

Weist den Sound der Audiositzung für Systembenachrichtigungstöne zu.

Hinzugefügt in Version 3.14.

winsound.MB_ICONASTERISK

Spielt den Sound SystemDefault ab.

winsound.MB_ICONEXCLAMATION

Spielt den Sound SystemExclamation ab.

winsound.MB_ICONHAND

Spielt den Sound SystemHand ab.

winsound.MB_ICONQUESTION

Spielt den Sound SystemQuestion ab.

winsound.MB_OK

Spielt den Sound SystemDefault ab.

winsound.MB_ICONERROR

Spielt den Sound SystemHand ab.

Hinzugefügt in Version 3.14.

winsound.MB_ICONINFORMATION

Spielt den Sound SystemDefault ab.

Hinzugefügt in Version 3.14.

winsound.MB_ICONSTOP

Spielt den Sound SystemHand ab.

Hinzugefügt in Version 3.14.

winsound.MB_ICONWARNING

Spielt den Sound SystemExclamation ab.

Hinzugefügt in Version 3.14.