Advertencia

¡Ayúdanos a traducir la documentación oficial de Python al Español! Puedes encontrar más información en Como contribuir. Ayuda a acercar Python a más personas de habla hispana.

:mod:”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)

Llama a la función responsable de PlaySound() desde el API de la plataforma. El parámetro sound puede ser un nombre de archivo, un alias de sonido del sistema, datos de audio como un bytes-like object , o None. Su interpretación depende del valor de flags, que puede ser una combinación ORed de las constantes descritas a continuación. Si el parámetro de sound es None, cualquier sonido de forma de onda que se esté reproduciendo en ese momento se detiene. Si el sistema indica un error, se lanza RuntimeError` .

winsound.MessageBeep(type=MB_OK)

Llama a la función responsable de MensajeBeep() de la API de la plataforma. Esto reproduce un sonido como se especifica en el registro. El argumento type especifica qué sonido se reproduce; los valores posibles son -1, MB_ICONASTERISK, MB_ICONEXCLAMATION, MB_ICONHAND, MB_ICONQUESTION, y MB_OK, todos descritos a continuación. El valor «1» produce un «simple pitido»; este es el último recurso si un sonido no puede ser reproducido de otra manera. Si el sistema indica un error, se lanza RuntimeError.

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.