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

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

winsound.Beep(frequency, duration)

Издает звуковой сигнал на динамике компьютера. Параметр frequency задает частоту звука в герцах и должен быть в диапазоне от 37 до 32767. Параметр 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 звук.