Аудио-очереди для записи

Аудио-очередь записи, создаваемая с AudioQueueNewInput функционируйте, показали структуру на рисунке 1-1.

Входная сторона аудио-очереди записи обычно соединяется с внешними аудио аппаратными средствами, такими как микрофон. В iOS аудио прибывает из устройства, подключенного пользователем — встроенный микрофон или микрофон гарнитуры, например. В случае по умолчанию для Mac OS X аудио прибывает из устройства аудиовхода системы по умолчанию, как установлено пользователем в Установках системы.

Выходная сторона аудио-очереди записи использует функцию обратного вызова, которую Вы пишете. При записи к диску обратный вызов пишет буферы новых аудиоданных, которые это получает от его аудио-очереди к аудиофайлу. Однако запись аудио-очередей может использоваться другими способами. Вы могли также использовать один, например, в аудио анализаторе в реальном времени. В таком случае Ваш обратный вызов обеспечил бы аудиоданные непосредственно для Вашего приложения вместо того, чтобы писать его в диск.

Вы узнаете больше об этом обратном вызове в Функции обратного вызова Аудио-очереди Записи.

Каждая аудио-очередь — имеет ли для записи или воспроизведения — один или несколько буферов аудио-очереди. Эти буферы располагаются в определенной последовательности, названной буферной очередью. В числе буферы аудио-очереди пронумерованы согласно порядку, в котором они переполнены — который является тем же порядком, в котором они переданы к обратному вызову. Вы изучите, как аудио-очередь использует свои буферы в Буферной Очереди и Постановке в очередь.

Аудио-очереди для воспроизведения

Аудио-очередь воспроизведения (создаваемый с AudioQueueNewOutput функция), показали структуру на рисунке 1-2.

В аудио-очереди воспроизведения обратный вызов находится на входной стороне. Обратный вызов ответственен за получение аудиоданных от диска (или некоторый другой источник) и передавание он к аудио-очереди. Когда больше нет данных для игры, обратные вызовы воспроизведения также говорят их аудио-очередям останавливаться. Вы узнаете больше об этом обратном вызове в Функции обратного вызова Аудио-очереди Воспроизведения.

Вывод аудио-очереди воспроизведения обычно соединяется с внешними аудио аппаратными средствами, такими как громкоговоритель. В iOS аудио переходит к устройству, выбранному пользователем — например, получатель или гарнитура. В случае по умолчанию в Mac OS X аудио переходит к устройству аудиовыхода системы по умолчанию, как установлено пользователем в Установках системы.

Процесс записи

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

Аудио-очередь вручает от заполненных буферов аудиоданных к Вашему обратному вызову в порядке, в котором они были получены. Рисунок 1-3 иллюстрирует как, записывая работы при использовании аудио-очереди.

На шаге 1 рисунка 1-3 начинается запись. Аудио-очередь заполняет буфер полученными данными.

На шаге 2 первый буфер был заполнен. Аудио-очередь вызывает обратный вызов, вручая ему полный буфер (буферизуйте 1). Обратный вызов (шаг 3) пишет содержание буфера к аудиофайлу. Одновременно, аудио-очередь заполняется, другой буфер (буферизуйте 2) с недавно полученными данными.

На шаге 4 обратный вызов ставит в очередь буфер (буферизуйте 1), что это только что записало в диск, поместив его в строку, чтобы быть заполненным снова. Аудио-очередь снова вызывает обратный вызов (шаг 5), вручая ему следующий полный буфер (буферизуйте 2). Обратный вызов (шаг 6) пишет содержание этого буфера к аудиофайлу. Это устойчивое состояние цикличного выполнения продолжается, пока пользователь не останавливает запись.

Процесс воспроизведения

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

Аудио-очередь вручает от играемых буферов аудиоданных к Вашему обратному вызову в порядке, в котором они игрались. Обратный вызов читает новые аудиоданные в буфер и затем ставит в очередь их. Рисунок 1-4 иллюстрирует, как воспроизведение работает при использовании аудио-очереди.

На шаге 1 рисунка 1-4, начала приложения аудио-очередь воспроизведения. Приложение вызывает обратный вызов один раз для каждого из буферов аудио-очереди, заполняя их и добавляя их к буферной очереди. Воспламенение гарантирует, что воспроизведение может запуститься немедленно, когда Ваше приложение вызывает AudioQueueStart функция (шаг 2).

На шаге 3 отправляет аудио-очередь, первый буфер (буферизуйте 1) выводить.

Как только первый буфер игрался, аудио-очередь воспроизведения вводит устойчивое состояние цикличного выполнения. Аудио-очередь начинает играть, следующий буфер (буферизуйте 2, шаг 4), и вызывает обратный вызов (шаг 5), вручая ему просто играемый буфер (буферизуйте 1). Обратный вызов (шаг 6) заполняет буфер от аудиофайла и затем ставит в очередь его для воспроизведения.

Управление процессом воспроизведения

