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

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

winsound.Beep(frequency, duration)

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

winsound.PlaySound(sound, flags)

Вызывает функцию PlaySound() из API платформы. Параметр sound может быть именем файла, псевдонимом системного звука, данными аудио в формате bytes-like object или 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 в памяти в формате bytes-like object.

Примечание

Этот модуль не поддерживает асинхронное воспроизведение из образа памяти, поэтому комбинация этого флага и 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.