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

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

Разработчик

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

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

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

Расширенная ссылка служб аудиофайла

Extended Audio File Services обеспечивает упрощенный доступ аудиофайла, сочетая функции Audio File Services и Audio Converter Services. Это обеспечивает объединенный интерфейс для чтения и записи сжатых, а также линейных аудиофайлов PCM.

Функции

Управление расширенными объектами аудиофайла
  • ExtAudioFileCreateWithURL (_: _: _: _: _: _:) ExtAudioFileCreateWithURL

    Создает новый аудиофайл и связывает его с новым расширенным объектом аудиофайла.

    Объявление

    Swift

    func ExtAudioFileCreateWithURL(_ inURL: CFURL!, _ inFileType: AudioFileTypeID, _ inStreamDesc: UnsafePointer<AudioStreamBasicDescription>, _ inChannelLayout: UnsafePointer<AudioChannelLayout>, _ inFlags: UInt32, _ outExtAudioFile: UnsafeMutablePointer<ExtAudioFileRef>) -> OSStatus

    Objective C

    OSStatus ExtAudioFileCreateWithURL ( CFURLRef inURL, AudioFileTypeID inFileType, const AudioStreamBasicDescription *inStreamDesc, const AudioChannelLayout *inChannelLayout, UInt32 inFlags, ExtAudioFileRef *outExtAudioFile );

    Параметры

    inURL

    URL нового аудиофайла.

    inFileType

    Тип файла для создания, указанный как константа от Built-In Audio File Types перечисление.

    inStreamDesc

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

    inChannelLayout

    Расположение канала аудиоданных. Если ненуль, это должно быть соответствующим числу каналов, указанных inStreamDesc параметр.

    inFlags

    Флаги для создания или открытия файла. Если kAudioFileFlags_EraseFile флаг установлен, он стирает существующий файл. Если URL указывает на существующий файл, если флаг не установлен, функциональные сбои сбоев.

    outExtAudioFile

    На выводе, недавно выделенном расширенном объекте аудиофайла.

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

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

    Обсуждение

    Если файл, который будет создаваться, находится в сжатом формате, можно установить частоту дискретизации в inStreamDesc параметр к 0. Во всех случаях расширенный преобразователь кодирования объекта файла может произвести аудио в различной частоте дискретизации, чем источник. Файл будет создаваться с форматом аудио, произведенным кодером.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    ExtAudioFileDispose
    ExtAudioFileOpenURL

  • ExtAudioFileDispose (_:) ExtAudioFileDispose

    Избавляется от расширенного объекта аудиофайла и закрывает связанный файл.

    Объявление

    Swift

    func ExtAudioFileDispose(_ inExtAudioFile: ExtAudioFileRef) -> OSStatus

    Objective C

    OSStatus ExtAudioFileDispose ( ExtAudioFileRef inExtAudioFile );

    Параметры

    inExtAudioFile

    Расширенный аудиофайл возражает для закрытия.

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

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    ExtAudioFileCreateWithURL

  • ExtAudioFileOpenURL (_: _:) ExtAudioFileOpenURL

    Открывает существующий аудиофайл для чтения и связывает его с новым расширенным объектом аудиофайла.

    Объявление

    Swift

    func ExtAudioFileOpenURL(_ inURLRef: CFURL!, _ outExtAudioFile: UnsafeMutablePointer<ExtAudioFileRef>) -> OSStatus

    Objective C

    OSStatus ExtAudioFileOpenURL ( CFURLRef inURL, ExtAudioFileRef *outExtAudioFile );

    Параметры

    inURLRef

    Аудиофайл для чтения.

    outExtAudioFile

    На выводе, недавно выделенном расширенном объекте аудиофайла.

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

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    ExtAudioFileCreateWithURL
    ExtAudioFileDispose

  • ExtAudioFileWrapAudioFileID (_: _: _:) ExtAudioFileWrapAudioFileID

    Обертывает объект аудиофайла в расширенный объект аудиофайла.

    Объявление

    Swift

    func ExtAudioFileWrapAudioFileID(_ inFileID: AudioFileID, _ inForWriting: Boolean, _ outExtAudioFile: UnsafeMutablePointer<ExtAudioFileRef>) -> OSStatus

    Objective C

    OSStatus ExtAudioFileWrapAudioFileID ( AudioFileID inFileID, Boolean inForWriting, ExtAudioFileRef *outExtAudioFile );

    Параметры

    inFileID

    Объект аудиофайла перенестись.

    inForWriting

    Использовать true если Вы намереваетесь записать в аудиофайл, false иначе.

    outExtAudioFile

    На выводе, недавно выделенном расширенном объекте аудиофайла.

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

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

    Обсуждение

    Выделяет новый расширенный объект аудиофайла, обертывающий существующий объект аудиофайла. Ваше приложение ответственно за хранение объекта аудиофайла, открытого, пока не расположен расширенный объект аудиофайла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

