`winsound.md`

168 строк · 9.5 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.15/library/winsound.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `winsound` – интерфейс воспроизведения звука для Windows89**Исходный код:** [PC/winsound.c](https://python-all.ru/src/3.15/PC/winsound.c)1011---1213Модуль `winsound` предоставляет доступ к базовым механизмам воспроизведения звука, предоставляемым платформами Windows. Он включает функции и несколько констант.1415[Доступность](https://python-all.ru/3.15/library/intro.html#availability): Windows.1617## Функции1819#### `winsound.Beep(frequency, duration)`2021Воспроизводит звуковой сигнал через динамик ПК. Параметр *frequency* задаёт частоту звука в герцах и должен быть в диапазоне от 37 до 32 767. Параметр *duration* задаёт продолжительность звука в миллисекундах. Если системе не удаётся воспроизвести сигнал, возбуждается [`RuntimeError`](https://python-all.ru/3.15/library/exceptions.html#RuntimeError).2223#### `winsound.PlaySound(sound, flags)`2425Вызывает базовую функцию `PlaySound()` из Platform API. Параметр *sound* может быть именем файла, системным псевдонимом звука, аудиоданными в виде [байтоподобного объекта](https://python-all.ru/3.15/glossary.html#term-bytes-like-object) или `None`. Его интерпретация зависит от значения *flags*, которое может быть побитовой комбинацией констант, описанных ниже. Если параметр *sound* равен `None`, любой воспроизводимый в данный момент звук останавливается. Если система сообщает об ошибке, возбуждается [`RuntimeError`](https://python-all.ru/3.15/library/exceptions.html#RuntimeError).2627#### `winsound.MessageBeep(type=MB_OK)`2829Вызывает базовую функцию `MessageBeep()` из Platform API. Она воспроизводит звук, указанный в реестре. Аргумент *type* определяет, какой звук воспроизводить; возможные значения: `-1`, `MB_ICONASTERISK`, `MB_ICONEXCLAMATION`, `MB_ICONHAND`, `MB_ICONQUESTION` и `MB_OK` – все они описаны ниже. Значение `-1` выдаёт «простой сигнал»; это последняя резервная возможность, если звук иначе воспроизвести не удаётся. Если система сообщает об ошибке, возбуждается [`RuntimeError`](https://python-all.ru/3.15/library/exceptions.html#RuntimeError).3031## Константы3233#### `winsound.SND_FILENAME`3435Параметр *sound* – это имя WAV-файла. Не используйте вместе с [`SND_ALIAS`](https://python-all.ru/3.15/library/winsound.html#winsound.SND_ALIAS).3637#### `winsound.SND_ALIAS`3839Параметр *sound* – это имя звуковой ассоциации из реестра. Если в реестре нет такого имени, воспроизводится системный звук по умолчанию, если только не указан [`SND_NODEFAULT`](https://python-all.ru/3.15/library/winsound.html#winsound.SND_NODEFAULT). Если звук по умолчанию не зарегистрирован, возбуждается [`RuntimeError`](https://python-all.ru/3.15/library/exceptions.html#RuntimeError). Не используйте вместе с [`SND_FILENAME`](https://python-all.ru/3.15/library/winsound.html#winsound.SND_FILENAME).4041Все системы Win32 поддерживают как минимум следующее; большинство систем поддерживают ещё много других:4243| [`PlaySound()`](https://python-all.ru/3.15/library/winsound.html#winsound.PlaySound) *название* | Соответствующее название звука в панели управления |44| --- | --- |45| `'SystemAsterisk'` | Звёздочка |46| `'SystemExclamation'` | Восклицание |47| `'SystemExit'` | Выход из Windows |48| `'SystemHand'` | Критическая остановка |49| `'SystemQuestion'` | Вопрос |5051Например:5253```python54import winsound55# Воспроизвести звук выхода из Windows.56winsound.PlaySound("SystemExit", winsound.SND_ALIAS)5758# Вероятно, воспроизводит звук Windows по умолчанию, если таковой зарегистрирован (поскольку59# "*" скорее всего не является зарегистрированным именем какого-либо звука).60winsound.PlaySound("*", winsound.SND_ALIAS)61```6263#### `winsound.SND_LOOP`6465Воспроизводит звук повторно. Также необходимо использовать флаг [`SND_ASYNC`](https://python-all.ru/3.15/library/winsound.html#winsound.SND_ASYNC), чтобы избежать блокировки. Нельзя использовать с [`SND_MEMORY`](https://python-all.ru/3.15/library/winsound.html#winsound.SND_MEMORY).6667#### `winsound.SND_MEMORY`6869Параметр *sound* для [`PlaySound()`](https://python-all.ru/3.15/library/winsound.html#winsound.PlaySound) – это образ WAV-файла в памяти в виде [байтоподобного объекта](https://python-all.ru/3.15/glossary.html#term-bytes-like-object).7071> **Примечание**72>73> Этот модуль не поддерживает асинхронное воспроизведение из образа в памяти, поэтому комбинация этого флага и [`SND_ASYNC`](https://python-all.ru/3.15/library/winsound.html#winsound.SND_ASYNC) вызовет [`RuntimeError`](https://python-all.ru/3.15/library/exceptions.html#RuntimeError).7475#### `winsound.SND_PURGE`7677Останавливает воспроизведение всех экземпляров указанного звука.7879> **Примечание**80>81> Этот флаг не поддерживается на современных платформах Windows.8283#### `winsound.SND_ASYNC`8485Возвращает управление немедленно, позволяя звукам воспроизводиться асинхронно.8687#### `winsound.SND_NODEFAULT`8889Если указанный звук не найден, не воспроизводить системный звук по умолчанию.9091#### `winsound.SND_NOSTOP`9293Не прерывать звуки, воспроизводимые в данный момент.9495#### `winsound.SND_NOWAIT`9697Возвращать управление немедленно, если звуковой драйвер занят.9899> **Примечание**100>101> Этот флаг не поддерживается на современных платформах Windows.102103#### `winsound.SND_APPLICATION`104105Параметр *sound* – это псевдоним, специфичный для приложения в реестре. Этот флаг можно комбинировать с флагом [`SND_ALIAS`](https://python-all.ru/3.15/library/winsound.html#winsound.SND_ALIAS) для указания псевдонима звука, определённого приложением.106107#### `winsound.SND_SENTRY`108109Вызывает событие SoundSentry при воспроизведении звука.110111Добавлено в версии 3.14.112113#### `winsound.SND_SYNC`114115Звук воспроизводится синхронно. Это поведение по умолчанию.116117Добавлено в версии 3.14.118119#### `winsound.SND_SYSTEM`120121Назначает звук аудиосессии для системных звуков уведомлений.122123Добавлено в версии 3.14.124125#### `winsound.MB_ICONASTERISK`126127Воспроизвести звук `SystemDefault`.128129#### `winsound.MB_ICONEXCLAMATION`130131Воспроизвести звук `SystemExclamation`.132133#### `winsound.MB_ICONHAND`134135Воспроизвести звук `SystemHand`.136137#### `winsound.MB_ICONQUESTION`138139Воспроизвести звук `SystemQuestion`.140141#### `winsound.MB_OK`142143Воспроизвести звук `SystemDefault`.144145#### `winsound.MB_ICONERROR`146147Воспроизвести звук `SystemHand`.148149Добавлено в версии 3.14.150151#### `winsound.MB_ICONINFORMATION`152153Воспроизвести звук `SystemDefault`.154155Добавлено в версии 3.14.156157#### `winsound.MB_ICONSTOP`158159Воспроизвести звук `SystemHand`.160161Добавлено в версии 3.14.162163#### `winsound.MB_ICONWARNING`164165Воспроизвести звук `SystemExclamation`.166167Добавлено в версии 3.14.168