winsound — Sound-playing interface for Windows

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

winsound.Beep(frequency, duration)

Подати звуковий сигнал у динамік ПК. Параметр frequency визначає частоту звуку в герцах і має бути в діапазоні від 37 до 32 767. Параметр тривалість визначає кількість мілісекунд, протягом якої має тривати звук. Якщо система не може подати звуковий сигнал у динамік, виникає RuntimeError.

winsound.PlaySound(sound, flags)

Call the underlying PlaySound() function from the Platform API. The sound parameter may be a filename, a system sound alias, audio data as a bytes-like object, or None. Its interpretation depends on the value of flags, which can be a bitwise ORed combination of the constants described below. If the sound parameter is None, any currently playing waveform sound is stopped. If the system indicates an error, RuntimeError is raised.

winsound.MessageBeep(type=MB_OK)

Call the underlying MessageBeep() function from the Platform API. This plays a sound as specified in the registry. The type argument specifies which sound to play; possible values are -1, MB_ICONASTERISK, MB_ICONEXCLAMATION, MB_ICONHAND, MB_ICONQUESTION, and MB_OK, all described below. The value -1 produces a «simple beep»; this is the final fallback if a sound cannot be played otherwise. If the system indicates an error, RuntimeError is raised.

winsound.SND_FILENAME

Параметр sound — це ім’я файлу WAV. Не використовуйте з SND_ALIAS.

winsound.SND_ALIAS

Параметр sound — це ім’я звукової асоціації з реєстру. Якщо реєстр не містить такої назви, відтворюйте системний звук за замовчуванням, якщо також не вказано SND_NODEFAULT. Якщо стандартний звук не зареєстровано, викликайте RuntimeError. Не використовуйте з SND_FILENAME.

Усі системи Win32 підтримують щонайменше наступне; більшість систем підтримують набагато більше:

PlaySound() назва

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

'SystemAsterisk'

Зірочка

'SystemExclamation'

Вигук

'Системний вихід'

Вийдіть з 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-like object.

Примітка

Цей модуль не підтримує асинхронне відтворення з образу пам’яті, тому комбінація цього прапорця та 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.