Конфигурирование свойств для расширенных объектов аудиофайла
  • ExtAudioFileGetProperty (_: _: _: _:) ExtAudioFileGetProperty

    Получает значение свойства от расширенного объекта аудиофайла.

    Объявление

    Swift

    func ExtAudioFileGetProperty(_ inExtAudioFile: ExtAudioFileRef, _ inPropertyID: ExtAudioFilePropertyID, _ ioPropertyDataSize: UnsafeMutablePointer<UInt32>, _ outPropertyData: UnsafeMutablePointer<Void>) -> OSStatus

    Objective C

    OSStatus ExtAudioFileGetProperty ( ExtAudioFileRef inExtAudioFile, ExtAudioFilePropertyID inPropertyID, UInt32 *ioPropertyDataSize, void *outPropertyData );

    Параметры

    inExtAudioFile

    Расширенный аудиофайл возражает для получения значения свойства от.

    inPropertyID

    Свойство, значение которого Вы хотите.

    ioPropertyDataSize

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

    outPropertyData

    На выводе значение свойства Вы хотели добраться.

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

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

    Специальные замечания

    Некоторые значения свойств Core Audio являются типами C, и другие являются Базовыми объектами Основы.

    Если Вы вызываете эту функцию для получения значения, которое является Базовым объектом Основы, то эта функция — несмотря на использование «Get» на его имя — копирует объект. Вы ответственны за выпуск объекта, как описано в Создать Правиле в Руководстве по программированию управления памятью для Базовой Основы.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    ExtAudioFileGetPropertyInfo
    ExtAudioFileSetProperty

  • ExtAudioFileGetPropertyInfo (_: _: _: _:) ExtAudioFileGetPropertyInfo

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

    Объявление

    Swift

    func ExtAudioFileGetPropertyInfo(_ inExtAudioFile: ExtAudioFileRef, _ inPropertyID: ExtAudioFilePropertyID, _ outSize: UnsafeMutablePointer<UInt32>, _ outWritable: UnsafeMutablePointer<Boolean>) -> OSStatus

    Objective C

    OSStatus ExtAudioFileGetPropertyInfo ( ExtAudioFileRef inExtAudioFile, ExtAudioFilePropertyID inPropertyID, UInt32 *outSize, Boolean *outWritable );

    Параметры

    inExtAudioFile

    Расширенный аудиофайл возражает для получения информации свойства от.

    inPropertyID

    Свойство Вы хотите информацию о.

    outSize

    На выводе, размере значения свойства в байтах. Может быть NULL на выводе.

    outWritable

    На выводе, булево значение, указывающее, перезаписываемо ли значение свойства (true означает перезаписываемый). Может быть NULL на выводе.

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

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    ExtAudioFileGetProperty
    ExtAudioFileSetProperty

  • ExtAudioFileSetProperty (_: _: _: _:) ExtAudioFileSetProperty

    Устанавливает значение свойства для расширенного объекта аудиофайла.

    Объявление

    Swift

    func ExtAudioFileSetProperty(_ inExtAudioFile: ExtAudioFileRef, _ inPropertyID: ExtAudioFilePropertyID, _ inPropertyDataSize: UInt32, _ inPropertyData: UnsafePointer<Void>) -> OSStatus

    Objective C

    OSStatus ExtAudioFileSetProperty ( ExtAudioFileRef inExtAudioFile, ExtAudioFilePropertyID inPropertyID, UInt32 inPropertyDataSize, const void *inPropertyData );

    Параметры

    inExtAudioFile

    Расширенный аудиофайл возражает для установки значения свойства на.

    inPropertyID

    Свойство, значение которого Вы хотите установить.

    inPropertyDataSize

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

    inPropertyData

    Значение Вы хотите примениться к указанному свойству.

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

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    ExtAudioFileGetProperty
    ExtAudioFileGetPropertyInfo

