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

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

winsound.Beep(frequency, duration)

Проигрывает звуковой сигнал на динамиках компьютера. Параметр frequency определяет частоту звука в герцах (от 37 до 32767). Параметр duration задает продолжительность сигнала в миллисекундах. Если система не может воспроизвести звуковой сигнал, возникает исключение RuntimeError.

winsound.PlaySound(sound, flags)

Вызывает функцию PlaySound() из API платформы. Параметр sound может представлять имя файла, аудиоданные в виде строки или None. Его интерпретация зависит от значения flags, которое может быть битовым ИЛИ-комбинацией констант, описанных ниже. Если параметр sound является None, любой текущий воспроизводимый звук приостанавливается. Если система указывает на ошибку, возникает исключение RuntimeError.

winsound.MessageBeep(type=MB_OK)

Вызывает функцию MessageBeep() из API платформы. Это воспроизводит звук, как указано в реестре. Аргумент type определяет, какой звук воспроизвести; возможные значения — -1, MB_ICONASTERISK, MB_ICONEXCLAMATION, MB_ICONHAND, MB_ICONQUESTION, и MB_OK, все описаны ниже. Значение -1 производит «простой звуковой сигнал»; это последний вариант, если звук по другим причинам нельзя воспроизвести.

winsound.SND_FILENAME

Параметр sound — имя файла WAV. Не использовать с SND_ALIAS.

winsound.SND_ALIAS

Параметр sound — имя ассоциации звука из реестра. Если в реестре нет такого имени, воспроизводится системный звуковой сигнал по умолчанию, если не указан также SND_NODEFAULT. Если звуковой сигнал по умолчанию не зарегистрирован, возникает исключение RuntimeError. Не использовать с SND_FILENAME.

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

PlaySound() name	Соответствующее имя звукового сигнала Панели управления
'SystemAsterisk'	Звездочка
'SystemExclamation'	Восклицательный знак
'SystemExit'	Выход из 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-файла в памяти в виде строки.

Примечание

Этот модуль не поддерживает асинхронное воспроизведение из образа в памяти, поэтому комбинация этого флага и SND_ASYNC вызовет исключение RuntimeError.

winsound.SND_PURGE

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

Примечание

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

winsound.SND_ASYNC

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

winsound.SND_NODEFAULT

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

winsound.SND_NOSTOP

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

winsound.SND_NOWAIT

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

Примечание

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

winsound.MB_ICONASTERISK

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

winsound.MB_ICONEXCLAMATION

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

winsound.MB_ICONHAND

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

winsound.MB_ICONQUESTION

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

winsound.MB_OK

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