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() имя	Соответствующее имя звука в Панели управления
'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.