> **Источник:** https://python-all.ru/3.11/library/wave.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# [`wave`](https://python-all.ru/3.11/library/wave.html#module-wave) – чтение и запись WAV-файлов

**Исходный код:** [Lib/wave.py](https://python-all.ru/src/3.11/Lib/wave.py)

---

Модуль [`wave`](https://python-all.ru/3.11/library/wave.html#module-wave) предоставляет удобный интерфейс для работы с форматом файлов Waveform Audio «WAVE» (или «WAV»). Поддерживаются только файлы, использующие `WAVE_FORMAT_PCM`. Обратите внимание, что это не включает файлы, использующие `WAVE_FORMAT_EXTENSIBLE`, даже если подформат PCM.

Модуль [`wave`](https://python-all.ru/3.11/library/wave.html#module-wave) определяет следующие функцию и исключение:

#### `wave.open(file, mode=None)`

Если *file* – строка, открывается файл с таким именем, в противном случае он рассматривается как файлоподобный объект. Параметр *mode* может принимать следующие значения:

**`'rb'`**

Режим только для чтения.

**`'wb'`**

Режим только для записи.

Обратите внимание: не поддерживаются WAV-файлы, открытые одновременно на чтение и запись.

Значение *mode*, равное `'rb'`, возвращает объект [`Wave_read`](https://python-all.ru/3.11/library/wave.html#wave.Wave_read), а значение *mode*, равное `'wb'`, возвращает объект [`Wave_write`](https://python-all.ru/3.11/library/wave.html#wave.Wave_write). Если *mode* опущен и в качестве *file* передан файлоподобный объект, то `file.mode` используется как значение по умолчанию для *mode*.

Если передан файлоподобный объект, объект wave не закроет его при вызове метода `close()`; закрытие файлового объекта – ответственность вызывающей стороны.

Функция [`open()`](https://python-all.ru/3.11/library/wave.html#wave.open) может использоваться в операторе [`with`](https://python-all.ru/3.11/reference/compound_stmts.html#with). Когда блок `with` завершается, вызывается метод [`Wave_read.close()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_read.close) или [`Wave_write.close()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_write.close).

Изменено в версии 3.4: Добавлена поддержка файлов без произвольного доступа.

#### `exception wave.Error`

Исключение, возникающее, когда какое-либо действие невозможно, поскольку оно нарушает спецификацию WAV или сталкивается с недостатком реализации.

## Объекты Wave\_read

#### `class wave.Wave_read`

Чтение WAV-файла.

Объекты Wave\_read, возвращаемые функцией [`open()`](https://python-all.ru/3.11/library/wave.html#wave.open), имеют следующие методы:

#### `close()`

Закрывает поток, если он был открыт с помощью [`wave`](https://python-all.ru/3.11/library/wave.html#module-wave), и делает экземпляр непригодным для использования. Автоматически вызывается при удалении объекта.

#### `getnchannels()`

Возвращает количество аудиоканалов (`1` для моно, `2` для стерео).

#### `getsampwidth()`

Возвращает ширину выборки в байтах.

#### `getframerate()`

Возвращает частоту дискретизации.

#### `getnframes()`

Возвращает количество аудиофреймов.

#### `getcomptype()`

Возвращает тип сжатия (поддерживается только тип `'NONE'`).

#### `getcompname()`

Человекочитаемая версия [`getcomptype()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_read.getcomptype). Обычно `'not compressed'` соответствует `'NONE'`.

#### `getparams()`

Возвращает [`namedtuple()`](https://python-all.ru/3.11/library/collections.html#collections.namedtuple) `(nchannels, sampwidth, framerate, nframes, comptype, compname)`, эквивалентный результату методов `get*()`.

#### `readframes(n)`

Читает и возвращает не более *n* кадров аудио в виде объекта [`bytes`](https://python-all.ru/3.11/library/stdtypes.html#bytes).

#### `rewind()`

Перемещает указатель файла в начало аудиопотока.

Два следующих метода определены для совместимости с модулем [`aifc`](https://python-all.ru/3.11/library/aifc.html#module-aifc) и не делают ничего интересного.

#### `getmarkers()`

Возвращает `None`.

#### `getmark(id)`

Возбуждает исключение.

Следующие два метода определяют термин «позиция», совместимый между ними, а в остальном зависящий от реализации.

#### `setpos(pos)`

Устанавливает указатель файла на указанную позицию.

#### `tell()`

Возвращает текущую позицию указателя файла.

## Объекты Wave\_write

#### `class wave.Wave_write`

Записывает WAV-файл.

Объекты Wave\_write, возвращаемые [`open()`](https://python-all.ru/3.11/library/wave.html#wave.open).

Для потоков вывода с произвольным доступом заголовок `wave` будет автоматически обновлён, чтобы отражать фактически записанное количество кадров. Для потоков без произвольного доступа значение *nframes* должно быть точным на момент записи первых данных кадра. Точное значение *nframes* можно получить либо вызвав [`setnframes()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_write.setnframes) или [`setparams()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_write.setparams) с количеством кадров, которые будут записаны до вызова [`close()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_write.close), а затем используя [`writeframesraw()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_write.writeframesraw) для записи данных кадров, либо вызвав [`writeframes()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_write.writeframes) со всеми записываемыми данными кадров. В последнем случае [`writeframes()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_write.writeframes) вычислит количество кадров в данных и соответствующим образом установит *nframes* перед записью данных кадров.

Изменено в версии 3.4: Добавлена поддержка файлов без произвольного доступа.

Объекты Wave\_write имеют следующие методы:

#### `close()`

Убеждается, что *nframes* корректен, и закрывает файл, если он был открыт через [`wave`](https://python-all.ru/3.11/library/wave.html#module-wave). Этот метод вызывается при сборке объекта. Он возбудит исключение, если выходной поток не поддерживает произвольный доступ и *nframes* не совпадает с фактически записанным количеством кадров.

#### `setnchannels(n)`

Устанавливает количество каналов.

#### `setsampwidth(n)`

Устанавливает ширину семпла равной *n* байт.

#### `setframerate(n)`

Устанавливает частоту дискретизации равной *n*.

Изменено в версии 3.2: Нецелочисленный входной аргумент этого метода округляется до ближайшего целого.

#### `setnframes(n)`

Устанавливает количество кадров равным *n*. Впоследствии это значение может измениться, если фактически записанное количество кадров будет отличаться (при попытке обновить значение будет вызвана ошибка, если выходной поток не поддерживает произвольный доступ).

#### `setcomptype(type, name)`

Устанавливает тип сжатия и описание. На данный момент поддерживается только тип сжатия `NONE`, то есть без сжатия.

#### `setparams(tuple)`

*tuple* (кортеж) должен быть `(nchannels, sampwidth, framerate, nframes, comptype, compname)` со значениями, допустимыми для методов `set*()`. Устанавливает все параметры.

#### `tell()`

Возвращает текущую позицию в файле с теми же оговорками, что и для методов [`Wave_read.tell()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_read.tell) и [`Wave_read.setpos()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_read.setpos).

#### `writeframesraw(data)`

Записывает аудиокадры без коррекции *nframes*.

Изменено в версии 3.4: Теперь принимается любой [байтоподобный объект](https://python-all.ru/3.11/glossary.html#term-bytes-like-object).

#### `writeframes(data)`

Записывает аудиокадры и проверяет, что *nframes* корректен. Будет вызвана ошибка, если выходной поток не поддерживает произвольный доступ, а общее количество кадров, записанных после записи *data*, не совпадает с ранее установленным значением для *nframes*.

Изменено в версии 3.4: Теперь принимается любой [байтоподобный объект](https://python-all.ru/3.11/glossary.html#term-bytes-like-object).

Обратите внимание, что устанавливать какие-либо параметры после вызова [`writeframes()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_write.writeframes) или [`writeframesraw()`](https://python-all.ru/3.11/library/wave.html#wave.Wave_write.writeframesraw) недопустимо; любая попытка сделать это приведёт к возникновению [`wave.Error`](https://python-all.ru/3.11/library/wave.html#wave.Error).