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.SND_APPLICATION

Параметр sound содержит псевдоним из реестра, относящийся к конкретному приложению. Этот флаг можно сочетать с флагом SND_ALIAS, чтобы указать псевдоним звука, определённый приложением.

winsound.MB_ICONASTERISK

Воспроизвести звук SystemDefault.

winsound.MB_ICONEXCLAMATION

Воспроизвести звук SystemExclamation.

winsound.MB_ICONHAND

Воспроизвести звук SystemHand.

winsound.MB_ICONQUESTION

Воспроизвести звук SystemQuestion.

winsound.MB_OK

Воспроизвести звук SystemDefault.