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

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

winsound.Beep(frequency, duration)

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

winsound.PlaySound(sound, flags)

Вызвать базовую функцию PlaySound() из API платформы. Параметр sound может быть именем файла, псевдонимом системного звука, аудиоданными в виде объекта, подобного bytes или None. Его интерпретация зависит от значения flags, которым может быть побитовое ИЛИ констант, описанных ниже. Если параметр sound равен None, воспроизведение любого текущего звука в формате waveform прекращается. Если система сообщает об ошибке, возникает исключение 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-файла в памяти в виде объекта, подобного bytes.

Примечание

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