`winsound.md`

118 строк · 7.7 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/2.7/library/winsound.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 35.4. [`winsound`](https://python-all.ru/2.7/library/winsound.html#module-winsound) – Интерфейс для воспроизведения звука в Windows89Новое в версии 1.5.2.1011Модуль [`winsound`](https://python-all.ru/2.7/library/winsound.html#module-winsound) предоставляет доступ к базовым механизмам воспроизведения звука, предоставляемым платформами Windows. Он включает функции и несколько констант.1213#### `winsound.Beep(frequency, duration)`1415Воспроизводит звуковой сигнал через динамик ПК. Параметр *frequency* задаёт частоту звука в герцах и должен быть в диапазоне от 37 до 32 767. Параметр *duration* задаёт продолжительность звука в миллисекундах. Если системе не удаётся воспроизвести сигнал, возбуждается [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError).1617Новое в версии 1.6.1819#### `winsound.PlaySound(sound, flags)`2021Вызывает базовую функцию `PlaySound()` из Platform API. Параметр *sound* может быть именем файла, аудиоданными в виде строки или `None`. Его интерпретация зависит от значения *flags*, которое может быть комбинацией констант, описанных ниже, объединённых побитовым ИЛИ. Если параметр *sound* равен `None`, воспроизведение текущего звука останавливается. Если система сообщает об ошибке, возбуждается [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError).2223#### `winsound.MessageBeep([type=MB_OK])`2425Вызывает базовую функцию `MessageBeep()` из Platform API. Проигрывает звук, указанный в реестре. Аргумент *type* задаёт, какой звук проигрывать; возможные значения: `-1`, `MB_ICONASTERISK`, `MB_ICONEXCLAMATION`, `MB_ICONHAND`, `MB_ICONQUESTION` и `MB_OK` – все описаны ниже. Значение `-1` выдаёт «простой звуковой сигнал»; это последняя запасная опция, если звук иначе воспроизвести не удаётся.2627Новое в версии 2.3.2829#### `winsound.SND_FILENAME`3031Параметр *sound* – это имя WAV-файла. Не используйте вместе с [`SND_ALIAS`](https://python-all.ru/2.7/library/winsound.html#winsound.SND_ALIAS).3233#### `winsound.SND_ALIAS`3435Параметр *sound* – это имя звуковой ассоциации из реестра. Если в реестре нет такого имени, воспроизводится системный звук по умолчанию, если только не указан [`SND_NODEFAULT`](https://python-all.ru/2.7/library/winsound.html#winsound.SND_NODEFAULT). Если звук по умолчанию не зарегистрирован, возбуждается [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError). Не используйте вместе с [`SND_FILENAME`](https://python-all.ru/2.7/library/winsound.html#winsound.SND_FILENAME).3637Все системы Win32 поддерживают как минимум следующее; большинство систем поддерживают ещё много других:3839| [`PlaySound()`](https://python-all.ru/2.7/library/winsound.html#winsound.PlaySound) *название* | Соответствующее название звука в панели управления |40| --- | --- |41| `'SystemAsterisk'` | Звёздочка |42| `'SystemExclamation'` | Восклицание |43| `'SystemExit'` | Выход из Windows |44| `'SystemHand'` | Критическая остановка |45| `'SystemQuestion'` | Вопрос |4647Например:4849```python50import winsound51# Воспроизвести звук выхода из Windows.52winsound.PlaySound("SystemExit", winsound.SND_ALIAS)5354# Вероятно, воспроизводит звук Windows по умолчанию, если таковой зарегистрирован (поскольку55# "*" скорее всего не является зарегистрированным именем какого-либо звука).56winsound.PlaySound("*", winsound.SND_ALIAS)57```5859#### `winsound.SND_LOOP`6061Воспроизводит звук повторно. Также необходимо использовать флаг [`SND_ASYNC`](https://python-all.ru/2.7/library/winsound.html#winsound.SND_ASYNC), чтобы избежать блокировки. Нельзя использовать с [`SND_MEMORY`](https://python-all.ru/2.7/library/winsound.html#winsound.SND_MEMORY).6263#### `winsound.SND_MEMORY`6465Параметр *sound* для [`PlaySound()`](https://python-all.ru/2.7/library/winsound.html#winsound.PlaySound) представляет собой образ WAV-файла в памяти, в виде строки.6667> **Примечание**68>69> Этот модуль не поддерживает асинхронное воспроизведение из образа в памяти, поэтому комбинация этого флага и [`SND_ASYNC`](https://python-all.ru/2.7/library/winsound.html#winsound.SND_ASYNC) вызовет [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError).7071#### `winsound.SND_PURGE`7273Останавливает воспроизведение всех экземпляров указанного звука.7475> **Примечание**76>77> Этот флаг не поддерживается на современных платформах Windows.7879#### `winsound.SND_ASYNC`8081Возвращает управление немедленно, позволяя звукам воспроизводиться асинхронно.8283#### `winsound.SND_NODEFAULT`8485Если указанный звук не найден, не воспроизводить системный звук по умолчанию.8687#### `winsound.SND_NOSTOP`8889Не прерывать звуки, воспроизводимые в данный момент.9091#### `winsound.SND_NOWAIT`9293Возвращать управление немедленно, если звуковой драйвер занят.9495> **Примечание**96>97> Этот флаг не поддерживается на современных платформах Windows.9899#### `winsound.MB_ICONASTERISK`100101Воспроизвести звук `SystemDefault`.102103#### `winsound.MB_ICONEXCLAMATION`104105Воспроизвести звук `SystemExclamation`.106107#### `winsound.MB_ICONHAND`108109Воспроизвести звук `SystemHand`.110111#### `winsound.MB_ICONQUESTION`112113Воспроизвести звук `SystemQuestion`.114115#### `winsound.MB_OK`116117Воспроизвести звук `SystemDefault`.118