winsound — Interface de reprodução de som para Windows

---

O módulo winsound fornece acesso ao mecanismo básico de reprodução de som fornecido pelas plataformas Windows. Inclui funções e várias constantes.

winsound.Beep(frequency, duration)

Emite um bipe no alto-falante do PC. O parâmetro frequency especifica a frequência, em hertz, do som e deve estar no intervalo de 37 a 32.767. O parâmetro duration especifica o número de milissegundos que o som deve durar. Se o sistema não conseguir emitir um bipe no alto-falante, RuntimeError é levantado.

winsound.PlaySound(sound, flags)

Call the underlying PlaySound() function from the Platform API. The sound parameter may be a filename, a system sound alias, audio data as a bytes-like object, or None. Its interpretation depends on the value of flags, which can be a bitwise ORed combination of the constants described below. If the sound parameter is None, any currently playing waveform sound is stopped. If the system indicates an error, RuntimeError is raised.

winsound.MessageBeep(type=MB_OK)

Call the underlying MessageBeep() function from the Platform API. This plays a sound as specified in the registry. The type argument specifies which sound to play; possible values are -1, MB_ICONASTERISK, MB_ICONEXCLAMATION, MB_ICONHAND, MB_ICONQUESTION, and MB_OK, all described below. The value -1 produces a “simple beep”; this is the final fallback if a sound cannot be played otherwise. If the system indicates an error, RuntimeError is raised.

winsound.SND_FILENAME

O parâmetro sound é o nome de um arquivo WAV. Não use com SND_ALIAS.

winsound.SND_ALIAS

O parâmetro sound é um nome de associação de som do registro. Se o registro não contiver tal nome, reproduza o som padrão do sistema, a menos que SND_NODEFAULT também seja especificado. Se nenhum som padrão for registrado, levanta RuntimeError. Não use com SND_FILENAME.

Todos os sistemas Win32 oferecem suporte a pelo menos o seguinte; a maioria dos sistemas oferecem suporte a muito mais:

name PlaySound()	Nome do som correspondente no Painel de Controle
'SystemAsterisk'	Asterisco
'SystemExclamation'	Exclamação
'SystemExit'	Logoff do Windows
'SystemHand'	Parada crítica
'SystemQuestion'	Pergunta

Por exemplo:

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

Reproduz o som repetidamente. O sinalizador SND_ASYNC também deve ser usado para evitar bloqueio. Não pode ser usado com SND_MEMORY.

winsound.SND_MEMORY

O parâmetro sound para PlaySound() é uma imagem de memória de um arquivo WAV, como um objeto bytes ou similar.

Nota

Este módulo não oferece suporte à reprodução de uma imagem de memória de forma assíncrona, portanto, uma combinação deste sinalizador e SND_ASYNC levantará RuntimeError.

winsound.SND_PURGE

Para de reproduzir todas as instâncias do som especificado.

Nota

Não há suporte a este sinalizador em plataformas Windows modernas.

winsound.SND_ASYNC

Retorna imediatamente, permitindo que os sons sejam reproduzidos de forma assíncrona.

winsound.SND_NODEFAULT

Se o som especificado não for encontrado, o som padrão do sistema não será reproduzido.

winsound.SND_NOSTOP

Não interrompe os sons que estão sendo reproduzidos.

winsound.SND_NOWAIT

Retorna imediatamente se o driver de som estiver ocupado.

Nota

Não há suporte a este sinalizador em plataformas Windows modernas.

winsound.MB_ICONASTERISK

Reproduz o som SystemDefault.

winsound.MB_ICONEXCLAMATION

Reproduz o som SystemExclamation.

winsound.MB_ICONHAND

Reproduz o som SystemHand.

winsound.MB_ICONQUESTION

Reproduz o som SystemQuestion.

winsound.MB_OK

Reproduz o som SystemDefault.