Чтение и запись аудиоданных
  • ExtAudioFileRead (_: _: _:) ExtAudioFileRead

    Выполняет синхронную, последовательную операцию чтения на аудиофайле.

    Объявление

    Swift

    func ExtAudioFileRead(_ inExtAudioFile: ExtAudioFileRef, _ ioNumberFrames: UnsafeMutablePointer<UInt32>, _ ioData: UnsafeMutablePointer<AudioBufferList>) -> OSStatus

    Objective C

    OSStatus ExtAudioFileRead ( ExtAudioFileRef inExtAudioFile, UInt32 *ioNumberFrames, AudioBufferList *ioData );

    Параметры

    inExtAudioFile

    Расширенный объект аудиофайла, представляющий файл, который Вы хотите считать.

    ioNumberFrames

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

    ioData

    Один или более буферов, в которые читаются аудиоданные.

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

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

    Обсуждение

    Если расширенный объект аудиофайла имеет формат данных приложения, то преобразователь объекта преобразовывает данные файла в формат приложения.

    Эта функция работает только над единственным потоком. Если Вы хотите, чтобы Ваше приложение считало аудиофайл на многократных потоках, используйте Audio File Services вместо этого.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    ExtAudioFileWrite
    ExtAudioFileWriteAsync

  • ExtAudioFileSeek (_: _:) ExtAudioFileSeek

    Ищет на указанный кадр в файле.

    Объявление

    Swift

    func ExtAudioFileSeek(_ inExtAudioFile: ExtAudioFileRef, _ inFrameOffset: Int64) -> OSStatus

    Objective C

    OSStatus ExtAudioFileSeek ( ExtAudioFileRef inExtAudioFile, SInt64 inFrameOffset );

    Параметры

    inExtAudioFile

    Расширенный объект аудиофайла, представляющий файл, с которым Вы работаете.

    inFrameOffset

    Желаемые ищут позицию, в демонстрационных кадрах, относительно начала файла. Ищите позиция указана в частоте дискретизации и количестве кадра формата аудиоданных файла — не формат аудиоданных Вашего приложения.

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

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

    Обсуждение

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

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    ExtAudioFileTell

  • ExtAudioFileTell (_: _:) ExtAudioFileTell

    Получает позицию чтения-записи аудиофайла.

    Объявление

    Swift

    func ExtAudioFileTell(_ inExtAudioFile: ExtAudioFileRef, _ outFrameOffset: UnsafeMutablePointer<Int64>) -> OSStatus

    Objective C

    OSStatus ExtAudioFileTell ( ExtAudioFileRef inExtAudioFile, SInt64 *outFrameOffset );

    Параметры

    inExtAudioFile

    Расширенный объект аудиофайла, представляющий файл, с которым Вы работаете.

    outFrameOffset

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

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

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    ExtAudioFileSeek

  • ExtAudioFileWrite (_: _: _:) ExtAudioFileWrite

    Выполняет синхронную, последовательную операцию записи на аудиофайле.

    Объявление

    Swift

    func ExtAudioFileWrite(_ inExtAudioFile: ExtAudioFileRef, _ inNumberFrames: UInt32, _ ioData: UnsafePointer<AudioBufferList>) -> OSStatus

    Objective C

    OSStatus ExtAudioFileWrite ( ExtAudioFileRef inExtAudioFile, UInt32 inNumberFrames, const AudioBufferList *ioData );

    Параметры

    inExtAudioFile

    Расширенный объект аудиофайла, представляющий файл для записи в.

    inNumberFrames

    Число кадров для записи.

    ioData

    Буфер (ы), от которого аудиоданные записаны в файл.

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

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

    Обсуждение

    Если расширенный объект аудиофайла имеет формат данных приложения, то преобразователь объекта преобразовывает данные в ioData параметр к формату данных файла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    ExtAudioFileRead
    ExtAudioFileWriteAsync

  • ExtAudioFileWriteAsync (_: _: _:) ExtAudioFileWriteAsync

    Выполните асинхронную, последовательную операцию записи на аудиофайле.

    Объявление

    Swift

    func ExtAudioFileWriteAsync(_ inExtAudioFile: ExtAudioFileRef, _ inNumberFrames: UInt32, _ ioData: UnsafePointer<AudioBufferList>) -> OSStatus

    Objective C

    OSStatus ExtAudioFileWriteAsync ( ExtAudioFileRef inExtAudioFile, UInt32 inNumberFrames, const AudioBufferList *ioData );

    Параметры

    inExtAudioFile

    Расширенный объект аудиофайла, представляющий файл, в который Вы хотите записать.

    inNumberFrames

    Число кадров для записи.

    ioData

    Буфер (ы), от которого аудиоданные записаны в файл.

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

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

    Обсуждение

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

    Ваше приложение не должно смешивать синхронные и асинхронные записи к тому же файлу.

    Незаконченные записи, как гарантируют, не будут сброшены к диску до ExtAudioFileDispose функция вызвана.

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

    См. также

    ExtAudioFileRead
    ExtAudioFileWrite

