winsound — Gränssnitt för ljuduppspelning i Windows

Modulen winsound ger tillgång till det grundläggande ljudspelningsmaskineri som Windows-plattformar tillhandahåller. Den innehåller funktioner och flera konstanter.

winsound.Beep(frequency, duration)

Pipa i datorns högtalare. Parametern frequency anger ljudets frekvens i hertz och måste ligga inom intervallet 37 till 32.767. Parametern duration anger antalet millisekunder som ljudet ska vara. Om systemet inte kan avge ett pip till högtalaren, avges RuntimeError.

winsound.PlaySound(sound, flags)

Anropar den underliggande PlaySound()-funktionen från Platform API. Parametern sound kan vara ett filnamn, ett alias för systemljud, ljuddata som ett bytesliknande objekt eller None. Dess tolkning beror på värdet av flags, som kan vara en bitvis ELLER-kombination av de konstanter som beskrivs nedan. Om parametern sound är None stoppas alla vågformsljud som spelas för närvarande. Om systemet indikerar ett fel, aktiveras RuntimeError.

winsound.MessageBeep(type=MB_OK)

Anropa den underliggande funktionen MessageBeep() från Platform API. Detta spelar upp ett ljud som specificeras i registret. Argumentet type anger vilket ljud som ska spelas upp; möjliga värden är \-1, MB_ICONASTERISK, MB_ICONEXCLAMATION, MB_ICONHAND, MB_ICONQUESTION och MB_OK, alla beskrivna nedan. Värdet \-1 ger ett ”enkelt pip”; detta är den sista utvägen om ett ljud inte kan spelas upp på annat sätt. Om systemet indikerar ett fel utlöses RuntimeError.

winsound.SND_FILENAME

Parametern sound är namnet på en WAV-fil. Används inte med SND_ALIAS.

winsound.SND_ALIAS

Parametern sound är ett namn på en ljudassociation från registret. Om registret inte innehåller något sådant namn spelas systemets standardljud upp om inte SND_NODEFAULT också har angetts. Om inget standardljud är registrerat, uppstår RuntimeError. Använd inte med SND_FILENAME.

Alla Win32-system har stöd för åtminstone följande; de flesta system har stöd för många fler:

PlaySound() namn

Motsvarande kontrollpanel Ljudnamn

'SystemAsterisk'

Asterisk

'SystemExclamation'

Utrop

'SystemExit'

Avsluta Windows

'SystemHand'

Kritiskt stopp

'SystemQuestion'

Fråga

Till exempel:

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

Spela upp ljudet upprepade gånger. Flaggan SND_ASYNC måste också användas för att undvika blockering. Kan inte användas med SND_MEMORY.

winsound.SND_MEMORY

Parametern sound till PlaySound() är en minnesbild av en WAV-fil, som ett bytesliknande objekt.

Anteckning

Denna modul stöder inte asynkron uppspelning från en minnesbild, så en kombination av denna flagga och SND_ASYNC kommer att ge upphov till RuntimeError.

winsound.SND_PURGE

Sluta spela upp alla instanser av det angivna ljudet.

Anteckning

Denna flagga stöds inte på moderna Windows-plattformar.

winsound.SND_ASYNC

Returnera omedelbart, så att ljud kan spelas upp asynkront.

winsound.SND_NODEFAULT

Om det angivna ljudet inte kan hittas, spela inte upp systemets standardljud.

winsound.SND_NOSTOP

Avbryt inte pågående ljud.

winsound.SND_NOWAIT

Återvänd omedelbart om ljuddrivrutinen är upptagen.

Anteckning

Denna flagga stöds inte på moderna Windows-plattformar.

winsound.SND_APPLICATION

Parametern sound är ett applikationsspecifikt alias i registret. Denna flagga kan kombineras med flaggan SND_ALIAS för att ange ett programdefinierat ljudalias.

winsound.SND_SENTRY

Utlöser en SoundSentry-händelse när ljudet spelas upp.

Tillagd i version 3.14.

winsound.SND_SYNC

Ljudet spelas upp synkront. Detta är standardbeteendet.

Tillagd i version 3.14.

winsound.SND_SYSTEM

Tilldela ljudet till ljudsessionen för systemaviseringsljud.

Tillagd i version 3.14.

winsound.MB_ICONASTERISK

Spela upp ljudet SystemDefault.

winsound.MB_ICONEXCLAMATION

Spela upp ljudet SystemExclamation.

winsound.MB_ICONHAND

Spela upp ljudet SystemHand.

winsound.MB_ICONQUESTION

Spela upp ljudet SystemQuestion.

winsound.MB_OK

Spela upp ljudet SystemDefault.

winsound.MB_ICONERROR

Spela upp ljudet SystemHand.

Tillagd i version 3.14.

winsound.MB_ICONINFORMATION

Spela upp ljudet SystemDefault.

Tillagd i version 3.14.

winsound.MB_ICONSTOP

Spela upp ljudet SystemHand.

Tillagd i version 3.14.

winsound.MB_ICONWARNING

Spela upp ljudet SystemExclamation.

Tillagd i version 3.14.