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

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

winsound.Beep(frequency, duration)

Проигрывает звуковой сигнал на динамике ПК. Параметр frequency задаёт частоту звука в герцах и должен находиться в диапазоне от 37 до 32 767. Параметр 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.