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 генерирует «простой звуковой сигнал»; это последний вариант по умолчанию, если звук не может быть воспроизведён иначе. Если система указывает на ошибку, будет поднято исключение RuntimeError.

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.