> **Источник:** https://python-all.ru/3.0/library/winsound.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# `winsound` – интерфейс воспроизведения звука для Windows

*Платформы:* Windows

Модуль `winsound` предоставляет доступ к основным механизмам воспроизведения звука, предоставляемым платформами Windows. Он включает функции и несколько констант.

#### `[winsound.Beep]winsound.Beep(frequency, duration)`

Beep the PC’s speaker. The

*frequency*

parameter specifies frequency, in hertz, of the sound, and must be in the range 37 through 32,767. The

*duration*

parameter specifies the number of milliseconds the sound should last. If the system is not able to beep the speaker,

[`RuntimeError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.RuntimeError)

is raised.

#### `[winsound.PlaySound]winsound.PlaySound(sound, flags)`

Вызов базовой функции

`PlaySound`

из Platform API. Параметр

*sound*

может быть именем файла, аудиоданными в виде строки или

`None`

. Его интерпретация зависит от значения

*flags*

, которое может быть комбинацией констант, описанных ниже (побитовое ИЛИ). Если параметр

*sound*

равен

`None`

, воспроизведение любого текущего звука останавливается. Если система указывает на ошибку, возбуждается

[`RuntimeError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.RuntimeError)

.

#### `[winsound.MessageBeep]winsound.MessageBeep([type=MB_OK])`

Вызов базовой функции

`MessageBeep`

из Platform API. Она воспроизводит звук в соответствии с реестром. Аргумент

*type*

задаёт, какой звук воспроизводить; возможные значения:

`-1`

,

`MB_ICONASTERISK`

,

`MB_ICONEXCLAMATION`

,

`MB_ICONHAND`

,

`MB_ICONQUESTION`

и

`MB_OK`

, все они описаны ниже. Значение

`-1`

вызывает «простой звуковой сигнал»; это последний вариант, если иначе звук воспроизвести не удаётся.

#### `[winsound.SND_FILENAME]winsound.SND_FILENAME`

The

*sound*

parameter is the name of a WAV file. Do not use with

[`SND_ALIAS`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_ALIAS)

.

#### `[winsound.SND_ALIAS]winsound.SND_ALIAS`

The *sound* parameter is a sound association name from the registry. If the registry contains no such name, play the system default sound unless [`SND_NODEFAULT`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_NODEFAULT) is also specified. If no default sound is registered, raise [`RuntimeError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.RuntimeError). Do not use with [`SND_FILENAME`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_FILENAME).

Все системы Win32 поддерживают как минимум следующее; большинство систем поддерживают ещё много других:

| [`PlaySound()`](https://python-all.ru/3.0/library/winsound.html#winsound.PlaySound) *name* | Соответствующее название звука в панели управления |
| --- | --- |
| `'SystemAsterisk'` | Звёздочка |
| `'SystemExclamation'` | Восклицание |
| `'SystemExit'` | Выход из Windows |
| `'SystemHand'` | Критическая остановка |
| `'SystemQuestion'` | Вопрос |

Например:

```python
import winsound
# Воспроизвести звук выхода из Windows.
winsound.PlaySound("SystemExit", winsound.SND_ALIAS)

# Вероятно, воспроизводит звук Windows по умолчанию, если таковой зарегистрирован (поскольку
# "*" скорее всего не является зарегистрированным именем какого-либо звука).
winsound.PlaySound("*", winsound.SND_ALIAS)
```

#### `[winsound.SND_LOOP]winsound.SND_LOOP`

Play the sound repeatedly. The

[`SND_ASYNC`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_ASYNC)

flag must also be used to avoid blocking. Cannot be used with

[`SND_MEMORY`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_MEMORY)

.

#### `[winsound.SND_MEMORY]winsound.SND_MEMORY`

The *sound* parameter to [`PlaySound()`](https://python-all.ru/3.0/library/winsound.html#winsound.PlaySound) is a memory image of a WAV file, as a string.

> **Примечание**
>
> This module does not support playing from a memory image asynchronously, so a combination of this flag and [`SND_ASYNC`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_ASYNC) will raise [`RuntimeError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.RuntimeError).

#### `[winsound.SND_PURGE]winsound.SND_PURGE`

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

> **Примечание**
>
> Этот флаг не поддерживается на современных платформах Windows.

#### `[winsound.SND_ASYNC]winsound.SND_ASYNC`

Возвращает управление немедленно, позволяя звукам воспроизводиться асинхронно.

#### `[winsound.SND_NODEFAULT]winsound.SND_NODEFAULT`

Если указанный звук не найден, не воспроизводить системный звук по умолчанию.

#### `[winsound.SND_NOSTOP]winsound.SND_NOSTOP`

Не прерывать звуки, воспроизводимые в данный момент.

#### `[winsound.SND_NOWAIT]winsound.SND_NOWAIT`

Возвращать управление немедленно, если звуковой драйвер занят.

#### `[winsound.MB_ICONASTERISK]winsound.MB_ICONASTERISK`

Воспроизвести звук

`SystemDefault`

.

#### `[winsound.MB_ICONEXCLAMATION]winsound.MB_ICONEXCLAMATION`

Воспроизвести звук

`SystemExclamation`

.

#### `[winsound.MB_ICONHAND]winsound.MB_ICONHAND`

Воспроизвести звук

`SystemHand`

.

#### `[winsound.MB_ICONQUESTION]winsound.MB_ICONQUESTION`

Воспроизвести звук

`SystemQuestion`

.

#### `[winsound.MB_OK]winsound.MB_OK`

Воспроизвести звук

`SystemDefault`

.