winsound — Interfaz de reproducción de sonido para Windows


El modulo winsound permite acceder a la maquinaria básica de reproducción de sonidos proporcionada por la plataformas Windows. Incluye funciones y varias constantes.

winsound.Beep(frequency, duration)

Hace sonar el altavoz del PC. El parámetro frequency especifica la frecuencia, en hercio (hz), de la señal de audio y debe estar en el rango de 37 a 32.767 hz. El parámetro duration especifica el numero de milisegundo de duración de la señal de audio. Si el sistema no puede hacer sonar el altavoz, se lanza RuntimeError.

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

El parámetro sound es el nombre de un archivo WAV. No lo uses con SND_ALIAS.

winsound.SND_ALIAS

El parámetro sound es un nombre de asociación de sonido del registro. Si el registro no contiene tal nombre, reproduce el sonido por defecto del sistema a menos que SND_NODEFAULT también se especifique. Si no se registra ningún sonido por defecto, se lanza RuntimeError. No lo uses con SND_FILENAME.

Todos los sistemas Win32 soportan al menos lo siguiente; la mayoría de los sistemas soportan muchos más:

PlaySound() name

Panel de control correspondiente nombre (name) del sonido

'SystemAsterisk'

Asterisco

'SystemExclamation'

Exclamación

'SystemExit'

Salir de Windows

'SystemHand'

Parada crítica

'SystemQuestion'

Pregunta

Por ejemplo:

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

Reproducir el sonido repetidamente. El flag SND_ASYNC también debe ser usada para evitar el bloqueo. No puede ser usada con SND_MEMORY.

winsound.SND_MEMORY

El parámetro sound de PlaySound() es una imagen de memoria de un archivo WAV, como un bytes-like object.

Nota

Este módulo no admite la reproducción desde una imagen de memoria de forma sincrónica, por lo que una combinación de este indicador y SND_ASYNC se lanza RuntimeError.

winsound.SND_PURGE

Detiene la reproducción de todas las instancias de un sonido específico.

Nota

Esta flag no esta soportado en las plataformas modernas de Windows.

winsound.SND_ASYNC

Retorna inmediatamente, permitiendo que los sonidos se reproduzcan asincrónicamente.

winsound.SND_NODEFAULT

Si no se puede encontrar el audio especificado, no reproduce el sonido predeterminado del sistema.

winsound.SND_NOSTOP

No interrumpe los sonidos que se están reproduciendo.

winsound.SND_NOWAIT

Retorna inmediatamente en caso de que el controlador de sonido está ocupado.

Nota

Esta flag no esta soportado en las plataformas modernas de Windows.

winsound.MB_ICONASTERISK

Reproduce el sonido SystemDefault.

winsound.MB_ICONEXCLAMATION

Reproduce el sonido SystemExclamation.

winsound.MB_ICONHAND

Reproduce el sonido SystemHand.

winsound.MB_ICONQUESTION

Reproduce el sonido SystemQuestion.

winsound.MB_OK

Reproduce el sonido SystemDefault.