# `winsound` — Sound-playing interface for Windows

Source code: PC/winsound.c

The `winsound` module provides access to the basic sound-playing machinery provided by Windows platforms. It includes functions and several constants.

Availability: Windows.

## Functions

winsound.Beep(frequency, duration)

  Подати звуковий сигнал у динамік ПК. Параметр frequency визначає частоту звуку в герцах і має бути в діапазоні від 37 до 32 767. Параметр тривалість визначає кількість мілісекунд, протягом якої має тривати звук. Якщо система не може подати звуковий сигнал у динамік, виникає `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.

## Constants

winsound.SND_FILENAME

  Параметр sound — це ім’я файлу WAV. Не використовуйте з `SND_ALIAS`.

winsound.SND_ALIAS

  Параметр sound — це ім’я звукової асоціації з реєстру. Якщо реєстр не містить такої назви, відтворюйте системний звук за замовчуванням, якщо також не вказано `SND_NODEFAULT`. Якщо стандартний звук не зареєстровано, викликайте `RuntimeError`. Не використовуйте з `SND_FILENAME`.

  Усі системи Win32 підтримують щонайменше наступне; більшість систем підтримують набагато більше:

  `PlaySound()` назва | Відповідна назва звуку панелі керування
  --- | ---
  `'SystemAsterisk'` | Зірочка
  `'SystemExclamation'` | Вигук
  `'Системний вихід'` | Вийдіть з Windows
  `'SystemHand'` | Критична зупинка
  `'SystemQuestion'` | Питання

  Наприклад:

      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

  Повторюйте звук. Прапорець `SND_ASYNC` також слід використовувати, щоб уникнути блокування. Не можна використовувати з `SND_MEMORY`.

winsound.SND_MEMORY

  Параметр sound для `PlaySound()` — це образ пам’яті файлу WAV, як bytes-like object.

  Примітка

  Цей модуль не підтримує асинхронне відтворення з образу пам’яті, тому комбінація цього прапорця та `SND_ASYNC` викличе `RuntimeError`.

winsound.SND_PURGE

  Зупинити відтворення всіх екземплярів зазначеного звуку.

  Примітка

  Цей прапорець не підтримується на сучасних платформах Windows.

winsound.SND_ASYNC

  Поверніться негайно, дозволяючи звукам відтворюватися асинхронно.

winsound.SND_NODEFAULT

  Якщо вказаний звук не знайдено, не відтворюйте системний звук за замовчуванням.

winsound.SND_NOSTOP

  Не переривати звуки, які зараз відтворюються.

winsound.SND_NOWAIT

  Негайно поверніться, якщо звуковий драйвер зайнятий.

  Примітка

  Цей прапорець не підтримується на сучасних платформах Windows.

winsound.SND_APPLICATION

  The sound parameter is an application-specific alias in the registry. This flag can be combined with the `SND_ALIAS` flag to specify an application-defined sound alias.

winsound.SND_SENTRY

  Triggers a SoundSentry event when the sound is played.

  Added in version 3.14.

winsound.SND_SYNC

  The sound is played synchronously. This is the default behavior.

  Added in version 3.14.

winsound.SND_SYSTEM

  Assign the sound to the audio session for system notification sounds.

  Added in version 3.14.

winsound.MB_ICONASTERISK

  Відтворіть звук `SystemDefault`.

winsound.MB_ICONEXCLAMATION

  Відтворіть звук `SystemExclamation`.

winsound.MB_ICONHAND

  Відтворіть звук `SystemHand`.

winsound.MB_ICONQUESTION

  Відтворіть звук `SystemQuestion`.

winsound.MB_OK

  Відтворіть звук `SystemDefault`.

winsound.MB_ICONERROR

  Відтворіть звук `SystemHand`.

  Added in version 3.14.

winsound.MB_ICONINFORMATION

  Відтворіть звук `SystemDefault`.

  Added in version 3.14.

winsound.MB_ICONSTOP

  Відтворіть звук `SystemHand`.

  Added in version 3.14.

winsound.MB_ICONWARNING

  Відтворіть звук `SystemExclamation`.

  Added in version 3.14.