`winsound.md`

222 строк · 7.1 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.0/library/winsound.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# `winsound` – интерфейс воспроизведения звука для Windows89*Платформы:* Windows1011Модуль `winsound` предоставляет доступ к основным механизмам воспроизведения звука, предоставляемым платформами Windows. Он включает функции и несколько констант.1213#### `[winsound.Beep]winsound.Beep(frequency, duration)`1415Beep the PC’s speaker. The1617*frequency*1819parameter specifies frequency, in hertz, of the sound, and must be in the range 37 through 32,767. The2021*duration*2223parameter specifies the number of milliseconds the sound should last. If the system is not able to beep the speaker,2425[`RuntimeError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.RuntimeError)2627is raised.2829#### `[winsound.PlaySound]winsound.PlaySound(sound, flags)`3031Вызов базовой функции3233`PlaySound`3435из Platform API. Параметр3637*sound*3839может быть именем файла, аудиоданными в виде строки или4041`None`4243. Его интерпретация зависит от значения4445*flags*4647, которое может быть комбинацией констант, описанных ниже (побитовое ИЛИ). Если параметр4849*sound*5051равен5253`None`5455, воспроизведение любого текущего звука останавливается. Если система указывает на ошибку, возбуждается5657[`RuntimeError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.RuntimeError)5859.6061#### `[winsound.MessageBeep]winsound.MessageBeep([type=MB_OK])`6263Вызов базовой функции6465`MessageBeep`6667из Platform API. Она воспроизводит звук в соответствии с реестром. Аргумент6869*type*7071задаёт, какой звук воспроизводить; возможные значения:7273`-1`7475,7677`MB_ICONASTERISK`7879,8081`MB_ICONEXCLAMATION`8283,8485`MB_ICONHAND`8687,8889`MB_ICONQUESTION`9091и9293`MB_OK`9495, все они описаны ниже. Значение9697`-1`9899вызывает «простой звуковой сигнал»; это последний вариант, если иначе звук воспроизвести не удаётся.100101#### `[winsound.SND_FILENAME]winsound.SND_FILENAME`102103The104105*sound*106107parameter is the name of a WAV file. Do not use with108109[`SND_ALIAS`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_ALIAS)110111.112113#### `[winsound.SND_ALIAS]winsound.SND_ALIAS`114115The *sound* parameter is a sound association name from the registry. If the registry contains no such name, play the system default sound unless [`SND_NODEFAULT`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_NODEFAULT) is also specified. If no default sound is registered, raise [`RuntimeError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.RuntimeError). Do not use with [`SND_FILENAME`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_FILENAME).116117Все системы Win32 поддерживают как минимум следующее; большинство систем поддерживают ещё много других:118119| [`PlaySound()`](https://python-all.ru/3.0/library/winsound.html#winsound.PlaySound) *name* | Соответствующее название звука в панели управления |120| --- | --- |121| `'SystemAsterisk'` | Звёздочка |122| `'SystemExclamation'` | Восклицание |123| `'SystemExit'` | Выход из Windows |124| `'SystemHand'` | Критическая остановка |125| `'SystemQuestion'` | Вопрос |126127Например:128129```python130import winsound131# Воспроизвести звук выхода из Windows.132winsound.PlaySound("SystemExit", winsound.SND_ALIAS)133134# Вероятно, воспроизводит звук Windows по умолчанию, если таковой зарегистрирован (поскольку135# "*" скорее всего не является зарегистрированным именем какого-либо звука).136winsound.PlaySound("*", winsound.SND_ALIAS)137```138139#### `[winsound.SND_LOOP]winsound.SND_LOOP`140141Play the sound repeatedly. The142143[`SND_ASYNC`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_ASYNC)144145flag must also be used to avoid blocking. Cannot be used with146147[`SND_MEMORY`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_MEMORY)148149.150151#### `[winsound.SND_MEMORY]winsound.SND_MEMORY`152153The *sound* parameter to [`PlaySound()`](https://python-all.ru/3.0/library/winsound.html#winsound.PlaySound) is a memory image of a WAV file, as a string.154155> **Примечание**156>157> This module does not support playing from a memory image asynchronously, so a combination of this flag and [`SND_ASYNC`](https://python-all.ru/3.0/library/winsound.html#winsound.SND_ASYNC) will raise [`RuntimeError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.RuntimeError).158159#### `[winsound.SND_PURGE]winsound.SND_PURGE`160161Останавливает воспроизведение всех экземпляров указанного звука.162163> **Примечание**164>165> Этот флаг не поддерживается на современных платформах Windows.166167#### `[winsound.SND_ASYNC]winsound.SND_ASYNC`168169Возвращает управление немедленно, позволяя звукам воспроизводиться асинхронно.170171#### `[winsound.SND_NODEFAULT]winsound.SND_NODEFAULT`172173Если указанный звук не найден, не воспроизводить системный звук по умолчанию.174175#### `[winsound.SND_NOSTOP]winsound.SND_NOSTOP`176177Не прерывать звуки, воспроизводимые в данный момент.178179#### `[winsound.SND_NOWAIT]winsound.SND_NOWAIT`180181Возвращать управление немедленно, если звуковой драйвер занят.182183#### `[winsound.MB_ICONASTERISK]winsound.MB_ICONASTERISK`184185Воспроизвести звук186187`SystemDefault`188189.190191#### `[winsound.MB_ICONEXCLAMATION]winsound.MB_ICONEXCLAMATION`192193Воспроизвести звук194195`SystemExclamation`196197.198199#### `[winsound.MB_ICONHAND]winsound.MB_ICONHAND`200201Воспроизвести звук202203`SystemHand`204205.206207#### `[winsound.MB_ICONQUESTION]winsound.MB_ICONQUESTION`208209Воспроизвести звук210211`SystemQuestion`212213.214215#### `[winsound.MB_OK]winsound.MB_OK`216217Воспроизвести звук218219`SystemDefault`220221.222