IOAudioEngine

Абстрактный базовый класс для единственного аудио аудио / механизм I/O.

IOAudioEngine определяется единственным механизмом I/O для передачи данных или от одного или более демонстрационных буферов. Каждый демонстрационный буфер представлен единственным экземпляром IOAudioStream. Единственный IOAudioEngine должен содержать по крайней мере один IOAudioStream, но не имеет никакого верхнего предела числа IOAudioStreams, который это может содержать. Экземпляр IOAudioEngine может содержать оба ввода и вывода IOAudioStreams.

Драйвер аудио должен разделить IOAudioEngine на подклассы для предоставления определенных услуг. Подкласс IOAudioEngine должен запустить и остановить механизм I/O, когда требуется. Механизм I/O должен постоянно работать и цикл вокруг от конца до начала. В то время как аудио механизм работает, он должен взять метку времени в качестве демонстрационного буфера (ов), повторяются и запускаются вначале. CoreAudio.framework использует метку времени для вычисления точной позиции аудио механизма. Подкласс IOAudioEngine должен реализовать getCurrentSampleFrame () для обеспечения демонстрационной позиции по требованию. Наконец, подкласс IOAudioEngine должен обеспечить отсечение и подпрограммы преобразования формата для движения в собственный формат CoreAudio.framework плавающий.

Если многократные потоковые форматы или частоты дискретизации позволяются, подкласс IOAudioEngine должен предоставить поддержку для изменения аппаратных средств, когда изменяются формат или частота дискретизации.

Существует несколько атрибутов, связанных с единственным IOAudioEngine:

Суперкласс IOAudioEngine обеспечивает совместно используемый буфер состояния, содержащий все динамические данные об аудио механизме (введите IOAudioEngineStatus). Это выполняет процесс стирания на всех потоках вывода. Стирающая головка используется для обнуления соединения и демонстрационных буферов после того, как игрались выборки. Кроме того, суперкласс IOAudioEngine обрабатывает связь с CoreAudio.framework и принимает решение запустить и остановить аудио механизм, когда это обнаруживает его, используется.

Для аудиоустройства, чтобы воспроизвести или записать звук, должен быть создан подкласс IOAudioEngine. Подкласс должен инициализировать все необходимые аппаратные ресурсы для подготовки к запущению аудио двигателя I/O. Это обычно будет выполнять эти задачи в initHardware () метод. Подкласс может также реализовать остановку () метод, который вызывают, поскольку разъединяется драйвер. Это обычно вызывают в подготовке удаления устройства от системы для съемных устройств.

В дополнение к инициализации необходимых аппаратных средств существует много других задач, которые IOAudioEngine должен сделать во время initHardware (). Это должно создать необходимые объекты IOAudioStream соответствовать функции устройств. Каждый IOAudioStream должен быть добавлен с помощью addAudioStream (). Это также должно создать IOAudioControls, должен был управлять различными атрибутами аудио механизма: выходной объем, бесшумный, входное усиление, ввел выбор, аналог passthru. Чтобы сделать это, addDefaultAudioControl () нужно вызвать с каждым IOAudioControl, чтобы быть присоединенным к IOAudioEngine. Для обеспечения надлежащей синхронизации задержка аудио механизма должна быть указана с setSampleLatency (). Это значение представляет задержку между меткой времени, взятой в начале буфера и когда аудио фактически играется (или зарегистрировано) устройством. Если устройство является базируемым блоком или если существует потребность сохранить CoreAudio.framework определенным числом выборок перед (или позади для ввода) голова I/O, то значение должно быть указано с помощью setSampleOffset (). Если это не указано, CoreAudio.framework может попытаться добраться максимально близко к голове I/O.

Следующие поля в совместно используемой структуре IOAudioEngineStatus должны сохраняться реализацией подкласса:

Критически важно, чтобы fLastLoopTime поле было максимально точно. Это - основание для всего таймера и механизма синхронизации, используемого аудиосистемой.

В init время подкласс IOAudioEngine должен вызвать setNumSampleFramesPerBuffer (), чтобы указать, насколько большой каждый из демонстрационных буферов (измерен в демонстрационных кадрах). В единственном IOAudioEngine все демонстрационные буферы должны быть тем же размером и работать в той же частоте дискретизации. Если различные буферы/потоки могут быть выполнены на различных уровнях, отдельный IOAudioEngines должен использоваться. Подкласс IOAudioEngine должен также вызвать setSampleRate () в init время для указания стартовой частоты дискретизации устройства.