устаревшие (deprecated) функции
  • ExtAudioFileCreateNew ExtAudioFileCreateNew (OS X v10.6)

    Осуждаемый. Используйте ExtAudioFileCreateWithURL функция вместо этого.

    Объявление

    Objective C

    OSStatus ExtAudioFileCreateNew ( const struct FSRef *inParentDir, CFStringRef inFileName, AudioFileTypeID inFileType, const AudioStreamBasicDescription *inStreamDesc, const AudioChannelLayout *inChannelLayout, ExtAudioFileRef *outExtAudioFile );

    Параметры

    inParentDir

    Каталог, в котором можно создать новый файл.

    inFileName

    Имя нового файла.

    inFileType

    Тип файла для создания. Это - константа от AudioToolbox/AudioFile.h, например, kAudioFileAIFFType. Обратите внимание на то, что это не HFSTypeCode.

    inStreamDesc

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

    inChannelLayout

    Расположение канала аудиоданных. Если ненуль, это должно быть соответствующим числу каналов, указанных inStreamDesc.

    outExtAudioFile

    На выводе, недавно выделенном расширенном объекте аудиофайла.

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

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

    Обсуждение

    Создает новый аудиофайл.

    Если файл, который будет создаваться, находится в сжатом формате, допустимо для частоты дискретизации в inStreamDesc быть 0, с тех пор во всех случаях, кодирование файла, AudioConverter может произвести аудио в различной частоте дискретизации, чем источник. Файл будет создаваться с форматом аудио, фактически произведенным кодером.

    Специальные замечания

    Эта функция осуждается. Используйте ExtAudioFileCreateWithURL функция вместо этого.

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

    Objective C

    @import AudioToolbox;

    Доступность

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

    Осуждаемый в OS X v10.6.

  • ExtAudioFileOpen ExtAudioFileOpen (OS X v10.6)

    Осуждаемый. Используйте ExtAudioFileOpenURL функция вместо этого.

    Объявление

    Objective C

    OSStatus ExtAudioFileOpen ( const struct FSRef *inFSRef, ExtAudioFileRef *outExtAudioFile );

    Параметры

    inFSRef

    Аудиофайл для чтения.

    outExtAudioFile

    На выходе, недавно выделенном ExtAudioAudioFileRef.

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

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

    Обсуждение

    Выделяет новый ExtAudioFileRef для чтения существующего аудиофайла.

    Специальные замечания

    Эта функция осуждается. Используйте ExtAudioFileOpenURL функция вместо этого.

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

    Objective C

    @import AudioToolbox;

    Доступность

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

    Осуждаемый в OS X v10.6.

Типы данных

  • ExtAudioFileRef ExtAudioFileRef

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

    Объявление

    Swift

    typealias ExtAudioFileRef = COpaquePointer

    Objective C

    typedef struct OpaqueExtAudioFile *ExtAudioFileRef;

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

  • ExtAudioFilePropertyID ExtAudioFilePropertyID

    Идентификатор свойства объекта аудиофайла.

    Объявление

    Swift

    typealias ExtAudioFilePropertyID = UInt32

    Objective C

    typedef UInt32 ExtAudioFilePropertyID;

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

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

