Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылочная ссылка служб аудиокодека платформы AudioUnit

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка служб аудиокодека

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

Существует три вида объектов аудиокодека, определенных Audio Codec Services:

  • Объекты декодера ('adec') переведите данные, которые не находятся в линейном PCM в линейные отформатированные данные PCM.

  • Объекты кодера ('aenc') переведите линейные данные PCM в некоторый другой формат.

  • Кодеки единицы ('acdc') переведите между различными вариантами того же формата (например, 16-разрядное целое число со знаком линейный PCM в 32-разрядный линейный PCM с плавающей точкой).

Объекты Audio Codec Services являются стандартными компонентами Component Manager.

Основной поток операций для использования аудиокодека следующие:

  1. Найдите надлежащий объект кодека. Можно использовать функции Менеджера компонентов для перечисления кодеков в системе; посмотрите Ссылку Менеджера компонентов. Для примера кода и приложения, выводящего на экран все компоненты Component Manager в системе, посмотрите Fiendishthngs в http://developer .apple.com/samplecode/Fiendishthngs/.

  2. Откройте объект кодека использование Менеджера компонентов.

  3. Сконфигурируйте кодек для желаемых форматов ввода и вывода и других свойств с помощью функций AudioCodecGetPropertyInfo, AudioCodecGetProperty, и AudioCodecSetProperty. Свойства перечислены в Глобальных Свойствах Кодека и Свойствах Кодека Экземпляра.

  4. Вызовите AudioCodecInitialize функционируйте для помещения кодека в инициализированное состояние. В этом состоянии не могут быть изменены данные о формате для перевода. Кодек должен быть в инициализированном состоянии, прежде чем можно будет отправить данные в кодек или получить данные от него.

  5. Отправьте данные в кодек, затем получите закодированные или декодируемые данные от него цикличным выполнением следующие функции:

    1. AudioCodecAppendInputData

    2. AudioCodecProduceOutputPackets

    1. Если у Вас есть другой файл, чтобы обработать с тем же кодеком и хотеть изменить некоторые значения свойств, вызовите AudioCodecUninitialize функция и возврат к шагу 3.

    2. Если Вы имеете другой файл для обработки с тем же кодеком и не хотите изменять какие-либо значения свойств, вызовите AudioCodecReset функция и возврат к шагу 5.

  7. Закройте объект кодека.

OS X включает широкий диапазон аудиокодеков. Некоторые возможные подтипы объекта аудиокодека перечислены в перечислении идентификаторов формата в заголовочном файле CoreAudioTypes.h (см. Ссылку Типов данных Core Audio).

Если Вам интересно в письменной форме Ваш собственный аудиокодек, посмотрите комплект разработчика программного обеспечения (SDK) аудиокодека в Developer/Examples/CoreAudio/AudioCodecs.

Функции

