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

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

Доступность: Windows.

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

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

Примечание

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

Добавлено в версии 3.14.

winsound.SND_SYNC: Звук воспроизводится синхронно. Это поведение по умолчанию.

Добавлено в версии 3.14.

winsound.SND_SYSTEM: Назначить звук аудиосеансу для системных звуков уведомлений.

Добавлено в версии 3.14.

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

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

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

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

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

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

Добавлено в версии 3.14.

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

Добавлено в версии 3.14.

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

Добавлено в версии 3.14.

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

Добавлено в версии 3.14.