Константы

  • Идентификаторы свойства для расширенных объектов аудиофайла

    Объявление

    Swift

    var kExtAudioFileProperty_FileDataFormat: Int { get } var kExtAudioFileProperty_FileChannelLayout: Int { get } var kExtAudioFileProperty_ClientDataFormat: Int { get } var kExtAudioFileProperty_ClientChannelLayout: Int { get } var kExtAudioFileProperty_CodecManufacturer: Int { get } var kExtAudioFileProperty_AudioConverter: Int { get } var kExtAudioFileProperty_AudioFile: Int { get } var kExtAudioFileProperty_FileMaxPacketSize: Int { get } var kExtAudioFileProperty_ClientMaxPacketSize: Int { get } var kExtAudioFileProperty_FileLengthFrames: Int { get } var kExtAudioFileProperty_ConverterConfig: Int { get } var kExtAudioFileProperty_IOBufferSizeBytes: Int { get } var kExtAudioFileProperty_IOBuffer: Int { get } var kExtAudioFileProperty_PacketTable: Int { get }

    Objective C

    enum { kExtAudioFileProperty_FileDataFormat = 'ffmt', kExtAudioFileProperty_FileChannelLayout = 'fclo', kExtAudioFileProperty_ClientDataFormat = 'cfmt', kExtAudioFileProperty_ClientChannelLayout = 'cclo', kExtAudioFileProperty_CodecManufacturer = 'cman', // read-only properties: kExtAudioFileProperty_AudioConverter = 'acnv', kExtAudioFileProperty_AudioFile = 'afil', kExtAudioFileProperty_FileMaxPacketSize = 'fmps', kExtAudioFileProperty_ClientMaxPacketSize = 'cmps', kExtAudioFileProperty_FileLengthFrames = '#frm', // read/write properties: kExtAudioFileProperty_ConverterConfig = 'accf', kExtAudioFileProperty_IOBufferSizeBytes = 'iobs', kExtAudioFileProperty_IOBuffer = 'iobf', kExtAudioFileProperty_PacketTable = 'xpti' };

    Константы

    • kExtAudioFileProperty_FileDataFormat

      kExtAudioFileProperty_FileDataFormat

      Формат данных файла. Значение является только для чтения AudioStreamBasicDescription структура.

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

    • kExtAudioFileProperty_FileChannelLayout

      kExtAudioFileProperty_FileChannelLayout

      Расположение канала файла. Значение является чтением-записью AudioChannelLayout структура.

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

      При чтении указанное расположение переопределяет тот, считанный из файла, если Вы присутствуете в файле.

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

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

    • kExtAudioFileProperty_ClientDataFormat

      kExtAudioFileProperty_ClientDataFormat

      Формат аудиопотока для Вашего приложения. Значение является чтением-записью AudioStreamBasicDescription структура.

      Формат должен быть линейным PCM (указанный kAudioFormatLinearPCM постоянный от CoreAudioTypes.h заголовочный файл). Необходимо установить это свойство, чтобы позволить кодировать или декодировать non-PCM формата данных файла. Можно установить это свойство на файлах PCM для указания формата данных для использования в чтении и вызовах записи.

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

    • kExtAudioFileProperty_ClientChannelLayout

      kExtAudioFileProperty_ClientChannelLayout

      Расположение звукового канала для Вашего приложения. Значение является чтением-записью AudioChannelLayout структура.

      Значение этого свойства указывает расположение канала буферов в AudioBufferList список, который Вы передаете ExtAudioFileRead и ExtAudioFileWrite функции. Это расположение может отличаться от расположения канала файла, когда базовый аудио преобразователь объекта расширенного аудиофайла выполняет переотображение. Это свойство должно быть установлено после установки kExtAudioFileProperty_ClientDataFormat свойство и число каналов в этих двух разметках должны соответствовать.

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

    • kExtAudioFileProperty_CodecManufacturer

      kExtAudioFileProperty_CodecManufacturer

      Производитель кодека, который будет использоваться расширенным объектом аудиофайла. Значение является чтением-записью UInt32.

      Необходимо указать это свойство прежде, чем установить kExtAudioFileProperty_ClientDataFormat свойство, поочередно инициировавшее создание кодека. Используйте это свойство в iOS для выбора между аппаратными средствами или кодером программного обеспечения путем указания kAppleHardwareAudioCodecManufacturer или kAppleSoftwareAudioCodecManufacturer.

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

    • kExtAudioFileProperty_AudioConverter

      kExtAudioFileProperty_AudioConverter

      Если преобразователь связан, аудио объект преобразователя связался с расширенным объектом аудиофайла. Значение является только для чтения AudioConverterRef объект.

      При изменении каких-либо свойств преобразователя — скорость передачи, например — необходимо тогда установить kExtAudioFileProperty_ConverterConfig свойство. Когда Вы делаете так, с помощью a NULL конфигурация достаточна. Установка того свойства гарантирует, что формат данных выходного файла является соответствующим формату, производимому преобразователем.

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

    • kExtAudioFileProperty_AudioFile

      kExtAudioFileProperty_AudioFile

      Объект аудиофайла связался с расширенным объектом аудиофайла. Значение является только для чтения AudioFileID объект.

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

    • kExtAudioFileProperty_FileMaxPacketSize

      kExtAudioFileProperty_FileMaxPacketSize

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

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

    • kExtAudioFileProperty_ClientMaxPacketSize

      kExtAudioFileProperty_ClientMaxPacketSize

      Ваш максимальный размер пакета формата аудиоданных приложения, в байтах. Значение является только для чтения UInt32.

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

    • kExtAudioFileProperty_FileLengthFrames

      kExtAudioFileProperty_FileLengthFrames

      Длина связанного аудиофайла в демонстрационных кадрах. Значение SInt64. Для файла PCM значение является чтением-записью. Для non-PCM файла значение только для чтения.

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

    • kExtAudioFileProperty_ConverterConfig

      kExtAudioFileProperty_ConverterConfig

      Конфигурация связанного аудио преобразователя объекта расширенного аудиофайла, как указано kAudioConverterPropertySettings свойство. Значение является чтением-записью CFArray объект.

      Установите значение этого свойства в NULL вызвать пересинхронизацию выходного формата преобразователя с форматом данных файла.

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

    • kExtAudioFileProperty_IOBufferSizeBytes

      kExtAudioFileProperty_IOBufferSizeBytes

      Размер буфера, который связанный аудио преобразователь объекта расширенного аудиофайла использует в чтение или пишет связанный аудиофайл. Значение является чтением-записью UInt32.

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

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

    • kExtAudioFileProperty_IOBuffer

      kExtAudioFileProperty_IOBuffer

      Буфер аудиоданных. Значение является чтением-записью void* значение.

      Значение этого свойства указывает на память, что расширенный аудиофайл возражает использованию для диска I/O при преобразовании между форматами данных файла и приложением. Можно хотеть, чтобы приложение совместно использовало эту память среди многократных расширенных объектов аудиофайла. Если так, можно установить это свойство для указания на буфер, который Вы указываете — передают указатель на указатель при вызове ExtAudioFileSetProperty функция. После установки этого свойства Ваше приложение должно тогда установить kExtAudioFileProperty_IOBufferSizeBytes свойство.

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

    • kExtAudioFileProperty_PacketTable

      kExtAudioFileProperty_PacketTable

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

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

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

      Для определения значения в файле используйте kAudioFilePropertyPacketTableInfo свойство, как описано в Ссылке Audio File Services.

      Когда свойство установлено, только остающееся и значения воспламенения используются. Установите mNumberValidFrames поле AudioFilePacketTableInfo структура для обнуления. Например, файл закодировал использование, AAC может иметь 2 112 выборок воспламенения в начале файла и остатка от 823 выборок в конце. Когда расширенный аудиофайл возражает возвратам декодируемые выборки против Вас, он урезает <выборки цифры воспламенения> в начале файла и урезает <выборки цифры остатка> в конце. Это получает эти числа первоначально от файла. Случай общего использования для переопределения этого должен был бы установить воспламенение и выборки остатка к 0. В этом примере Вы получили бы еще 2 112 выборок тишины от запуска файла и 823 выборки тишины в конце файла (тишина, потому что кодеры используют тишину для увеличивания их воспламенение и выборки остатка).

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

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

Эта таблица приводит коды результата, определенные для Extended Audio File Services.

  • kExtAudioFileError_InvalidProperty

    Значение

    - 66561

    Описание

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

  • kExtAudioFileError_InvalidPropertySize

    Значение

    - 66562

    Описание

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

  • kExtAudioFileError_NonPCMClientFormat

    Значение

    - 66563

    Описание

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

  • kExtAudioFileError_InvalidChannelMap

    Число каналов не соответствует указанный формат.

    Значение

    - 66564

    Описание

    Число каналов не соответствует указанный формат.

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

  • kExtAudioFileError_InvalidOperationOrder

    Значение

    - 66565

    Описание

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

  • kExtAudioFileError_InvalidDataFormat

    Значение

    - 66566

    Описание

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

  • kExtAudioFileError_MaxPacketSizeUnknown

    Значение

    - 66567

    Описание

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

  • kExtAudioFileError_InvalidSeek

    Попытка записать, или смещение, выходит за пределы.

    Значение

    - 66568

    Описание

    Попытка записать, или смещение, выходит за пределы.

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

  • kExtAudioFileError_AsyncWriteTooLarge

    Значение

    - 66569

    Описание

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

  • kExtAudioFileError_AsyncWriteBufferOverflow

    Асинхронная операция записи не могла быть завершена своевременно.

    Значение

    - 66570

    Описание

    Асинхронная операция записи не могла быть завершена своевременно.

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