This document is for an old version of Python that is no longer supported. You should upgrade, and read the Python documentation for the current stable release.

# :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`.