40.1.1. Объекты аудиоустройств¶Audio Device Objects

Объекты аудиоустройства возвращаются функцией open() и определяют следующие методы (кроме объектов control, которые предоставляют только getinfo(), setinfo(), fileno() и drain()):

audio device.close()

Этот метод явно закрывает устройство. Он полезен в ситуациях, когда удаление объекта не приводит к немедленному закрытию, так как существуют другие ссылки на него. Закрытое устройство не следует использовать повторно.

audio device.fileno()

Возвращает файловый дескриптор, связанный с устройством. Его можно использовать для настройки уведомления SIGPOLL, как описано ниже.

audio device.drain()

Этот метод ожидает обработки всех ожидающих вывода данных и затем возвращает управление. Вызов этого метода часто не требуется: уничтожение объекта автоматически закроет аудиоустройство и выполнит неявный сброс.

audio device.flush()

Этот метод отбрасывает все ожидающие вывода данные. Его можно использовать, чтобы избежать медленной реакции на запрос пользователя об остановке (из-за буферизации до одной секунды звука).

audio device.getinfo()

Этот метод извлекает информацию о состоянии, такую как громкость входа и выхода и т.д., и возвращает её в виде объекта состояния аудиоустройства. Этот объект не имеет методов, но содержит ряд атрибутов, описывающих текущее состояние устройства. Имена и значения атрибутов описаны в <sun/audioio.h> и на странице руководства audio(7I). Имена членов немного отличаются от их аналогов на C: объект состояния – это всего одна структура. Члены подструктуры play имеют префикс o_ в имени, а члены структуры record – префикс i_. Так, член C play.sample_rate доступен как o_sample_rate, record.gain как i_gain, а monitor_gain – как monitor_gain.

audio device.ibufcount()

Этот метод возвращает количество сэмплов, буферизованных на стороне записи, т.е. программа не будет блокироваться при вызове read() для такого количества сэмплов.

audio device.obufcount()

Этот метод возвращает количество сэмплов, буферизованных на стороне воспроизведения. К сожалению, это число нельзя использовать для определения количества сэмплов, которые можно записать без блокировки, так как длина очереди вывода ядра, по-видимому, переменная.

audio device.read(size)

Этот метод читает size сэмплов из аудиовхода и возвращает их в виде строки Python. Функция блокируется, пока не будет достаточно данных.

audio device.setinfo(status)

Этот метод устанавливает параметры состояния аудиоустройства. Параметр status является объектом состояния устройства, возвращаемым функцией getinfo() и, возможно, изменённым программой.

audio device.write(samples)

Метод write получает строку Python, содержащую аудиосэмплы для воспроизведения. Если достаточно свободного буферного пространства, он немедленно возвращается, в противном случае блокируется.

Аудиоустройство поддерживает асинхронное уведомление о различных событиях через сигнал SIGPOLL. Вот пример того, как можно включить это в Python:

def handle_sigpoll(signum, frame):
    print 'I got a SIGPOLL update'

import fcntl, signal, STROPTS

signal.signal(signal.SIGPOLL, handle_sigpoll)
fcntl.ioctl(audio_obj.fileno(), STROPTS.I_SETSIG, STROPTS.S_MSG)