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.