Управление недвижимостью
  • AudioCodecGetPropertyInfo (_: _: _: _:) AudioCodecGetPropertyInfo

    Получает информацию о свойстве кодека.

    Объявление

    Swift

    func AudioCodecGetPropertyInfo(_ inCodec: AudioCodec, _ inPropertyID: AudioCodecPropertyID, _ outSize: UnsafeMutablePointer<UInt32>, _ outWritable: UnsafeMutablePointer<Boolean>) -> OSStatus

    Objective C

    OSStatus AudioCodecGetPropertyInfo ( AudioCodec inCodec, AudioCodecPropertyID inPropertyID, UInt32 *outSize, Boolean *outWritable );

    Параметры

    inCodec

    Объект аудиокодека. Поскольку объект аудиокодека является экземпляром компонента Component Manger, можно использовать Менеджер компонентов (например, функции FindNextComponent и OpenAComponent) получить объект аудиокодека.

    inPropertyID

    ID свойства свойства, о котором Вы хотите получить информацию. Свойство Codec IDs перечислено в Глобальных Свойствах Кодека и Свойствах Кодека Экземпляра.

    outSize

    По возврату, размеру в байтах текущей стоимости свойства.

    outWritable

    Возвраты true если можно изменить значение свойства, иначе false.

    Возвращаемое значение

    Возвраты NoErr в случае успеха, иначе, код результата. Посмотрите Коды Результата для списка возможных значений.

    Обсуждение

    Вызовите эту функцию к:

    • получите размер значения свойства перед вызовом AudioCodecGetProperty получать значение

    • узнайте, может ли значение свойства быть изменено перед вызовом AudioCodecSetProperty установить значение

    Оператор импорта

    Objective C

    @import AudioUnit;

    Swift

    import AudioUnit

    Доступность

    Доступный в OS X v10.2 и позже.

    См. также

    AudioCodecGetProperty
    AudioCodecSetProperty

  • AudioCodecGetProperty (_: _: _: _:) AudioCodecGetProperty

    Получает значение свойства кодека.

    Объявление

    Swift

    func AudioCodecGetProperty(_ inCodec: AudioCodec, _ inPropertyID: AudioCodecPropertyID, _ ioPropertyDataSize: UnsafeMutablePointer<UInt32>, _ outPropertyData: UnsafeMutablePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioCodecGetProperty ( AudioCodec inCodec, AudioCodecPropertyID inPropertyID, UInt32 *ioPropertyDataSize, void *outPropertyData );

    Параметры

    inCodec

    Объект аудиокодека. Поскольку объект аудиокодека является экземпляром компонента Component Manger, можно использовать Менеджер компонентов (например, функции FindNextComponent и OpenAComponent) получить объект аудиокодека.

    inPropertyID

    ID свойства свойства, значение которого Вы хотите получить. Свойство Codec IDs перечислено в Глобальных Свойствах Кодека и Свойствах Кодека Экземпляра.

    ioPropertyDataSize

    На вводе, размере в байтах буфера данных, на который указывают outPropertyData параметр. На выводе, объем данных, фактически записанный в буфер.

    outPropertyData

    Буфер данных свойства.

    Возвращаемое значение

    Возвраты NoErr в случае успеха, иначе, код результата. Посмотрите Коды Результата для списка возможных значений.

    Обсуждение

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

    Оператор импорта

    Objective C

    @import AudioUnit;

    Swift

    import AudioUnit

    Доступность

    Доступный в OS X v10.2 и позже.

    См. также

    AudioCodecGetPropertyInfo
    AudioCodecSetProperty

  • AudioCodecSetProperty (_: _: _: _:) AudioCodecSetProperty

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

    Объявление

    Swift

    func AudioCodecSetProperty(_ inCodec: AudioCodec, _ inPropertyID: AudioCodecPropertyID, _ inPropertyDataSize: UInt32, _ inPropertyData: UnsafePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioCodecSetProperty ( AudioCodec inCodec, AudioCodecPropertyID inPropertyID, UInt32 inPropertyDataSize, const void *inPropertyData );

    Параметры

    inCodec

    Объект аудиокодека. Поскольку объект аудиокодека является экземпляром компонента Component Manger, можно использовать Менеджер компонентов (например, функции FindNextComponent и OpenAComponent) получить объект аудиокодека.

    inPropertyID

    ID свойства свойства, значение которого Вы хотите установить. Устанавливаемое свойство IDs кодека перечислено в Свойствах Кодека Экземпляра.

    inPropertyDataSize

    Размер в байтах данных значения свойства.

    inPropertyData

    Указатель на буфер данных, содержащий значение свойства.

    Возвращаемое значение

    Возвраты NoErr в случае успеха, иначе, код результата. Посмотрите Коды Результата для списка возможных значений.

    Обсуждение

    Свойства кодека классифицируются или как глобальные свойства, остающиеся тем же для всех экземпляров кодека или свойствами экземпляра, которые могут варьироваться от экземпляра до экземпляра. Однако не все значения свойств экземпляра могут быть изменены. Посмотрите Свойства Кодека Экземпляра для подробных данных. Когда кодек находится в инициализированном состоянии, никакие значения свойств не могут быть изменены. Необходимо вызвать эту функцию перед вызовом AudioCodecInitialize функция, или после вызова AudioCodecUninitialize функция. Вызовите AudioCodecGetProperty функция для получения текущей стоимости свойства.

    Оператор импорта

    Objective C

    @import AudioUnit;

    Swift

    import AudioUnit

    Доступность

    Доступный в OS X v10.2 и позже.

    См. также

    AudioCodecInitialize
    AudioCodecUninitialize
    AudioCodecGetProperty

Обработка данных
  • AudioCodecInitialize (_: _: _: _: _:) AudioCodecInitialize

    Устанавливает указанный кодек для выполнения перевода формата данных.

    Объявление

    Swift

    func AudioCodecInitialize(_ inCodec: AudioCodec, _ inInputFormat: UnsafePointer<AudioStreamBasicDescription>, _ inOutputFormat: UnsafePointer<AudioStreamBasicDescription>, _ inMagicCookie: UnsafePointer<Void>, _ inMagicCookieByteSize: UInt32) -> OSStatus

    Objective C

    OSStatus AudioCodecInitialize ( AudioCodec inCodec, const AudioStreamBasicDescription *inInputFormat, const AudioStreamBasicDescription *inOutputFormat, const void *inMagicCookie, UInt32 inMagicCookieByteSize );

    Параметры

    inCodec

    Объект аудиокодека. Поскольку объект аудиокодека является экземпляром компонента Component Manager, можно использовать Менеджер компонентов (например, функции FindNextComponent и OpenAComponent) получить объект аудиокодека.

    inInputFormat

    Структура, описывающая формат входных данных. Посмотрите Ссылку Типов данных Core Audio для описания этой структуры и значений констант, которые могут использоваться в этой структуре. Если входные данные имеют переменное число кадров на пакет, эта структура дополняется с AudioStreamPacketDescription структура передала в inPacketDescription параметр AudioCodecAppendInputData функция.

    inOutputFormat

    Структура, описывающая формат, желаемый для выходных данных.

    inMagicCookie

    Волшебные cookie-данные, при необходимости для формата ввода.

    inMagicCookieByteSize

    Размер в байтах волшебных cookie-данных, если таковые имеются.

    Возвращаемое значение

    Возвраты NoErr в случае успеха. Возвраты kAudioCodecUnsupportedFormatError если кодек не может обработать указанное преобразование данных. Посмотрите Коды Результата для других возможных значений.

    Обсуждение

    Эта функция выделяет любые необходимые буферы, устанавливает форматы ввода и вывода и помещает кодек в инициализированное состояние. Кодек должен быть в инициализированном состоянии для AudioCodecAppendInputData и AudioCodecProduceOutputPackets функции для работы. В то время как в этом состоянии, не могут быть изменены данные о формате для перевода; необходимо вызвать AudioCodecUninitialize функция прежде, чем внести любые изменения.

    Свойства кодека предоставляют информацию о допустимых типах ввода и вывода, волшебных cookie, и т.д. Используйте AudioCodecGetProperty функционируйте для чтения свойств кодека. Свойства описаны в Глобальных Свойствах Кодека и Свойствах Кодека Экземпляра.

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

    Оператор импорта

    Objective C

    @import AudioUnit;

    Swift

    import AudioUnit

    Доступность

    Доступный в OS X v10.2 и позже.

    См. также

    AudioCodecAppendInputData
    AudioCodecProduceOutputPackets
    AudioCodecGetProperty
    AudioCodecUninitialize

  • AudioCodecUninitialize (_:) AudioCodecUninitialize

    Перемещает кодек от инициализированного состояния назад к неинициализированному состоянию.

    Объявление

    Swift

    func AudioCodecUninitialize(_ inCodec: AudioCodec) -> OSStatus

    Objective C

    OSStatus AudioCodecUninitialize ( AudioCodec inCodec );

    Параметры

    inCodec

    Объект аудиокодека. Поскольку объект аудиокодека является экземпляром компонента Component Manger, можно использовать Менеджер компонентов (например, функции FindNextComponent и OpenAComponent) получить объект аудиокодека.

    Возвращаемое значение

    Возвраты NoErr в случае успеха, иначе, код результата. Посмотрите Коды Результата для списка возможных значений.

    Обсуждение

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

    Оператор импорта

    Objective C

    @import AudioUnit;

    Swift

    import AudioUnit

    Доступность

    Доступный в OS X v10.2 и позже.

    См. также

    AudioCodecInitialize
    AudioCodecSetProperty
    AudioCodecReset

  • AudioCodecAppendInputData (_: _: _: _: _:) AudioCodecAppendInputData

    Добавляет аудиоданные к входному буферу кодека.

    Объявление

    Swift

    func AudioCodecAppendInputData(_ inCodec: AudioCodec, _ inInputData: UnsafePointer<Void>, _ ioInputDataByteSize: UnsafeMutablePointer<UInt32>, _ ioNumberPackets: UnsafeMutablePointer<UInt32>, _ inPacketDescription: UnsafePointer<AudioStreamPacketDescription>) -> OSStatus

    Objective C

    OSStatus AudioCodecAppendInputData ( AudioCodec inCodec, const void *inInputData, UInt32 *ioInputDataByteSize, UInt32 *ioNumberPackets, const AudioStreamPacketDescription *inPacketDescription );

    Параметры

    inCodec

    Объект аудиокодека. Поскольку объект аудиокодека является экземпляром компонента Component Manger, можно использовать Менеджер компонентов (например, функции FindNextComponent и OpenAComponent) получить объект аудиокодека.

    inInputData

    Аудиоданные, которые будут отправлены в кодек. Укажите, что больше нет данных для обработки путем передачи буфера 0байты.

    ioInputDataByteSize

    На вводе, размере в байтах данных, на которые указывают inInputData параметр. На выводе, числе байтов кодек, фактически добавленный к его входному буферу.

    ioNumberPackets

    На вводе, числе элементов в inPacketDescription массив. Передача NULL для этого параметра, если входные данные имеют постоянное число кадров на пакет. По возврату число пакетов фактически обрабатывается кодеком.

    inPacketDescription

    Для аудиоданных, имеющих переменное число кадров на пакет, массив AudioStreamPacketDescription структуры, который описывает пакетное расположение. Передача NULL для этого параметра, если входные данные имеют постоянное число кадров на пакет.

    Возвращаемое значение

    Возвраты NoErr в случае успеха. Возвраты kAudioCodecStateError если не был инициализирован кодек. Посмотрите Коды Результата для других возможных значений.

    Обсуждение

    Пакет является самым маленьким, неделимым блоком данных для данного формата аудио. Для линейного PCM (импульсно-кодовый модулируемый) данные, каждый пакет содержит точно один кадр, где кадр является рядом выборок, представляющих одну выборку для каждого канала. Для сжатых форматов аудиоданных число кадров в пакете зависит от кодирования. Например, пакет AAC представляет 1 024 кадра PCM. В некоторых форматах варьируется число кадров на пакет. Для таких форматов необходимо включать массив AudioStreamPacketDescription структуры, который описывает пакетное расположение.

    Входные данные могут питаться в кодер и некоторые декодеры в блоках любого размера (даже байт байтом). Однако, если закодированный формат входных данных, питаемых к декодеру, имеет переменное число кадров на пакет, данные должны быть предоставлены в сети магазинов целых пакетов. Свойства кодека предоставляют информацию о допустимых типах ввода и вывода, минимальных и максимальных буферных размеров, и т.д. Используйте AudioCodecGetProperty функционируйте для чтения свойств кодека. Свойства описаны в Глобальных Свойствах Кодека и Свойствах Кодека Экземпляра.

    Комбинация AudioCodecAppendInputData и AudioCodecProduceOutputPackets функции реализуют «двухтактную» модель обработки данных. Во-первых, входные данные продвинуты в кодек, тогда получающиеся выходные данные вытащены того же самого кодека.

    Оператор импорта

    Objective C

    @import AudioUnit;

    Swift

    import AudioUnit

    Доступность

    Доступный в OS X v10.2 и позже.

    См. также

    AudioCodecInitialize
    AudioCodecGetProperty
    AudioCodecProduceOutputPackets

  • AudioCodecProduceOutputPackets (_: _: _: _: _: _:) AudioCodecProduceOutputPackets

    Получает выходные данные от кодека.

    Объявление

    Swift

    func AudioCodecProduceOutputPackets(_ inCodec: AudioCodec, _ outOutputData: UnsafeMutablePointer<Void>, _ ioOutputDataByteSize: UnsafeMutablePointer<UInt32>, _ ioNumberPackets: UnsafeMutablePointer<UInt32>, _ outPacketDescription: UnsafeMutablePointer<AudioStreamPacketDescription>, _ outStatus: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus AudioCodecProduceOutputPackets ( AudioCodec inCodec, void *outOutputData, UInt32 *ioOutputDataByteSize, UInt32 *ioNumberPackets, AudioStreamPacketDescription *outPacketDescription, UInt32 *outStatus );

    Параметры

    inCodec

    Объект аудиокодека. Поскольку объект аудиокодека является экземпляром компонента Component Manger, можно использовать Менеджер компонентов (например, функции FindNextComponent и OpenAComponent) получить объект аудиокодека.

    outOutputData

    Буфер выходных данных.

    ioOutputDataByteSize

    Указывает размер буфера выходных данных.

    ioNumberPackets

    На вводе желаемо число пакетов. На выводе число пакетов фактически поместило в буфере вывода.

    outPacketDescription

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

    outStatus

    На выводе, информации о состоянии кодека для обеспечения надлежащего управления данными. Посмотрите Выходные Константы Состояния для возможных значений, которые могут быть возвращены.

    Возвращаемое значение

    Возвраты NoErr в случае успеха. Возвраты kAudioCodecStateError если не был инициализирован кодек. Возвраты kAudioCodecNotEnoughBufferSpaceError если буфер вывода не является достаточно большим для требуемого числа пакетов. Посмотрите Коды Результата для других возможных значений.

    Обсуждение

    Эта функция заставляет кодек производить как много исходящих пакетов в соответствии с требованиями, если существуют достаточные входные данные. Если существует недостаточно входных данных для создания требуемого числа исходящих пакетов, outStatus параметр возвращает значение kAudioCodecProduceOutputPacketNeedsMoreInputData и ioNumberPackets параметр указывает фактическое число произведенных пакетов. С другой стороны, если существует достаточно входных данных для создания по крайней мере одного дополнительного полного пакета, outStatus параметр возвращает значение kAudioCodecProduceOutputPacketSuccessHasMore.

    Обратите внимание на то, что декодеры производят линейные данные PCM только в сети магазинов числа кадров в пакете закодированного формата. (См. AudioCodecAppendInputData функция для определений пакета и кадра, как используется этим API.) Можно использовать AudioCodecGetProperty функция для получения этого значения из kAudioCodecPropertyPacketFrameSize свойство. Точно так же это свойство указывает, в каком количестве кадров линейных данных PCM кодер нуждается для создания пакета указанного выходного формата.

    Выходные данные могут быть произведены только в сети магазинов целых пакетов.

    Комбинация AudioCodecAppendInputData и AudioCodecProduceOutputPackets функции реализуют «двухтактную» модель обработки данных. Во-первых, входные данные продвинуты в кодек, тогда получающиеся выходные данные вытащены того же самого кодека.

    Оператор импорта

    Objective C

    @import AudioUnit;

    Swift

    import AudioUnit

    Доступность

    Доступный в OS X v10.2 и позже.

    См. также

    AudioCodecInitialize
    AudioCodecAppendInputData
    AudioCodecGetProperty

  • AudioCodecReset (_:) AudioCodecReset

    Сбросы все аудиоданные в кодеке и очищают входной буфер.

    Объявление

    Swift

    func AudioCodecReset(_ inCodec: AudioCodec) -> OSStatus

    Objective C

    OSStatus AudioCodecReset ( AudioCodec inCodec );

    Параметры

    inCodec

    Объект аудиокодека. Поскольку объект аудиокодека является экземпляром компонента Component Manger, можно использовать Менеджер компонентов (например, функции FindNextComponent и OpenAComponent) получить объект аудиокодека.

    Возвращаемое значение

    Возвраты NoErr в случае успеха, иначе, код результата. Посмотрите Коды Результата для списка возможных значений.

    Обсуждение

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

    Оператор импорта

    Objective C

    @import AudioUnit;

    Swift

    import AudioUnit

    Доступность

    Доступный в OS X v10.2 и позже.

    См. также

    AudioCodecInitialize

Типы данных

  • AudioCodec AudioCodec

    Экземпляр компонента Component Manager.

    Объявление

    Swift

    typealias AudioCodec = AudioComponentInstance

    Objective C

    typedef ComponentInstance AudioCodec;

    Оператор импорта

    Objective C

    @import AudioUnit;

    Swift

    import AudioUnit

    Доступность

    Доступный в OS X v10.2 и позже.

  • AudioCodecPropertyID AudioCodecPropertyID

    Целое число, идентифицирующее свойство аудиокодека.

    Объявление

    Swift

    typealias AudioCodecPropertyID = UInt32

    Objective C

    typedef UInt32 AudioCodecPropertyID;

    Оператор импорта

    Objective C

    @import AudioUnit;

    Swift

    import AudioUnit

    Доступность

    Доступный в OS X v10.2 и позже.

  • AudioCodecMagicCookieInfo

    Структура, содержащая волшебную информацию о cookie, необходима некоторым кодекам.

    Объявление

    Objective C

    struct AudioCodecMagicCookieInfo { UInt32 mMagicCookieSize; const void* mMagicCookie; }; typedef struct AudioCodecMagicCookieInfo AudioCodecMagicCookieInfo;

    Поля

    mMagicCookieSize

    Размер волшебного cookie.

    mMagicCookie

    Универсальный постоянный указатель на волшебный cookie.

    Обсуждение

    Эта структура передается как ввод AudioCodecGetProperty функция для kAudioCodecPropertyFormatList свойство. Первое 4 + sizeof(void *) на байты буфера указывает функция outPropertyData параметр содержит эту структуру на вводе.

    Доступность

    Доступный в OS X v10.5 и позже.

  • AudioCodecPrimeInfo

    Структура, указывающая число продвижения и запаздывающих пустых кадров, которые будут вставлены.

    Объявление

    Swift

    struct AudioCodecPrimeInfo { var leadingFrames: UInt32 var trailingFrames: UInt32 }

    Objective C

    typedef struct AudioCodecPrimeInfo { UInt32 leadingFrames; UInt32 trailingFrames; } AudioCodecPrimeInfo;

    Поля

    leadingFrames

    Целое без знака, указывающее число продвижения пустых кадров.

    trailingFrames

    Целое без знака, указывающее число запаздывающих пустых кадров.

    Доступность

    Доступный в OS X v10.3 и позже.

  • MagicCookieInfo MagicCookieInfo

    Структура, содержащая волшебную информацию о cookie.

    Переименованный AudioCodecMagicCookieInfo,

    Объявление

    Swift

    typealias MagicCookieInfo = AudioCodecMagicCookieInfo

    Objective C

    typedef struct AudioCodecMagicCookieInfo MagicCookieInfo;

    Оператор импорта

    Objective C

    @import AudioUnit;

    Swift

    import AudioUnit

    Доступность

    Доступный в OS X v10.5 и позже.

Константы

  • Компонентные константы аудиокодека

    Компонентные типы аудиокодека.

    Объявление

    Swift

    var kAudioDecoderComponentType: Int { get } var kAudioEncoderComponentType: Int { get } var kAudioUnityCodecComponentType: Int { get }

    Objective C

    enum { kAudioDecoderComponentType = 'adec', kAudioEncoderComponentType = 'aenc', kAudioUnityCodecComponentType = 'acdc' };

    Константы

    • kAudioDecoderComponentType

      kAudioDecoderComponentType

      Кодек, переводящий данные в некотором другом формате в линейный PCM.

      Подтип компонента указывает формат ввода.

      Доступный в OS X v10.2 и позже.

    • kAudioEncoderComponentType

      kAudioEncoderComponentType

      Кодек, переводящий линейные данные PCM в некоторый другой формат

      Подтип компонента указывает выходной формат.

      Доступный в OS X v10.2 и позже.

    • kAudioUnityCodecComponentType

      kAudioUnityCodecComponentType

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

      Подтип компонента указывает формат.

      Доступный в OS X v10.2 и позже.

    Обсуждение

    Некоторые возможные компонентные подтипы аудиокодека перечислены в перечислении идентификаторов формата в заголовочном файле CoreAudioTypes.h (см. Ссылку Типов данных Core Audio).

  • Глобальные свойства кодека

    Эти свойства только для чтения раскрывают возможности кодека и остаются тем же для всех экземпляров кодека.

    Объявление

    Swift

    var kAudioCodecPropertyNameCFString: Int { get } var kAudioCodecPropertyManufacturerCFString: Int { get } var kAudioCodecPropertyFormatCFString: Int { get } var kAudioCodecPropertySupportedInputFormats: Int { get } var kAudioCodecPropertySupportedOutputFormats: Int { get } var kAudioCodecPropertyAvailableInputSampleRates: Int { get } var kAudioCodecPropertyAvailableOutputSampleRates: Int { get } var kAudioCodecPropertyAvailableBitRateRange: Int { get } var kAudioCodecPropertyMinimumNumberInputPackets: Int { get } var kAudioCodecPropertyMinimumNumberOutputPackets: Int { get } var kAudioCodecPropertyAvailableNumberChannels: Int { get } var kAudioCodecPropertyDoesSampleRateConversion: Int { get } var kAudioCodecPropertyAvailableInputChannelLayoutTags: Int { get } var kAudioCodecPropertyAvailableOutputChannelLayoutTags: Int { get } var kAudioCodecPropertyInputFormatsForOutputFormat: Int { get } var kAudioCodecPropertyOutputFormatsForInputFormat: Int { get } var kAudioCodecPropertyFormatInfo: Int { get }

    Objective C

    enum { kAudioCodecPropertyNameCFString = 'lnam', kAudioCodecPropertyManufacturerCFString = 'lmak', kAudioCodecPropertyFormatCFString = 'lfor', kAudioCodecPropertySupportedInputFormats = 'ifm#', kAudioCodecPropertySupportedOutputFormats = 'ofm#', kAudioCodecPropertyAvailableInputSampleRates = 'aisr', kAudioCodecPropertyAvailableOutputSampleRates = 'aosr', kAudioCodecPropertyAvailableBitRateRange = 'abrt', kAudioCodecPropertyMinimumNumberInputPackets = 'mnip', kAudioCodecPropertyMinimumNumberOutputPackets = 'mnop', kAudioCodecPropertyAvailableNumberChannels = 'cmnc', kAudioCodecPropertyDoesSampleRateConversion = 'lmrc', kAudioCodecPropertyAvailableInputChannelLayoutTags = 'aicl', kAudioCodecPropertyAvailableOutputChannelLayoutTags = 'aocl', kAudioCodecPropertyInputFormatsForOutputFormat = 'if4o', kAudioCodecPropertyOutputFormatsForInputFormat = 'of4i', kAudioCodecPropertyFormatInfo = 'acfi' };

    Константы

    • kAudioCodecPropertyNameCFString

      kAudioCodecPropertyNameCFString

      A CFStringRef ссылка на имя компонента кодека.

      Необходимо выпустить CFStringRef полученный с этим свойством, когда Вы закончены с помощью ссылки.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyManufacturerCFString

      kAudioCodecPropertyManufacturerCFString

      A CFStringRef ссылка на производителя кодека.

      Необходимо выпустить CFStringRef полученный с этим свойством, когда Вы закончены с помощью ссылки.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyFormatCFString

      kAudioCodecPropertyFormatCFString

      A CFStringRef ссылка на имя формата кодека.

      Необходимо выпустить CFStringRef полученный с этим свойством, когда Вы закончены с помощью ссылки.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertySupportedInputFormats

      kAudioCodecPropertySupportedInputFormats

      Массив AudioStreamBasicDescription структуры, описывающие форматы поддержка кодеков для входных данных.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertySupportedOutputFormats

      kAudioCodecPropertySupportedOutputFormats

      Массив AudioStreamBasicDescription структуры, описывающие форматы поддержка кодеков для выходных данных.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyAvailableInputSampleRates

      kAudioCodecPropertyAvailableInputSampleRates

      Массив AudioValueRange структуры, указывающие поддерживаемые значения для входной частоты дискретизации кодека.

      Обратите внимание на то, что mMinimum и mMaximum поля AudioValueRange когда структура представляет дискретное значение, а не диапазон, структура равна. Это свойство требуется для кодеров. (См. также kAudioCodecPropertyApplicableInputSampleRates, kAudioCodecPropertyCurrentInputSampleRate.)

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyAvailableOutputSampleRates

      kAudioCodecPropertyAvailableOutputSampleRates

      Массив AudioValueRange структуры, указывающие поддерживаемые значения для выходной частоты дискретизации кодека.

      Обратите внимание на то, что mMinimum и mMaximum поля AudioValueRange когда структура представляет дискретное значение, а не диапазон, структура равна. Это свойство требуется для кодеров. (См. также kAudioCodecPropertyApplicableOutputSampleRates, kAudioCodecPropertyCurrentOutputSampleRate.)

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyAvailableBitRateRange

      kAudioCodecPropertyAvailableBitRateRange

      Массив AudioValueRange структуры, указывающие целевые скорости передачи, поддерживаемые кодером.

      Обратите внимание на то, что mMinimum и mMaximum поля AudioValueRange когда структура представляет дискретное значение, а не диапазон, структура равна. Это свойство может содержать общую скорость передачи или скорость передачи на канал как надлежащие. Это свойство относится к кодерам только. (См. также kAudioCodecPropertyApplicableBitRateRange, kAudioCodecPropertyCurrentTargetBitRate.)

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyMinimumNumberInputPackets

      kAudioCodecPropertyMinimumNumberInputPackets

      Минимальное число входящих пакетов, которые должны быть предоставлены кодеку прежде, чем вызвать AudioCodecProduceOutputPackets функция, указанная как a UInt32.

      Фактическая сумма данных кодек обрабатывает с одним вызовом AudioCodecProduceOutputPackets функция может быть меньше, чем это. Для большинства кодеков это значение 1. Вы используете AudioCodecAppendInputData функционируйте для помещения данных во входной буфер кодека.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyMinimumNumberOutputPackets

      kAudioCodecPropertyMinimumNumberOutputPackets

      Минимальное число исходящих пакетов, которые Вы должны быть подготовлены принять от кодека с одним вызовом AudioCodecProduceOutputPackets функция, указанная как a UInt32.

      Фактическая сумма вывода, который кодек производит когда-то, могла бы быть меньше, чем это (см. AudioCodecProduceOutputPackets функция). Для большинства кодеков это значение 1.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyAvailableNumberChannels

      kAudioCodecPropertyAvailableNumberChannels

      Массив типа UInt32 это указывает число каналов, кодер способен к кодированию, или декодер способен к декодированию к.

      Значение 0xFFFFFFFF указывает любое число каналов.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyDoesSampleRateConversion

      kAudioCodecPropertyDoesSampleRateConversion

      Целое число типа UInt32 указание, может ли кодек сделать преобразование частоты дискретизации (если необходимый), который сохраняет качество.

      Это значение 1 если кодек может сохранить качество, когда это делает преобразование частоты дискретизации.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecPropertyAvailableInputChannelLayoutTags

      kAudioCodecPropertyAvailableInputChannelLayoutTags

      Массив типа AudioChannelLayoutTag это указывает, какие разметки канала кодек способен к использованию на вводе.

      Значения тегов расположения звукового канала перечислены в Ссылке Типов данных Core Audio. См. также kAudioCodecPropertyCurrentInputChannelLayout.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecPropertyAvailableOutputChannelLayoutTags

      kAudioCodecPropertyAvailableOutputChannelLayoutTags

      Массив типа AudioChannelLayoutTag это указывает, какие разметки канала кодек способен к созданию на выводе.

      Значения тегов расположения звукового канала перечислены в Ссылке Типов данных Core Audio. См. также kAudioCodecPropertyCurrentOutputChannelLayout.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecPropertyInputFormatsForOutputFormat

      kAudioCodecPropertyInputFormatsForOutputFormat

      Массив AudioStreamBasicDescription структуры, указывающие, что форматы ввода поддержка кодеков, данная определенный выходной формат.

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

      Этот список всегда является подмножеством массива в kAudioCodecPropertySupportedInputFormats.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecPropertyOutputFormatsForInputFormat

      kAudioCodecPropertyOutputFormatsForInputFormat

      Массив AudioStreamBasicDescription структуры, указывающие, что выходные форматы поддержка кодеков, данная определенный формат ввода.

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

      Этот список всегда является подмножеством массива в kAudioCodecPropertySupportedOutputFormats.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecPropertyFormatInfo

      kAudioCodecPropertyFormatInfo

      На вводе, берет AudioFormatInfo структура, содержащая частично заполненный AudioStreamBasicDescription структура. На выводе, возвратах AudioFormatInfo структура, содержащая полностью инициализированный и проверенный AudioStreamBasicDescription структура.

      AudioStreamBasicDescription структура во вводе AudioFormatInfo структура может включать некоторые поля, установленные в 0 и может включать волшебный cookie. Audio Codec Services использует информацию в волшебном cookie (если включено) и значения по умолчанию для заполнения 0 поля в AudioStreamBasicDescription.

      Доступный в OS X v10.5 и позже.

    Обсуждение

    Эти свойства используются с AudioCodecGetProperty функция.

    Значения этих свойств независимы от внутреннего состояния кодека и не могут быть изменены. Они могут быть считаны в любое время, кодек открыт.

  • Свойства кодека экземпляра

    Свойства, которые могут быть установлены или считаны на экземпляре аудиокодека.

    Объявление

    Swift

    var kAudioCodecPropertyInputBufferSize: Int { get } var kAudioCodecPropertyPacketFrameSize: Int { get } var kAudioCodecPropertyHasVariablePacketByteSizes: Int { get } var kAudioCodecPropertyMaximumPacketByteSize: Int { get } var kAudioCodecPropertyCurrentInputFormat: Int { get } var kAudioCodecPropertyCurrentOutputFormat: Int { get } var kAudioCodecPropertyMagicCookie: Int { get } var kAudioCodecPropertyUsedInputBufferSize: Int { get } var kAudioCodecPropertyIsInitialized: Int { get } var kAudioCodecPropertyCurrentTargetBitRate: Int { get } var kAudioCodecPropertyCurrentInputSampleRate: Int { get } var kAudioCodecPropertyCurrentOutputSampleRate: Int { get } var kAudioCodecPropertyQualitySetting: Int { get } var kAudioCodecPropertyApplicableBitRateRange: Int { get } var kAudioCodecPropertyApplicableInputSampleRates: Int { get } var kAudioCodecPropertyApplicableOutputSampleRates: Int { get } var kAudioCodecPropertyPaddedZeros: Int { get } var kAudioCodecPropertyPrimeMethod: Int { get } var kAudioCodecPropertyPrimeInfo: Int { get } var kAudioCodecPropertyCurrentInputChannelLayout: Int { get } var kAudioCodecPropertyCurrentOutputChannelLayout: Int { get } var kAudioCodecPropertySettings: Int { get } var kAudioCodecPropertyBitRateControlMode: Int { get } var kAudioCodecPropertyFormatList: Int { get } var kAudioCodecPropertySoundQualityForVBR: Int { get } var kAudioCodecPropertyMinimumDelayMode: Int { get }

    Objective C

    enum { kAudioCodecPropertyInputBufferSize = 'tbuf', kAudioCodecPropertyPacketFrameSize = 'pakf', kAudioCodecPropertyHasVariablePacketByteSizes = 'vpk?', kAudioCodecPropertyMaximumPacketByteSize = 'pakb', kAudioCodecPropertyCurrentInputFormat = 'ifmt', kAudioCodecPropertyCurrentOutputFormat = 'ofmt', kAudioCodecPropertyMagicCookie = 'kuki', kAudioCodecPropertyUsedInputBufferSize = 'ubuf', kAudioCodecPropertyIsInitialized = 'init', kAudioCodecPropertyCurrentTargetBitRate = 'brat', kAudioCodecPropertyCurrentInputSampleRate = 'cisr', kAudioCodecPropertyCurrentOutputSampleRate = 'cosr', kAudioCodecPropertyQualitySetting = 'srcq', kAudioCodecPropertyApplicableBitRateRange = 'brta', kAudioCodecPropertyApplicableInputSampleRates = 'isra', kAudioCodecPropertyApplicableOutputSampleRates = 'osra', kAudioCodecPropertyPaddedZeros = 'pad0', kAudioCodecPropertyPrimeMethod = 'prmm', kAudioCodecPropertyPrimeInfo = 'prim', kAudioCodecPropertyCurrentInputChannelLayout = 'icl ', kAudioCodecPropertyCurrentOutputChannelLayout = 'ocl ', kAudioCodecPropertySettings = 'acs ', kAudioCodecPropertyFormatList = 'acfl', kAudioCodecPropertyBitRateControlMode = 'acbf', kAudioCodecPropertySoundQualityForVBR = 'vbrq', kAudioCodecPropertyMinimumDelayMode = 'mdel' };

    Константы

    • kAudioCodecPropertyInputBufferSize

      kAudioCodecPropertyInputBufferSize

      Максимальный размер входного буфера для кодека в байтах, указанных как целое число типа UInt32.

      Это свойство может варьироваться для некоторых кодеков в зависимости от обрабатываемого формата потока битов. Не перезаписываемый.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyPacketFrameSize

      kAudioCodecPropertyPacketFrameSize

      Число кадров аудиоданных, инкапсулировавших в каждом пакете данных в формате кодека, указанном как целое число типа UInt32.

      Для кодеров это - выходной формат. Для декодеров это - формат ввода. Форматы с переменными кадрами на пакет возвращают максимальное значение. Не перезаписываемый.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyHasVariablePacketByteSizes

      kAudioCodecPropertyHasVariablePacketByteSizes

      Целое число типа UInt32 указание, имеют ли все пакеты в формате кодека тот же размер байта.

      Значение 0 указывает, что все пакеты имеют тот же размер байта (такие кодеки иногда упоминаются как кодеки с постоянной скоростью передачи (CBR)). A 1 указывает, что они варьируются по размеру (иногда называемый кодеками с переменной скоростью передачи (VBR)). Максимальный размер переменного пакета до того, обозначенного в kAudioCodecPropertyMaximumPacketByteSize. Любой сообщающий кодек 1 поскольку это свойство должно быть в состоянии обработать описания пакета, хотя оно не должно требовать их.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyMaximumPacketByteSize

      kAudioCodecPropertyMaximumPacketByteSize

      Максимальное количество байтов пакета данных в формате кодека, указанном как целое число типа UInt32.

      Если формат является постоянной скоростью передачи, все пакеты являются этим размером. Если это - переменная скорость передачи, пакеты никогда не превышают этот размер. Это свойство всегда относится к закодированным данным, таким образом, для кодеров это относится к выходным данным, и для декодеров это относится к входным данным. Не перезаписываемый.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyCurrentInputFormat

      kAudioCodecPropertyCurrentInputFormat

      Формат кодек ожидает для его входных данных, описанных AudioStreamBasicDescription структура.

      Это свойство почти всегда перезаписываемо; однако, если поддержка кодеков только один формат ввода, это не должно быть.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyCurrentOutputFormat

      kAudioCodecPropertyCurrentOutputFormat

      Формат, в котором кодек обеспечивает свои выходные данные, описанные AudioStreamBasicDescription структура.

      Это свойство почти всегда перезаписываемо; однако, если поддержка кодеков только один выходной формат, это не должно быть.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyMagicCookie

      kAudioCodecPropertyMagicCookie

      Данные конфигурации, которых кодек требует для обработки потока данных.

      Некоторые кодеки требуют данных конфигурации — называемый волшебным cookie — который указывает, как обработать аудиоданные. Это значение свойства является указателем на буфер. Размер, формат и содержание буфера определяются кодеком. Волшебный cookie является непрозрачными и специфичными для кодека двоичными данными, который воплощает все параметры для данной конфигурации. Чтобы определить, требует ли кодек волшебного cookie, вызовите AudioCodecGetPropertyInfo функция с этим свойством. Если функция возвращает размер, больше, чем 0, тогда кодек берет волшебный cookie. Перезаписываемый, если настоящее.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyUsedInputBufferSize

      kAudioCodecPropertyUsedInputBufferSize

      Число байтов данных во входном буфере кодека, указанном как целое число типа UInt32.

      Сумма доступного пространства буфера является значением, возвращенным kAudioCodecPropertyInputBufferSize минус значение, возвращенное этим свойством. Не перезаписываемый.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyIsInitialized

      kAudioCodecPropertyIsInitialized

      Целое число типа UInt32 указание, является ли кодек в инициализированном состоянии.

      Значение 0 указывает, что кодек является неинициализированным, и любое другое значение указывает, что инициализируется кодек. Не перезаписываемый. Используйте AudioCodecInitialize функционируйте для установки состояния кодека в инициализированный и AudioCodecUninitialize функционируйте для установки его в неинициализированный.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyCurrentTargetBitRate

      kAudioCodecPropertyCurrentTargetBitRate

      Целевое число бит в секунду при кодировании данных, указанных как целое число типа UInt32.

      Это свойство обычно только относится к кодерам, но некоторые декодеры могут получить скорость передачи от волшебного cookie или от потока битов. если декодер может знать, в какую скорость передачи он установлен, он может сообщить о нем. См. также kAudioCodecPropertyApplicableBitRateRange,kAudioCodecPropertyAvailableBitRateRange. Перезаписываемый для кодеров, если поддерживается.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyCurrentInputSampleRate

      kAudioCodecPropertyCurrentInputSampleRate

      Текущая входная частота дискретизации в Герц, указанном как число с плавающей точкой типа Float64.

      Может быть перезаписываемо, но если только одна частота дискретизации поддерживается, это не должно быть.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyCurrentOutputSampleRate

      kAudioCodecPropertyCurrentOutputSampleRate

      Частота дискретизации текущей производительности в Герц, указанном как число с плавающей точкой типа Float64.

      Может быть перезаписываемо, но если только одна частота дискретизации поддерживается, это не должно быть.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyQualitySetting

      kAudioCodecPropertyQualitySetting

      Установка качества звука для кодека, указанного как целое число типа UInt32.

      Это наборы свойств компромисс между качеством звука и потреблением процессорного времени. Значение свойства между 0 и 0x7F, включительно, где 0 минимальное качество звука и самая быстрая обработка. Некоторые константы, которые могут использоваться с этим свойством, определяются в Качественных Константах Аудиокодека для удобства. Перезаписываемый, если поддерживается.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyApplicableBitRateRange

      kAudioCodecPropertyApplicableBitRateRange

      Массив AudioValueRange структуры, указывающие целевые скорости передачи, поддерживаются кодером в его текущей конфигурации.

      Обратите внимание на то, что mMinimum и mMaximum поля AudioValueRange когда структура представляет дискретное значение, а не диапазон, структура равна. Это свойство относится только к кодерам. См. также kAudioCodecPropertyCurrentTargetBitRate, kAudioCodecPropertyAvailableBitRateRange. Не перезаписываемый.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyApplicableInputSampleRates

      kAudioCodecPropertyApplicableInputSampleRates

      Массив AudioValueRange структуры, указывающие поддерживаемые значения для входной частоты дискретизации кодека для текущей скорости передачи.

      Обратите внимание на то, что mMinimum и mMaximum поля AudioValueRange когда структура представляет дискретное значение, а не диапазон, структура равна. Это свойство относится только к кодерам. См. также kAudioCodecPropertyCurrentInputSampleRate и kAudioCodecPropertyAvailableInputSampleRates. Не перезаписываемый.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyApplicableOutputSampleRates

      kAudioCodecPropertyApplicableOutputSampleRates

      Массив AudioValueRange структуры, указывающие поддерживаемые значения для выходной частоты дискретизации кодека для текущей скорости передачи.

      Обратите внимание на то, что mMinimum и mMaximum поля AudioValueRange когда структура представляет дискретное значение, а не диапазон, структура равна. Это свойство относится только к кодерам. См. также kAudioCodecPropertyCurrentOutputSampleRate kAudioCodecPropertyAvailableOutputSampleRates. Не перезаписываемый.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyPaddedZeros

      kAudioCodecPropertyPaddedZeros

      Число оцененных нулю выборок, добавленных к последнему пакету входных данных для заполнения последнего пакета закодированных данных. Указанный как целое число типа UInt32.

      Это свойство относится только к кодерам и не имеет никакого значения по умолчанию. Не перезаписываемый.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecPropertyPrimeMethod

      kAudioCodecPropertyPrimeMethod

      Метод раньше добавлял воспламенение и запаздывающие кадры, указанные как целое число типа UInt32.

      Посмотрите Константы Метода Воспламенения Аудиокодека для возможных значений. Перезаписываемый для кодеров, предлагающих опции для того, чтобы увеличить последний пакет.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyPrimeInfo

      kAudioCodecPropertyPrimeInfo

      Числа продвижения и запаздывающих кадров воспламенения, указанных через указатель на AudioCodecPrimeInfo структура.

      Не перезаписываемый на кодерах. На декодерах это может быть перезаписываемо, дав декодеру команду обрезать первые и последние пакеты к числу указанных кадров воспламенения.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyCurrentInputChannelLayout

      kAudioCodecPropertyCurrentInputChannelLayout

      Расположение канала, которое кодек использует для ввода, указанного как AudioChannelLayout структура.

      Может быть перезаписываемо. Если только одно расположение канала поддерживается, это не должно быть. См. также kAudioCodecPropertyAvailableInputChannelLayoutTags.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecPropertyCurrentOutputChannelLayout

      kAudioCodecPropertyCurrentOutputChannelLayout

      Расположение канала, которое кодек использует для вывода, указанного как AudioChannelLayout структура.

      Если устанавливаемый на кодере, это означает, что кодер может повторно отобразить каналы. Может быть перезаписываемо. Если только одно расположение канала поддерживается, или кодек не делает никакого переотображения канала (т.е. расположение канала вывода всегда является тем же как расположением канала ввода), это не должно быть. См. также kAudioCodecPropertyAvailableOutputChannelLayoutTags.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecPropertySettings

      kAudioCodecPropertySettings

      Список всего устанавливаемые свойства кодера и их значения, указанные через a CFDictionaryRef объект.

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

      Прежде, чем установить это свойство, сначала используйте AudioCodecGetProperty функция для получения текущего словаря. Измените только одно свойство за один раз, поскольку изменение одного свойства может влиять на значения других свойств. Перезаписываемый, если поддерживается.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyBitRateControlMode

      kAudioCodecPropertyBitRateControlMode

      Режим управления скорости передачи, который будет использоваться кодером, который может произвести переменную, измерил пакеты, указанные как целое число типа UInt32.

      Возможные значения для свойства перечислены в Константах Режима управления Скорости передачи. Несмотря на то, что размер пакета кодера может быть переменным (такие кодеки иногда упоминаются как кодеры VBR), это могло бы быть способно к поддержанию постоянной скорости передачи по каналу передачи при кодировании в режиме реального времени с фиксированной сквозной аудио задержкой. Например, MP3 и кодеры MPEG-AAC используют немного механизма водохранилища для встречи того ограничения. Только потребности быть перезаписываемым, если стратегии управления множественной скорости передачи поддержки кодеков.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecPropertyFormatList

      kAudioCodecPropertyFormatList

      Массив AudioFormatListItem структуры, который перечисляет все форматы, которые могут быть обработаны кодеком.

      Существуют случаи, где немного потока может быть сделано из нескольких уровней, которые могут иметь различные частоты дискретизации, различное число каналов, и т.д. Это списки свойств все эти уровни. Для декодеров, когда Вы вызываете AudioCodecGetProperty функция, которую необходимо передать в волшебном cookie, предоставляющем описание того, что находится в потоке битов.

      Нет никакого значения по умолчанию для этого свойства. На вводе, outPropertyData параметр передал AudioCodecGetProperty должен начаться AudioCodecMagicCookieInfo структура. На выводе эта структура перезаписывается AudioFormatListItem структура возвратилась из свойства. Для кодеров это свойство возвращает список форматов, которые будут в потоке битов, который кодер собирается произвести. Никакие входные данные не требуются для кодеров.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecPropertySoundQualityForVBR

      kAudioCodecPropertySoundQualityForVBR

      Целевой уровень качества звука для кодера, сконфигурированного для использования режима управления с переменной скоростью передачи, указанного как целое число типа UInt32.

      Значение свойства может быть от 0 к 0x7F, где 0 самое низкое качество звука. Посмотрите обсуждение kAudioCodecBitRateControlMode_Variable постоянный в Константах Режима управления Скорости передачи. Перезаписываемый, если поддерживается.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecPropertyMinimumDelayMode

      kAudioCodecPropertyMinimumDelayMode

      Указывает, установлен ли кодер в его самом низком режиме задержки, указанном как целое число типа UInt32.

      Установите это свойство в 1 для установки кодера в его минимальный режим задержки. Кодер может предварительно ожидать оцененные нулю выборки к входному сигналу, чтобы заставить задержки (такие как те от фильтра) совпадать на блочной границе. Эта работа, однако, приводит к увеличенной задержке кодирования, которая может быть нежелательной. Можно использовать это свойство для выключения этой функции для предотвращения дополнительной задержки. Перезаписываемый, если поддерживается.

      Доступный в OS X v10.5 и позже.

    Обсуждение

    Эти свойства используются с AudioCodecGetProperty и AudioCodecSetProperty функции.

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

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

  • Качественные константы аудиокодека

    Настройки качества звука, которые будут использоваться со свойством kAudioCodecPropertyQualitySetting.

    Объявление

    Swift

    var kAudioCodecQuality_Max: Int { get } var kAudioCodecQuality_High: Int { get } var kAudioCodecQuality_Medium: Int { get } var kAudioCodecQuality_Low: Int { get } var kAudioCodecQuality_Min: Int { get }

    Objective C

    enum { kAudioCodecQuality_Max = 0x7F, kAudioCodecQuality_High = 0x60, kAudioCodecQuality_Medium = 0x40, kAudioCodecQuality_Low = 0x20, kAudioCodecQuality_Min = 0 };

    Константы

    • kAudioCodecQuality_Max

      kAudioCodecQuality_Max

      Проведите столько же процессорного времени по мере необходимости для получения возможного звукового вывода высшего качества.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecQuality_High

      kAudioCodecQuality_High

      Проведите достаточное процессорное время для достижения высококачественного звукового вывода.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecQuality_Medium

      kAudioCodecQuality_Medium

      Уделите процессорному времени и качеству звукового вывода равное внимание.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecQuality_Low

      kAudioCodecQuality_Low

      Дайте скорость обработки приоритета над качеством звука.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecQuality_Min

      kAudioCodecQuality_Min

      Сделайте обработку как можно быстрее без беспокойства о качестве звука.

      Доступный в OS X v10.2 и позже.

  • Константы метода воспламенения аудиокодека

    Значения, используемые с kAudioCodecPropertyPrimeMethod.

    Объявление

    Swift

    var kAudioCodecPrimeMethod_Pre: Int { get } var kAudioCodecPrimeMethod_Normal: Int { get } var kAudioCodecPrimeMethod_None: Int { get }

    Objective C

    enum { kAudioCodecPrimeMethod_Pre = 0, kAudioCodecPrimeMethod_Normal = 1, kAudioCodecPrimeMethod_None = 2 };

    Константы

    • kAudioCodecPrimeMethod_Pre

      kAudioCodecPrimeMethod_Pre

      Добавляет и продвижение и запаздывающие входные кадры.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPrimeMethod_Normal

      kAudioCodecPrimeMethod_Normal

      Добавляет только запаздывание входных кадров (нулевая задержка).

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPrimeMethod_None

      kAudioCodecPrimeMethod_None

      Не добавляют никакое воспламенение или запаздывающие кадры.

      Доступный в OS X v10.3 и позже.

  • Константы режима управления скорости передачи

    Режимы управления скорости передачи, которые будут использоваться с kAudioCodecPropertyBitRateControlMode.

    Объявление

    Swift

    var kAudioCodecBitRateControlMode_Constant: Int { get } var kAudioCodecBitRateControlMode_LongTermAverage: Int { get } var kAudioCodecBitRateControlMode_VariableConstrained: Int { get } var kAudioCodecBitRateControlMode_Variable: Int { get }

    Objective C

    enum { kAudioCodecBitRateControlMode_Constant = 0, kAudioCodecBitRateControlMode_LongTermAverage = 1, kAudioCodecBitRateControlMode_VariableConstrained = 2, kAudioCodecBitRateControlMode_Variable = 3, };

    Константы

    • kAudioCodecBitRateControlMode_Constant

      kAudioCodecBitRateControlMode_Constant

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

      Несмотря на то, что постоянная скорость передачи сохраняется в этом режиме, число битов, выделенных для кодирования каждой фиксированной длины аудиоданных, может быть переменным (т.е. размеры пакета являются переменными). Например, MP3 и MPEG-AAC используют немного механизма водохранилища для встречи того ограничения.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecBitRateControlMode_LongTermAverage

      kAudioCodecBitRateControlMode_LongTermAverage

      Предоставленная целевая скорость передачи достигается по долгосрочному среднему числу (обычно после первых 1 000 пакетов).

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

      Доступный в OS X v10.5 и позже.

    • kAudioCodecBitRateControlMode_VariableConstrained

      kAudioCodecBitRateControlMode_VariableConstrained

      Кодер динамично выделяет разрядные ресурсы согласно характеристикам базового сигнала; однако, некоторые ограничения применяются для ограничения изменения скорости передачи.

      Доступный в OS X v10.5 и позже.

    • kAudioCodecBitRateControlMode_Variable

      kAudioCodecBitRateControlMode_Variable

      Подобный VBR ограничил режим, однако размер пакета фактически неограничен.

      Процесс кодирования предназначается для постоянного качества звука. Этот режим обычно обеспечивает лучший компромисс между качеством и скоростью передачи.

      Доступный в OS X v10.5 и позже.

    Обсуждение

    Эти режимы применимы только к кодерам, которые могут произвести переменные размеры пакета, такие как AAC.

  • Константы для kAudioCodecPropertySettings

    Значения свойств, зарезервированные Apple для использования с kAudioCodecPropertySettings свойство.

    Объявление

    Objective C

    #define kAudioSettings_TopLevelKey "name" #define kAudioSettings_Version "version" #define kAudioSettings_Parameters "parameters" #define kAudioSettings_SettingKey "key" #define kAudioSettings_SettingName "name" #define kAudioSettings_ValueType "value type" #define kAudioSettings_AvailableValues "available values" #define kAudioSettings_LimitedValues "limited values" #define kAudioSettings_CurrentValue "current value" #define kAudioSettings_Summary "summary" #define kAudioSettings_Hint "hint" #define kAudioSettings_Unit "unit"

  • Флаги параметров звука

    Флаги зарезервированы для использования Apple.

    Объявление

    Objective C

    enum { kAudioSettingsFlags_ExpertParameter = (1L << 0), kAudioSettingsFlags_InvisibleParameter = (1L << 1), kAudioSettingsFlags_MetaParameter = (1L << 2), kAudioSettingsFlags_UserInterfaceParameter = (1L << 3) };

  • Выходные константы состояния

    Значения состояния возвратились из AudioCodecProduceOutputPackets функция.

    Объявление

    Swift

    var kAudioCodecProduceOutputPacketFailure: Int { get } var kAudioCodecProduceOutputPacketSuccess: Int { get } var kAudioCodecProduceOutputPacketSuccessHasMore: Int { get } var kAudioCodecProduceOutputPacketNeedsMoreInputData: Int { get } var kAudioCodecProduceOutputPacketAtEOF: Int { get }

    Objective C

    enum { kAudioCodecProduceOutputPacketFailure = 1, kAudioCodecProduceOutputPacketSuccess = 2, kAudioCodecProduceOutputPacketSuccessHasMore = 3, kAudioCodecProduceOutputPacketNeedsMoreInputData = 4, kAudioCodecProduceOutputPacketAtEOF = 5 };

    Константы

    • kAudioCodecProduceOutputPacketFailure

      kAudioCodecProduceOutputPacketFailure

      Не мог завершить запрос вследствие ошибки.

      Возможно, что были произведены некоторые выходные данные; если так, число произведенных пакетов возвращается в ioNumberPackets параметр.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecProduceOutputPacketSuccess

      kAudioCodecProduceOutputPacketSuccess

      Число требуемых исходящих пакетов было произведено без ошибок и больше нет входных данных для обработки.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecProduceOutputPacketSuccessHasMore

      kAudioCodecProduceOutputPacketSuccessHasMore

      Число требуемых исходящих пакетов было произведено без ошибок и существует достаточно входных данных, остающихся произвести, по крайней мере, еще один пакет выходных данных.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecProduceOutputPacketNeedsMoreInputData

      kAudioCodecProduceOutputPacketNeedsMoreInputData

      Были недостаточные входные данные для создания требуемого числа исходящих пакетов.

      ioNumberPackets параметр возвращает число произведенных исходящих пакетов.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecProduceOutputPacketAtEOF

      kAudioCodecProduceOutputPacketAtEOF

      Маркер конца файла был поражен во время обработки.

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

      Доступный в OS X v10.2 и позже.

  • Селекторы подпрограммы аудиокодека

    Селекторы, используемые Менеджером компонентов для вызова подпрограмм, реализованных кодеком и представленных разработчикам через Audio Codec Services API. Эти селекторы для использования разработчиками кодека; если Вы вызываете функции Audio Codec Services, Вы не должны использовать эти константы.

    Объявление

    Swift

    var kAudioCodecGetPropertyInfoSelect: Int { get } var kAudioCodecGetPropertySelect: Int { get } var kAudioCodecSetPropertySelect: Int { get } var kAudioCodecInitializeSelect: Int { get } var kAudioCodecUninitializeSelect: Int { get } var kAudioCodecAppendInputDataSelect: Int { get } var kAudioCodecProduceOutputDataSelect: Int { get } var kAudioCodecResetSelect: Int { get }

    Objective C

    enum { kAudioCodecGetPropertyInfoSelect = 0x0001, kAudioCodecGetPropertySelect = 0x0002, kAudioCodecSetPropertySelect = 0x0003, kAudioCodecInitializeSelect = 0x0004, kAudioCodecUninitializeSelect = 0x0005, kAudioCodecAppendInputDataSelect = 0x0006, kAudioCodecProduceOutputDataSelect = 0x0007, kAudioCodecResetSelect = 0x0008 };

    Константы

    • kAudioCodecGetPropertyInfoSelect

      kAudioCodecGetPropertyInfoSelect

      Соответствует AudioCodecGetPropertyInfo функция.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecGetPropertySelect

      kAudioCodecGetPropertySelect

      Соответствует AudioCodecGetProperty функция.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecSetPropertySelect

      kAudioCodecSetPropertySelect

      Соответствует AudioCodecSetProperty функция.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecInitializeSelect

      kAudioCodecInitializeSelect

      Соответствует AudioCodecInitialize функция.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecUninitializeSelect

      kAudioCodecUninitializeSelect

      Соответствует AudioCodecUninitialize функция.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecAppendInputDataSelect

      kAudioCodecAppendInputDataSelect

      Соответствует AudioCodecAppendInputData функция.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecProduceOutputDataSelect

      kAudioCodecProduceOutputDataSelect

      Соответствует AudioCodecProduceOutputPackets функция.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecResetSelect

      kAudioCodecResetSelect

      Соответствует AudioCodecReset функция.

      Доступный в OS X v10.2 и позже.

  • устаревшие (deprecated) свойства аудиокодека

    Используйте свойства в Глобальных Свойствах Кодека и Свойствах Кодека Экземпляра вместо этого.

    Объявление

    Swift

    var kAudioCodecPropertyRequiresPacketDescription: Int { get } var kAudioCodecPropertyAvailableBitRates: Int { get } var kAudioCodecExtendFrequencies: Int { get } var kAudioCodecUseRecommendedSampleRate: Int { get } var kAudioCodecOutputPrecedence: Int { get } var kAudioCodecBitRateFormat: Int { get } var kAudioCodecDoesSampleRateConversion: Int { get } var kAudioCodecInputFormatsForOutputFormat: Int { get } var kAudioCodecOutputFormatsForInputFormat: Int { get } var kAudioCodecPropertyInputChannelLayout: Int { get } var kAudioCodecPropertyOutputChannelLayout: Int { get } var kAudioCodecPropertyAvailableInputChannelLayouts: Int { get } var kAudioCodecPropertyAvailableOutputChannelLayouts: Int { get } var kAudioCodecPropertyZeroFramesPadded: Int { get }

    Objective C

    enum { kAudioCodecPropertyRequiresPacketDescription = 'pakd', kAudioCodecPropertyAvailableBitRates = 'brt#', kAudioCodecExtendFrequencies = 'acef', kAudioCodecUseRecommendedSampleRate = 'ursr', kAudioCodecOutputPrecedence = 'oppr', kAudioCodecBitRateFormat = kAudioCodecPropertyBitRateControlMode, kAudioCodecDoesSampleRateConversion = kAudioCodecPropertyDoesSampleRateConversion, kAudioCodecInputFormatsForOutputFormat = kAudioCodecPropertyInputFormatsForOutputFormat, kAudioCodecOutputFormatsForInputFormat = kAudioCodecPropertyOutputFormatsForInputFormat, kAudioCodecPropertyInputChannelLayout = kAudioCodecPropertyCurrentInputChannelLayout, kAudioCodecPropertyOutputChannelLayout = kAudioCodecPropertyCurrentOutputChannelLayout, kAudioCodecPropertyAvailableInputChannelLayouts = kAudioCodecPropertyAvailableInputChannelLayoutTags, kAudioCodecPropertyAvailableOutputChannelLayouts = kAudioCodecPropertyAvailableOutputChannelLayoutTags, kAudioCodecPropertyZeroFramesPadded = kAudioCodecPropertyPaddedZeros };

    Константы

    • kAudioCodecPropertyRequiresPacketDescription

      kAudioCodecPropertyRequiresPacketDescription

      Ненулевое значение указывает, что формат реализации кодека требует что AudioStreamPacketDescription массив должен быть предоставлен любыми данными в том формате.

      Избыточный с kAudioCodecPropertyHasVariablePacketByteSizes.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecPropertyAvailableBitRates

      kAudioCodecPropertyAvailableBitRates

      указывает целевые скорости передачи, поддерживаемые кодером.

      Использовать kAudioCodecPropertyAvailableBitRateRange вместо этого.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecExtendFrequencies

      kAudioCodecExtendFrequencies

      указывает, должен ли кодер расширить свою частоту отсечки, если существует такая опция.

      Никогда не использовал.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecUseRecommendedSampleRate

      kAudioCodecUseRecommendedSampleRate

      Для кодеров, делающих преобразование частоты дискретизации, указывает, использует ли кодер рекомендуемую частоту дискретизации для данного ввода.

      Избыточный, как частота дискретизации 0.0 интерпретируется для значения, “позволяют кодеку решить”.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecOutputPrecedence

      kAudioCodecOutputPrecedence

      Для кодеров, делающих преобразование частоты дискретизации, указывает, нет ли скорость передачи, частота дискретизации, или ни у одного приоритета по другому.

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

      Доступный в OS X v10.3 и позже.

    • kAudioCodecBitRateFormat

      kAudioCodecBitRateFormat

      Указывает, какой режим управления скорости передачи применяется к кодерам, которые могут произвести переменные размеры пакета.

      Переименованный kAudioCodecPropertyBitRateControlMode.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecDoesSampleRateConversion

      kAudioCodecDoesSampleRateConversion

      указание, хочет ли кодек сделать преобразование частоты дискретизации.

      Переименованный kAudioCodecPropertyDoesSampleRateConversion.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecInputFormatsForOutputFormat

      kAudioCodecInputFormatsForOutputFormat

      Массив, указывающий, что поддержка кодеков для входных данных, данных выходной формат.

      Переименованный kAudioCodecPropertyInputFormatsForOutputFormat

      Доступный в OS X v10.3 и позже.

    • kAudioCodecOutputFormatsForInputFormat

      kAudioCodecOutputFormatsForInputFormat

      Массив AudioStreamBasicDescription структуры, указывающие, что поддержка кодеков для выходных данных, данных формат ввода.

      Переименованный kAudioCodecPropertyOutputFormatsForInputFormat.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyInputChannelLayout

      kAudioCodecPropertyInputChannelLayout

      AudioChannelLayout структура, указывающая расположение канала, которое кодек использует для ввода.

      Переименованный kAudioCodecPropertyCurrentInputChannelLayout.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyOutputChannelLayout

      kAudioCodecPropertyOutputChannelLayout

      AudioChannelLayout структура, указывающая расположение канала, которое кодек использует для вывода.

      Переименованный kAudioCodecPropertyCurrentOutputChannelLayout.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyAvailableInputChannelLayouts

      kAudioCodecPropertyAvailableInputChannelLayouts

      Массив, указывающий, какие разметки канала кодек способны к использованию на вводе.

      Переименованный kAudioCodecPropertyAvailableInputChannelLayoutTags.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyAvailableOutputChannelLayouts

      kAudioCodecPropertyAvailableOutputChannelLayouts

      Массив, указывающий, какие разметки канала кодек способны к использованию на выводе.

      Переименованный kAudioCodecPropertyAvailableOutputChannelLayoutTags.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecPropertyZeroFramesPadded

      kAudioCodecPropertyZeroFramesPadded

      A UInt32 указание числа нулей (выборки), добавленные к последнему пакету входных данных для создания кодирования полного пакета.

      Переименованный kAudioCodecPropertyPaddedZeros.

      Доступный в OS X v10.3 и позже.

  • устаревшие (deprecated) Константы, Используемые С kAudioCodecBitRateFormat

    Используйте Константы Режима управления Скорости передачи вместо этого.

    Объявление

    Swift

    var kAudioCodecBitRateFormat_CBR: Int { get } var kAudioCodecBitRateFormat_ABR: Int { get } var kAudioCodecBitRateFormat_VBR: Int { get }

    Objective C

    enum { kAudioCodecBitRateFormat_CBR = kAudioCodecBitRateControlMode_Constant, kAudioCodecBitRateFormat_ABR = kAudioCodecBitRateControlMode_LongTermAverage, kAudioCodecBitRateFormat_VBR = kAudioCodecBitRateControlMode_VariableConstrained };

    Константы

    • kAudioCodecBitRateFormat_CBR

      kAudioCodecBitRateFormat_CBR

      Кодер поддерживает постоянную скорость передачи.

      Замененный kAudioCodecBitRateControlMode_Constant.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecBitRateFormat_ABR

      kAudioCodecBitRateFormat_ABR

      Предоставленная целевая скорость передачи достигается по долгосрочному среднему числу.

      Замененный kAudioCodecBitRateControlMode_LongTermAverage.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecBitRateFormat_VBR

      kAudioCodecBitRateFormat_VBR

      Кодер динамично выделяет разрядные ресурсы согласно характеристикам базового сигнала.

      Замененный kAudioCodecBitRateControlMode_VariableConstrained.

      Доступный в OS X v10.3 и позже.

  • устаревшие (deprecated) Константы, Используемые С kAudioCodecOutputPrecedence

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

    Объявление

    Swift

    var kAudioCodecOutputPrecedenceNone: Int { get } var kAudioCodecOutputPrecedenceBitRate: Int { get } var kAudioCodecOutputPrecedenceSampleRate: Int { get }

    Objective C

    enum { kAudioCodecOutputPrecedenceNone = 0, kAudioCodecOutputPrecedenceBitRate = 1, kAudioCodecOutputPrecedenceSampleRate = 2 };

    Константы

    • kAudioCodecOutputPrecedenceNone

      kAudioCodecOutputPrecedenceNone

      Изменения в скорости передачи или частоте дискретизации ограничиваются другим значением.

      Нет никакой замены.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecOutputPrecedenceBitRate

      kAudioCodecOutputPrecedenceBitRate

      Скорость передачи может быть изменена свободно, корректируя частоту дискретизации при необходимости.

      Нет никакой замены.

      Доступный в OS X v10.3 и позже.

    • kAudioCodecOutputPrecedenceSampleRate

      kAudioCodecOutputPrecedenceSampleRate

      Частота дискретизации может быть изменена свободно, корректируя скорость передачи при необходимости.

      Нет никакой замены.

      Доступный в OS X v10.3 и позже.

  • устаревшие (deprecated) Константы, Используемые С kAudioSettings_Hint

    Замененный константами во Флагах Параметров звука.

    Объявление

    Swift

    var kHintBasic: Int { get } var kHintAdvanced: Int { get } var kHintHidden: Int { get }

    Objective C

    enum { kHintBasic = 0, kHintAdvanced = 1, kHintHidden = 2 };

    Константы

Коды результата

  • kAudioCodecNoError

    Значение

    0

    Описание

    Никакая ошибка.

    Доступный в OS X v10.2 и позже.

  • kAudioCodecUnspecifiedError

    Значение

    'что'

    Описание

    Причина ошибки неизвестна.

    Доступный в OS X v10.2 и позже.

  • kAudioCodecUnknownPropertyError

    Значение

    'кто?'

    Описание

    Указанный идентификатор свойства неизвестен.

    Доступный в OS X v10.2 и позже.

  • kAudioCodecBadPropertySizeError

    Значение

    '! siz'

    Описание

    Буфер предусмотрел свойство, является слишком маленьким.

    Доступный в OS X v10.2 и позже.

  • kAudioCodecIllegalOperationError

    Значение

    'нет'

    Описание

    Эта работа не может быть сделана; например, попытка установить свойство, которое не перезаписываемо.

    Доступный в OS X v10.2 и позже.

  • kAudioCodecUnsupportedFormatError

    Значение

    '! dat'

    Описание

    Этот кодек не поддерживает указанный формат.

    Доступный в OS X v10.2 и позже.

  • kAudioCodecStateError

    Значение

    '! stt'

    Описание

    Кодек находится в неправильном состоянии (инициализирован или неинициализированный) для выполнения этой работы.

    Доступный в OS X v10.2 и позже.

  • kAudioCodecNotEnoughBufferSpaceError

    Значение

    '! buf'

    Описание

    Буфер вывода является слишком небольшим для обработанного объема данных.

    Доступный в OS X v10.2 и позже.

    • kAudioCodecNoError

      Значение

      0

      Описание

      Никакая ошибка.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecUnspecifiedError

      Значение

      'что'

      Описание

      Причина ошибки неизвестна.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecUnknownPropertyError

      Значение

      'кто?'

      Описание

      Указанный идентификатор свойства неизвестен.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecBadPropertySizeError

      Значение

      '! siz'

      Описание

      Буфер предусмотрел свойство, является слишком маленьким.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecIllegalOperationError

      Значение

      'нет'

      Описание

      Эта работа не может быть сделана; например, попытка установить свойство, которое не перезаписываемо.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecUnsupportedFormatError

      Значение

      '! dat'

      Описание

      Этот кодек не поддерживает указанный формат.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecStateError

      Значение

      '! stt'

      Описание

      Кодек находится в неправильном состоянии (инициализирован или неинициализированный) для выполнения этой работы.

      Доступный в OS X v10.2 и позже.

    • kAudioCodecNotEnoughBufferSpaceError

      Значение

      '! buf'

      Описание

      Буфер вывода является слишком небольшим для обработанного объема данных.

      Доступный в OS X v10.2 и позже.