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

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

winsound.Beep(frequency, duration)

Подати звуковий сигнал у динамік ПК. Параметр frequency визначає частоту звуку в герцах і має бути в діапазоні від 37 до 32 767. Параметр тривалість визначає кількість мілісекунд, протягом якої має тривати звук. Якщо система не може подати звуковий сигнал у динамік, виникає 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() назва

Відповідна назва звуку панелі керування

'SystemAsterisk'

Зірочка

'SystemExclamation'

Вигук

'SystemExit'

Вийдіть з Windows

'SystemHand'

Критична зупинка

'SystemQuestion'

Питання

Dla przykładu:

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-like object.

Informacja

Цей модуль не підтримує асинхронне відтворення з образу пам’яті, тому комбінація цього прапорця та SND_ASYNC викличе RuntimeError.

winsound.SND_PURGE

Зупинити відтворення всіх екземплярів зазначеного звуку.

Informacja

Цей прапорець не підтримується на сучасних платформах Windows.

winsound.SND_ASYNC

Поверніться негайно, дозволяючи звукам відтворюватися асинхронно.

winsound.SND_NODEFAULT

Якщо вказаний звук не знайдено, не відтворюйте системний звук за замовчуванням.

winsound.SND_NOSTOP

Не переривати звуки, які зараз відтворюються.

winsound.SND_NOWAIT

Негайно поверніться, якщо звуковий драйвер зайнятий.

Informacja

Цей прапорець не підтримується на сучасних платформах Windows.

winsound.SND_APPLICATION

O parâmetro sound é um apelido específico da aplicação no registro. Este sinalizador pode ser combinado com o sinalizador SND_ALIAS para especificar um apelido de som definido pela aplicação.

winsound.MB_ICONASTERISK

Відтворіть звук SystemDefault.

winsound.MB_ICONEXCLAMATION

Відтворіть звук SystemExclamation.

winsound.MB_ICONHAND

Відтворіть звук SystemHand.

winsound.MB_ICONQUESTION

Відтворіть звук SystemQuestion.

winsound.MB_OK

Відтворіть звук SystemDefault.