al.md

1> **Источник:** https://python-all.ru/2.6/library/al.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 38.1. `al` – Функции для работы со звуком на SGI89*Платформы:* IRIX1011Устарело с версии 2.6: Модуль `al` объявлен устаревшим и будет удалён в Python 3.0.1213Этот модуль предоставляет доступ к аудиовозможностям рабочих станций SGI Indy и Indigo. Подробности см. в разделе 3A справочных страниц IRIX. Чтобы понять, что делают эти функции, необходимо прочитать эти страницы! Некоторые функции недоступны в версиях IRIX до 4.0.5. Опять же, обратитесь к руководству, чтобы проверить, доступна ли конкретная функция на вашей платформе.1415Все функции и методы, определённые в этом модуле, эквивалентны функциям на C с префиксом `AL` в их имени.1617Символические константы из заголовочного файла C `<audio.h>` определены в стандартном модуле `AL`, см. ниже.1819> **Предупреждение**20>21> Текущая версия аудиобиблиотеки может аварийно завершиться с дампом ядра при передаче неверных значений аргументов вместо возврата кода ошибки. К сожалению, поскольку точные обстоятельства, при которых это может произойти, не документированы и их трудно проверить, интерфейс Python не может обеспечить защиту от такого рода проблем. (Один из примеров – указание чрезмерного размера очереди; задокументированного верхнего предела нет.)2223Модуль определяет следующие функции:2425#### `al.openport(name, direction[, config])`2627Аргументы name и direction являются строками. Необязательный аргумент2829*config*3031– это объект конфигурации, возвращаемый функцией3233[`newconfig()`](https://python-all.ru/2.6/library/al.html#al.newconfig)3435. Возвращаемое значение –3637*объект аудиопорта*3839; методы объектов аудиопортов описаны ниже.4041#### `al.newconfig()`4243Возвращаемое значение – новый4445*объект аудиоконфигурации*4647; методы объектов аудиоконфигурации описаны ниже.4849#### `al.queryparams(device)`5051Аргумент device – целое число. Возвращаемое значение – список целых чисел, содержащий данные, возвращённые функцией5253`ALqueryparams()`5455.5657#### `al.getparams(device, list)`5859Аргумент6061*device*6263– целое число. Аргумент list – это список, подобный возвращаемому функцией6465[`queryparams()`](https://python-all.ru/2.6/library/al.html#al.queryparams)6667; он изменяется на месте (!).6869#### `al.setparams(device, list)`7071Аргумент7273*device*7475– целое число. Аргумент7677*list*7879– это список, подобный возвращаемому функцией8081[`queryparams()`](https://python-all.ru/2.6/library/al.html#al.queryparams)8283.8485## 38.1.1. Объекты конфигурации8687Объекты конфигурации, возвращаемые функцией [`newconfig()`](https://python-all.ru/2.6/library/al.html#al.newconfig), имеют следующие методы:8889#### `audio configuration.getqueuesize()`9091Возвращает размер очереди.9293#### `audio configuration.setqueuesize(size)`9495Устанавливает размер очереди.9697#### `audio configuration.getwidth()`9899Возвращает ширину семпла.100101#### `audio configuration.setwidth(width)`102103Устанавливает ширину семпла.104105#### `audio configuration.getchannels()`106107Возвращает количество каналов.108109#### `audio configuration.setchannels(nchannels)`110111Устанавливает количество каналов.112113#### `audio configuration.getsampfmt()`114115Возвращает формат семпла.116117#### `audio configuration.setsampfmt(sampfmt)`118119Устанавливает формат семпла.120121#### `audio configuration.getfloatmax()`122123Возвращает максимальное значение для форматов семплов с плавающей точкой.124125#### `audio configuration.setfloatmax(floatmax)`126127Устанавливает максимальное значение для форматов семплов с плавающей точкой.128129## 38.1.2. Объекты портов130131Объекты портов, возвращаемые функцией [`openport()`](https://python-all.ru/2.6/library/al.html#al.openport), имеют следующие методы:132133#### `audio port.closeport()`134135Закрывает порт.136137#### `audio port.getfd()`138139Возвращает файловый дескриптор в виде int.140141#### `audio port.getfilled()`142143Возвращает количество заполненных сэмплов.144145#### `audio port.getfillable()`146147Возвращает количество сэмплов, доступных для заполнения.148149#### `audio port.readsamps(nsamples)`150151Считывает несколько сэмплов из очереди, при необходимости блокируя выполнение. Возвращает данные в виде строки, содержащей сырые данные (например, 2 байта на сэмпл в порядке byte order big-endian (старший байт, младший байт), если ширина сэмпла установлена равной 2 байтам).152153#### `audio port.writesamps(samples)`154155Записывает сэмплы в очередь, блокируя при необходимости. Сэмплы кодируются, как описано для возвращаемого значения156157`readsamps()`158159.160161#### `audio port.getfillpoint()`162163Возвращает точку заполнения (fill point).164165#### `audio port.setfillpoint(fillpoint)`166167Устанавливает точку заполнения.168169#### `audio port.getconfig()`170171Возвращает объект конфигурации, содержащий текущую конфигурацию порта.172173#### `audio port.setconfig(config)`174175Устанавливает конфигурацию из переданного объекта конфигурации.176177#### `audio port.getstatus(list)`178179Получает информацию о состоянии последней ошибки.180181# 38.2. `AL` – Константы, используемые с модулем `al`182183*Платформы:* IRIX184185Устарело с версии 2.6: Модуль `AL` устарел и будет удалён в Python 3.0.186187Этот модуль определяет символические константы, необходимые для использования встроенного модуля `al` (см. выше); они эквивалентны определённым в заголовочном файле C `<audio.h>`, за исключением того, что префикс имени `AL_` опущен. Обратитесь к исходному коду модуля для получения полного списка определённых имён. Рекомендуемое использование:188189```python190import al191from AL import *192```193