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

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

winsound.Beep(frequency, duration)

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

Новая версия с 1.6.

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

Новая версия с 2.3.

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.