Буферы аудио-очереди всегда играются в порядке, в котором они ставятся в очередь. Однако Audio Queue Services предоставляет Вам некоторое управление процессом воспроизведения сAudioQueueEnqueueBufferWithParameters функция. Эта функция позволяет Вам:

• Установите точное время воспроизведения для буфера. Это позволяет Вам поддерживать синхронизацию.

• Кадры для обрезки в запуске или конце буфера аудио-очереди. Это позволяет Вам удалить ведущую или запаздывающую тишину.

• Установите усиление воспроизведения при гранулярности буфера.

Для больше об установке усиления воспроизведения, посмотрите Параметры Аудио-очереди. Для полного описания AudioQueueEnqueueBufferWithParameters функционируйте, посмотрите Ссылку Audio Queue Services.

Функция обратного вызова аудио-очереди записи

Этот раздел представляет обратный вызов, который Вы записали бы для общего падежа записи аудио к дисковому файлу. Вот прототип для обратного вызова аудио-очереди записи, как объявлено в AudioQueue.h заголовочный файл:

AudioQueueInputCallback (

    void                               *inUserData,

    AudioQueueRef                      inAQ,

    AudioQueueBufferRef                inBuffer,

    const AudioTimeStamp               *inStartTime,

    UInt32                             inNumberPacketDescriptions,

    const AudioStreamPacketDescription *inPacketDescs

);

Аудио-очередь записи, в вызове Вашего обратного вызова, предоставляет все, что обратный вызов должен записать следующему набору аудиоданных к аудиофайлу:

• inUserData является, обычно, пользовательской структурой, которую Вы установили для содержания информации состояния для аудио-очереди и ее буферов, объект аудиофайла (типа AudioFileID) представление файла Вы пишете в, и данные о формате аудиоданных для файла.

• inAQ является аудио-очередью, вызвавшей обратный вызов.

• inBuffer является буфером аудио-очереди, недавно заполненным аудио-очередью, содержа новые данные, которые Ваш обратный вызов должен записать в диск. Данные уже отформатированы согласно формату, который Вы указываете в пользовательской структуре (передал в inUserData параметре). Для больше на этом, посмотрите Используя Форматы Аудиоданных и Кодеки.

• inStartTime является демонстрационным временем первой выборки в буфере. Для основной записи Ваш обратный вызов не использует этот параметр.

• inNumberPacketDescriptions является числом описаний пакета в inPacketDescs параметр. При записи к VBR формата (с переменной скоростью передачи) аудио-очередь предоставляет значение для этого параметра к обратному вызову, поочередно передающему его на AudioFileWritePackets функция. CBR форматы (с постоянной скоростью передачи) не использует описания пакета. Для записи CBR аудио-очередь устанавливает это и inPacketDescs параметр к NULL.

• inPacketDescs является набором описаний пакета, соответствующих выборкам в буфере. Снова, аудио-очередь предоставляет значение для этого параметра, если аудиоданные находятся в формате VBR, и Ваш обратный вызов передает его на AudioFileWritePackets функция (объявленный в AudioFile.h заголовочный файл).

Для получения дополнительной информации об обратном вызове записи посмотрите Аудио Записи в этом документе и посмотрите Ссылку Audio Queue Services.

Функция обратного вызова аудио-очереди воспроизведения

Этот раздел представляет обратный вызов, который Вы записали бы для общего падежа игры аудио от дискового файла. Вот прототип для обратного вызова аудио-очереди воспроизведения, как объявлено в AudioQueue.h заголовочный файл:

AudioQueueOutputCallback (

    void                  *inUserData,

    AudioQueueRef         inAQ,

    AudioQueueBufferRef   inBuffer

);

Аудио-очередь воспроизведения, в вызове Вашего обратного вызова, предоставляет то, что обратный вызов должен считать следующий набор аудиоданных от аудиофайла:

• inUserData является, обычно, пользовательской структурой, которую Вы установили для содержания информации состояния для аудио-очереди и ее буферов, объект аудиофайла (типа AudioFileID) представление файла Вы пишете в, и данные о формате аудиоданных для файла.

  В случае аудио-очереди воспроизведения Ваш обратный вызов отслеживает текущий пакетный индекс с помощью поля в этой структуре.

• inAQ является аудио-очередью, вызвавшей обратный вызов.

• inBuffer является буфером аудио-очереди, сделанным доступный аудио-очередью, что Ваш обратный вызов должен заполниться следующим набором данных, считанных из играемого файла.

Если Ваше приложение воспроизводит данные VBR, обратный вызов должен получить пакетную информацию для аудиоданных, которые это читает. Это делает это путем вызова AudioFileReadPackets функция, объявленная в AudioFile.h заголовочный файл. Обратный вызов тогда помещает информацию о пакете в пользовательскую структуру данных для предоставления доступа к нему доступным для аудио-очереди воспроизведения.

Для получения дополнительной информации об обратном вызове воспроизведения посмотрите Аудио Игры в этом документе и посмотрите Ссылку Audio Queue Services.