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

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

Разработчик

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

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

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

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

Наследование


Не применимый

Соответствует


Не применимый

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


Swift

import AudioToolbox

Objective C

@import AudioToolbox;

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

С Audio File Services Вы можете:

  • Создайте, инициализируйте, откройте и закройте аудиофайлы

  • Считайте и запишите аудиофайлы

  • Оптимизируйте аудиофайлы

  • Работа с пользовательскими данными и глобальной информацией

Функции

  • Создает новый аудиофайл или инициализирует существующий файл, указанный URL.

    Объявление

    Swift

    func AudioFileCreateWithURL(_ inFileRef: CFURL!, _ inFileType: AudioFileTypeID, _ inFormat: UnsafePointer<AudioStreamBasicDescription>, _ inFlags: UInt32, _ outAudioFile: UnsafeMutablePointer<AudioFileID>) -> OSStatus

    Objective C

    OSStatus AudioFileCreateWithURL ( CFURLRef inFileRef, AudioFileTypeID inFileType, const AudioStreamBasicDescription *inFormat, UInt32 inFlags, AudioFileID *outAudioFile );

    Параметры

    inFileRef

    Полностью указанный путь файла, чтобы создать или инициализировать.

    inFileType

    Тип аудиофайла для создания. Посмотрите “Built-In Audio File Types” для констант, которые могут использоваться.

    inFormat

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

    inFlags

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

    outAudioFile

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

    Эта функция использует a CFURLRef введите, а не FSRef введите используемый осуждаемым AudioFileCreate функция.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    Swift

    func AudioFileInitializeWithCallbacks(_ inClientData: UnsafeMutablePointer<Void>, _ inReadFunc: AudioFile_ReadProc, _ inWriteFunc: AudioFile_WriteProc, _ inGetSizeFunc: AudioFile_GetSizeProc, _ inSetSizeFunc: AudioFile_SetSizeProc, _ inFileType: AudioFileTypeID, _ inFormat: UnsafePointer<AudioStreamBasicDescription>, _ inFlags: UInt32, _ outAudioFile: UnsafeMutablePointer<AudioFileID>) -> OSStatus

    Objective C

    OSStatus AudioFileInitializeWithCallbacks ( void *inClientData, AudioFile_ReadProc inReadFunc, AudioFile_WriteProc inWriteFunc, AudioFile_GetSizeProc inGetSizeFunc, AudioFile_SetSizeProc inSetSizeFunc, AudioFileTypeID inFileType, const AudioStreamBasicDescription *inFormat, UInt32 inFlags, AudioFileID *outAudioFile );

    Параметры

    inClientData

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

    inReadFunc

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

    inWriteFunc

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

    inGetSizeFunc

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

    inSetSizeFunc

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

    inFileType

    Тип аудиофайла для инициализации

    inFormat

    Формат для аудиоданные в файле.

    inFlags

    Флаги для создания или открытия файла. Набор к 0.

    outAudioFile

    На выводе, указателе на недавно инициализированный аудиофайл.

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    AudioFileOpenWithCallbacks

  • Откройте существующий аудиофайл, указанный URL.

    Объявление

    Swift

    func AudioFileOpenURL(_ inFileRef: CFURL!, _ inPermissions: Int8, _ inFileTypeHint: AudioFileTypeID, _ outAudioFile: UnsafeMutablePointer<AudioFileID>) -> OSStatus

    Objective C

    OSStatus AudioFileOpenURL ( CFURLRef inFileRef, SInt8 inPermissions, AudioFileTypeID inFileTypeHint, AudioFileID *outAudioFile );

    Параметры

    inFileRef

    URL существующего аудиофайла.

    inPermissions

    Полномочия чтения-записи Вы хотите присвоиться к файлу. Используйте константы разрешения во Флагах Разрешения Аудиофайла.

    inFileTypeHint

    Подсказка для типа файла определяемого файла. Для файлов без расширений файла и с типами не легко или уникально определенный от данных (такими как ADTS или AC3), используйте эту подсказку для указания типа файла. Иначе, передача 0. Только используйте эту подсказку в версиях OS X 10.3.1 или больше. Во всех более ранних версиях, любая попытка открыть эти сбои файлов.

    outAudioFile

    На выводе, указателе на недавно открытый аудиофайл.

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Открывает существующий файл с обратными вызовами, которые Вы обеспечиваете.

    Объявление

    Swift

    func AudioFileOpenWithCallbacks(_ inClientData: UnsafeMutablePointer<Void>, _ inReadFunc: AudioFile_ReadProc, _ inWriteFunc: AudioFile_WriteProc, _ inGetSizeFunc: AudioFile_GetSizeProc, _ inSetSizeFunc: AudioFile_SetSizeProc, _ inFileTypeHint: AudioFileTypeID, _ outAudioFile: UnsafeMutablePointer<AudioFileID>) -> OSStatus

    Objective C

    OSStatus AudioFileOpenWithCallbacks ( void *inClientData, AudioFile_ReadProc inReadFunc, AudioFile_WriteProc inWriteFunc, AudioFile_GetSizeProc inGetSizeFunc, AudioFile_SetSizeProc inSetSizeFunc, AudioFileTypeID inFileTypeHint, AudioFileID *outAudioFile );

    Параметры

    inClientData

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

    inReadFunc

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

    inWriteFunc

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

    inGetSizeFunc

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

    inSetSizeFunc

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

    inFileTypeHint

    Подсказка о типе определяемого файла. Для файлов без расширения файла и без типа легко или уникально определенный от данных (ADTS, AC3), используют эту подсказку для указания типа файла. Иначе, передача 0 для этого параметра. Подсказка только доступна на версиях OS X 10.3.1 или больше. В версиях до OS X 10.3.1, вводные файлы такие сбои файлов.

    outAudioFile

    На выводе, указателе на недавно открытый файл.

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Закрывает аудиофайл.

    Объявление

    Swift

    func AudioFileClose(_ inAudioFile: AudioFileID) -> OSStatus

    Objective C

    OSStatus AudioFileClose ( AudioFileID inAudioFile );

    Параметры

    inAudioFile

    Файл Вы хотите закрыться.

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Байты чтений аудиоданных от аудиофайла.

    Объявление

    Swift

    func AudioFileReadBytes(_ inAudioFile: AudioFileID, _ inUseCache: Boolean, _ inStartingByte: Int64, _ ioNumBytes: UnsafeMutablePointer<UInt32>, _ outBuffer: UnsafeMutablePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioFileReadBytes ( AudioFileID inAudioFile, Boolean inUseCache, SInt64 inStartingByte, UInt32 *ioNumBytes, void *outBuffer );

    Параметры

    inAudioFile

    Аудиофайл, чьи байты аудиоданных Вы хотите считать.

    inUseCache

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

    inStartingByte

    Байтовое смещение аудиоданных Вы хотите быть возвращенными.

    ioNumBytes

    На вводе, указателе на число байтов для чтения. На выводе фактически читал указатель на число байтов.

    outBuffer

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

    В большинстве случаев необходимо использовать AudioFileReadPackets вместо этой функции.

    Эта функция возвраты eofErr когда операция чтения встречается с концом файла. Обратите внимание на то, что Audio File Services только читает один 32-разрядный блок файла за один раз.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    AudioFileWriteBytes

  • Байты записей аудиоданных к аудиофайлу.

    Объявление

    Swift

    func AudioFileWriteBytes(_ inAudioFile: AudioFileID, _ inUseCache: Boolean, _ inStartingByte: Int64, _ ioNumBytes: UnsafeMutablePointer<UInt32>, _ inBuffer: UnsafePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioFileWriteBytes ( AudioFileID inAudioFile, Boolean inUseCache, SInt64 inStartingByte, UInt32 *ioNumBytes, const void *inBuffer );

    Параметры

    inAudioFile

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

    inUseCache

    Набор к true если Вы хотите кэшировать данные. Иначе, набор к false.

    inStartingByte

    Байтовое смещение, где должны быть записаны аудиоданные.

    ioNumBytes

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

    inBuffer

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

    В большинстве случаев необходимо использовать AudioFileWritePackets вместо этой функции.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    AudioFileReadBytes

  • Пакеты чтений аудиоданных от аудиофайла.

    Объявление

    Swift

    func AudioFileReadPacketData(_ inAudioFile: AudioFileID, _ inUseCache: Boolean, _ ioNumBytes: UnsafeMutablePointer<UInt32>, _ outPacketDescriptions: UnsafeMutablePointer<AudioStreamPacketDescription>, _ inStartingPacket: Int64, _ ioNumPackets: UnsafeMutablePointer<UInt32>, _ outBuffer: UnsafeMutablePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioFileReadPacketData ( AudioFileID inAudioFile, Boolean inUseCache, UInt32 *ioNumBytes, AudioStreamPacketDescription *outPacketDescriptions, SInt64 inStartingPacket, UInt32 *ioNumPackets, void *outBuffer );

    Параметры

    inAudioFile

    Аудиофайл, аудио пакеты которого Вы хотите считать.

    inUseCache

    Набор к true кэшировать данные. Иначе, набор к false.

    ioNumBytes

    На вводе, размере outBuffer параметр, в байтах. На выводе фактически читало число байтов.

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

    outPacketDescriptions

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

    Этот параметр применяется только к данным с переменной скоростью передачи. Если считанный файл содержит данные с постоянной скоростью передачи (CBR), такие как линейный PCM, этот параметр не становится заполненным. Передача NULL если форматом данных файла является CBR.

    inStartingPacket

    Пакетный индекс первого пакета Вы хотите читать.

    ioNumPackets

    На вводе, числе пакетов для чтения. На выводе фактически читало число пакетов.

    outBuffer

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

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

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

    Эта функция более эффективна, чем AudioFileReadPackets при чтении форматов сжатого файла, не имеющих пакетных таблиц, таких как MP3 или ADTS. Если Вы не должны читать фиксированную продолжительность аудио, эта функция является хорошим выбором для чтения или CBR (постоянная скорость передачи) или данные VBR. Если действительно необходимо считать фиксированную продолжительность аудио, или CBR или VBR, использовать AudioFileReadPackets вместо этого.

    Audio File Services читает один 32-разрядный блок файла за один раз.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.2 и позже.

    См. также

    AudioFileWritePackets

  • Читает фиксированную продолжительность аудиоданных от аудиофайла.

    Объявление

    Swift

    func AudioFileReadPackets(_ inAudioFile: AudioFileID, _ inUseCache: Boolean, _ outNumBytes: UnsafeMutablePointer<UInt32>, _ outPacketDescriptions: UnsafeMutablePointer<AudioStreamPacketDescription>, _ inStartingPacket: Int64, _ ioNumPackets: UnsafeMutablePointer<UInt32>, _ outBuffer: UnsafeMutablePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioFileReadPackets ( AudioFileID inAudioFile, Boolean inUseCache, UInt32 *outNumBytes, AudioStreamPacketDescription *outPacketDescriptions, SInt64 inStartingPacket, UInt32 *ioNumPackets, void *outBuffer );

    Параметры

    inAudioFile

    Аудиофайл, аудио пакеты которого Вы хотите считать.

    inUseCache

    Набор к true кэшировать данные. Иначе, набор к false.

    outNumBytes

    На выводе фактически читало число байтов.

    outPacketDescriptions

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

    Этот параметр применяется только к данным с переменной скоростью передачи. Если считанный файл содержит данные с постоянной скоростью передачи (CBR), такие как линейный PCM, этот параметр не становится заполненным. Передача NULL если форматом данных файла является CBR.

    inStartingPacket

    Пакетный индекс первого пакета Вы хотите читать.

    ioNumPackets

    На вводе, числе пакетов для чтения. На выводе фактически читало число пакетов.

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

    outBuffer

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

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

    Когда чтение аудиоданных с переменной скоростью передачи (VBR), использование этой функции требуют, чтобы Вы выделили больше памяти, чем Вы были бы для AudioFileReadPacketData функция. См. описания для outBuffer параметр в каждой из этих двух функций.

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

    Audio File Services читает один 32-разрядный блок файла за один раз.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

    Осуждаемый в iOS 8.0.

    См. также

    AudioFileWritePackets

  • Пакеты записей аудиоданных к файлу аудиоданных.

    Объявление

    Swift

    func AudioFileWritePackets(_ inAudioFile: AudioFileID, _ inUseCache: Boolean, _ inNumBytes: UInt32, _ inPacketDescriptions: UnsafePointer<AudioStreamPacketDescription>, _ inStartingPacket: Int64, _ ioNumPackets: UnsafeMutablePointer<UInt32>, _ inBuffer: UnsafePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioFileWritePackets ( AudioFileID inAudioFile, Boolean inUseCache, UInt32 inNumBytes, const AudioStreamPacketDescription *inPacketDescriptions, SInt64 inStartingPacket, UInt32 *ioNumPackets, const void *inBuffer );

    Параметры

    inAudioFile

    Аудиофайл для записи в.

    inUseCache

    Набор к true если Вы хотите кэшировать данные. Иначе, набор к false.

    inNumBytes

    Число байтов записанных аудиоданных.

    inPacketDescriptions

    Указатель на массив описаний пакета для аудиоданных. Не все форматы требуют описаний пакета. Например, если Вы пишете данные CBR, передачу, если не требуются никакие описания пакета NULL.

    inStartingPacket

    Пакетный индекс для размещения первого предоставленного пакета.

    ioNumPackets

    На вводе, указателе на число пакетов для записи. На выводе, указателе на число пакетов, фактически записанных.

    inBuffer

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

    Для всех несжатых форматов эта функция приравнивает пакеты с кадрами.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    AudioFileReadPackets

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

    Объявление

    Swift

    func AudioFileGetProperty(_ inAudioFile: AudioFileID, _ inPropertyID: AudioFilePropertyID, _ ioDataSize: UnsafeMutablePointer<UInt32>, _ outPropertyData: UnsafeMutablePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioFileGetProperty ( AudioFileID inAudioFile, AudioFilePropertyID inPropertyID, UInt32 *ioDataSize, void *outPropertyData );

    Параметры

    inAudioFile

    Аудиофайл Вы хотите получить значение свойства из.

    inPropertyID

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

    ioDataSize

    На вводе размер буфера передал в outPropertyData параметр. На выводе, числе байтов, записанных в буфер. Используйте AudioFileGetPropertyInfo функция для получения размера значения свойства.

    outPropertyData

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

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

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

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Получает информацию о свойстве аудиофайла, включая размер значения свойства и перезаписываемо ли значение.

    Объявление

    Swift

    func AudioFileGetPropertyInfo(_ inAudioFile: AudioFileID, _ inPropertyID: AudioFilePropertyID, _ outDataSize: UnsafeMutablePointer<UInt32>, _ isWritable: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus AudioFileGetPropertyInfo ( AudioFileID inAudioFile, AudioFilePropertyID inPropertyID, UInt32 *outDataSize, UInt32 *isWritable );

    Параметры

    inAudioFile

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

    inPropertyID

    Свойство, информацию о значении которого Вы хотите. Посмотрите Свойства Аудиофайла для возможных значений.

    outDataSize

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

    isWritable

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    AudioFileGetProperty

  • Устанавливает значение свойства аудиофайла

    Объявление

    Swift

    func AudioFileSetProperty(_ inAudioFile: AudioFileID, _ inPropertyID: AudioFilePropertyID, _ inDataSize: UInt32, _ inPropertyData: UnsafePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioFileSetProperty ( AudioFileID inAudioFile, AudioFilePropertyID inPropertyID, UInt32 inDataSize, const void *inPropertyData );

    Параметры

    inAudioFile

    Аудиофайл, для которого Вы хотите установить значение свойства.

    inPropertyID

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

    inDataSize

    Размер значения Вы являетесь передающими в inPropertyData параметр.

    inPropertyData

    Новое значение для свойства.

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Получает число пользовательских элементов данных с указанным ID в файле.

    Объявление

    Swift

    func AudioFileCountUserData(_ inAudioFile: AudioFileID, _ inUserDataID: UInt32, _ outNumberItems: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus AudioFileCountUserData ( AudioFileID inAudioFile, UInt32 inUserDataID, UInt32 *outNumberItems );

    Параметры

    inAudioFile

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

    inUserDataID

    Четыре кода символа (такой как COMM) из пользовательского элемента данных.

    outNumberItems

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

    В контексте этой функции пользовательские данные относятся к блокам в AIFF, CAF и файлах WAVE, к ресурсам в Звукорежиссере II файлов, и возможно к другим типам информации в других файлах.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Получает размер пользовательского элемента данных в аудиофайле.

    Объявление

    Swift

    func AudioFileGetUserDataSize(_ inAudioFile: AudioFileID, _ inUserDataID: UInt32, _ inIndex: UInt32, _ outUserDataSize: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus AudioFileGetUserDataSize ( AudioFileID inAudioFile, UInt32 inUserDataID, UInt32 inIndex, UInt32 *outUserDataSize );

    Параметры

    inAudioFile

    Аудиофайл, пользовательский размер элемента данных которого Вы хотите.

    inUserDataID

    Четыре кода символа определяемого пользовательского элемента данных.

    inIndex

    Индекс, указывающий, который пользовательский элемент данных с четырьмя кодами символа, указанными в inUserDataID параметр Вы хотите запросить.

    outUserDataSize

    На выводе, указатель размер пользовательского элемента данных.

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

    В контексте этой функции пользовательские данные относятся к блокам в AIFF, CAF и файлах WAVE, к ресурсам в Звукорежиссере II файлов, и возможно к другим типам информации в других файлах.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    Swift

    func AudioFileRemoveUserData(_ inAudioFile: AudioFileID, _ inUserDataID: UInt32, _ inIndex: UInt32) -> OSStatus

    Objective C

    OSStatus AudioFileRemoveUserData ( AudioFileID inAudioFile, UInt32 inUserDataID, UInt32 inIndex );

    Параметры

    inAudioFile

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

    inUserDataID

    Четыре кода символа такой как COMM из пользовательского элемента данных.

    inIndex

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    Swift

    func AudioFileSetUserData(_ inAudioFile: AudioFileID, _ inUserDataID: UInt32, _ inIndex: UInt32, _ inUserDataSize: UInt32, _ inUserData: UnsafePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioFileSetUserData ( AudioFileID inAudioFile, UInt32 inUserDataID, UInt32 inIndex, UInt32 inUserDataSize, const void *inUserData );

    Параметры

    inAudioFile

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

    inUserDataID

    Четыре кода символа для пользовательского элемента данных.

    inIndex

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

    inUserDataSize

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

    inUserData

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    AudioFileGetUserData

  • Получает блок от аудиофайла.

    Объявление

    Swift

    func AudioFileGetUserData(_ inAudioFile: AudioFileID, _ inUserDataID: UInt32, _ inIndex: UInt32, _ ioUserDataSize: UnsafeMutablePointer<UInt32>, _ outUserData: UnsafeMutablePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioFileGetUserData ( AudioFileID inAudioFile, UInt32 inUserDataID, UInt32 inIndex, UInt32 *ioUserDataSize, void *outUserData );

    Параметры

    inAudioFile

    Аудиофайл, блок которого Вы хотите получить.

    inUserDataID

    Четыре кода символа определяемого блока.

    inIndex

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

    ioUserDataSize

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

    outUserData

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    AudioFileSetUserData

  • Получает размер глобального свойства аудиофайла.

    Объявление

    Swift

    func AudioFileGetGlobalInfoSize(_ inPropertyID: AudioFilePropertyID, _ inSpecifierSize: UInt32, _ inSpecifier: UnsafeMutablePointer<Void>, _ outDataSize: UnsafeMutablePointer<UInt32>) -> OSStatus

    Objective C

    OSStatus AudioFileGetGlobalInfoSize ( AudioFilePropertyID inPropertyID, UInt32 inSpecifierSize, void *inSpecifier, UInt32 *outDataSize );

    Параметры

    inPropertyID

    Свойство, размер данных которого Вы хотите получить. Для возможных значений посмотрите Глобальные Информационные Свойства Аудиофайла.

    inSpecifier

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

    outDataSize

    Указатель на размер в байтах текущей стоимости свойства. Для получения размера значения свойства Вам нужен буфер этого размера.

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Копирует значение глобального свойства в буфер.

    Объявление

    Swift

    func AudioFileGetGlobalInfo(_ inPropertyID: AudioFilePropertyID, _ inSpecifierSize: UInt32, _ inSpecifier: UnsafeMutablePointer<Void>, _ ioDataSize: UnsafeMutablePointer<UInt32>, _ outPropertyData: UnsafeMutablePointer<Void>) -> OSStatus

    Objective C

    OSStatus AudioFileGetGlobalInfo ( AudioFilePropertyID inPropertyID, UInt32 inSpecifierSize, void *inSpecifier, UInt32 *ioDataSize, void *outPropertyData );

    Параметры

    inPropertyID

    Свойство, значение которого Вы хотите получить. Для возможных значений посмотрите Глобальные Информационные Свойства Аудиофайла.

    inSpecifierSize

    Размер данных спецификатора.

    inSpecifier

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

    ioDataSize

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

    outPropertyData

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

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

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

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

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Консолидирует аудиоданные и выполняет другую внутреннюю оптимизацию файловой структуры.

    Объявление

    Swift

    func AudioFileOptimize(_ inAudioFile: AudioFileID) -> OSStatus

    Objective C

    OSStatus AudioFileOptimize ( AudioFileID inAudioFile );

    Параметры

    inAudioFile

    Аудиофайл Вы хотите оптимизировать.

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

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

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    Objective C

    #define NumBytesToNumAudioFileMarkers (inNumBytes) ( (inNumBytes) < offsetof (AudioFileMarkerList, mMarkers[0]) ? 0 : ((inNumBytes) - offsetof (AudioFileMarkerList, mMarkers[0])) / sizeof (AudioFileMarker) )

    Параметры

    inNumBytes

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

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

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

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    AudioFileGetProperty

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

    Объявление

    Objective C

    #define NumAudioFileMarkersToNumBytes(inNumMarkers) ( offsetof (AudioFileMarkerList, mMarkers) + (inNumMarkers) * sizeof(AudioFileMarker) )

    Параметры

    inNumMarkers

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

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

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

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    AudioFileSetProperty

  • Находит следующую область аудиофайла в списке области.

    Объявление

    Objective C

    #define NextAudioFileRegion (inAFRegionPtr) ( (AudioFileRegion*) ((char*) (inAFRegionPtr) + offsetof(AudioFileRegion, mMarkers) + ((inAFRegionPtr)->mNumberMarkers) * sizeof (AudioFileMarker)) )

    Параметры

    inAFRegionPtr

    Указатель на область аудиофайла в списке области.

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

    Указатель на следующую область после области, на которую указывают inAFRegionPtr параметр. Это значение может быть вне конца списка, поэтому обратить внимание на общее количество областей в списке.

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    AudioFileSetProperty

Обратные вызовы

  • Аудиоданные чтений, когда используется в сочетании с AudioFileOpenWithCallbacks или AudioFileInitializeWithCallbacks функции.)

    Объявление

    Swift

    typealias AudioFile_ReadProc = CFunctionPointer<((UnsafeMutablePointer<Void>, Int64, UInt32, UnsafeMutablePointer<Void>, UnsafeMutablePointer<UInt32>) -> OSStatus)>

    Objective C

    typedef OSStatus (*AudioFile_ReadProc) ( void *inClientData, SInt64 inPosition, UInt32 requestCount, void *buffer, UInt32 *actualCount );

    Параметры

    inClientData

    Указатель на клиентские данные, как начато inClientData параметр к AudioFileOpenWithCallbacks или AudioFileInitializeWithCallbacks.

    inPosition

    Смещение в данные, из которых можно читать.

    requestCount

    Число байтов для чтения.

    buffer

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

    actualCount

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

    Когда Audio File Services должна считать данные, эту функцию обратного вызова вызывают.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Обратный вызов для записи данных файла, когда используется в сочетании с AudioFileOpenWithCallbacks или AudioFileCreateWithURL функции.

    Объявление

    Swift

    typealias AudioFile_WriteProc = CFunctionPointer<((UnsafeMutablePointer<Void>, Int64, UInt32, UnsafePointer<Void>, UnsafeMutablePointer<UInt32>) -> OSStatus)>

    Objective C

    typedef OSStatus (*AudioFile_WriteProc) ( void *inClientData, SInt64 inPosition, UInt32 requestCount, const void *buffer, UInt32 *actualCount );

    Параметры

    inClientData

    Указатель на клиентские данные, как начато inClientData параметр к AudioFileOpenWithCallbacks илиAudioFileInitializeWithCallbacks.

    inPosition

    Смещение в данные, из которых можно читать.

    requestCount

    Число байтов для записи.

    buffer

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

    actualCount

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

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

    Код результата. Посмотрите Коды Результата Аудиофайла.

    Обсуждение

    Когда Audio File Services должна записать данные, эта функция обратного вызова вызывается.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Получает размер данных файла.

    Объявление

    Swift

    typealias AudioFile_GetSizeProc = CFunctionPointer<((UnsafeMutablePointer<Void>) -> Int64)>

    Objective C

    typedef SInt64 (*AudioFile_GetSizeProc)( void *inClientData );

    Параметры

    inClientData

    Указатель на клиентские данные, как начато inClientData параметр к AudioFileOpenWithCallbacks или AudioFileInitializeWithCallbacks функции.

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

    Обратный вызов должен возвратить размер данных.

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Размер данных файла наборов.

    Объявление

    Swift

    typealias AudioFile_SetSizeProc = CFunctionPointer<((UnsafeMutablePointer<Void>, Int64) -> OSStatus)>

    Objective C

    typedef SInt64 (*AudioFile_SetSizeProc)( void *inClientData );

    Параметры

    inClientData

    Указатель на клиентские данные, как начато inClientData параметр к AudioFileOpenWithCallbacks или AudioFileInitializeWithCallbacks функции.

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

    Обратный вызов должен возвратить размер данных.

    Обсуждение

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

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

Типы данных

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

    Объявление

    Swift

    typealias AudioFileID = COpaquePointer

    Objective C

    typedef struct OpaqueAudioFileID *AudioFileID;

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    Swift

    typealias AudioFilePropertyID = UInt32

    Objective C

    typedef UInt32 AudioFilePropertyID;

    Обсуждение

    Для списка свойств аудиофайла посмотрите Свойства Аудиофайла.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Структура данных для описания SMPTE (Общество Изображения движущихся объектов и Телевизионных Инженеров) время.

    Объявление

    Swift

    struct AudioFile_SMPTE_Time { var mHours: Int8 var mMinutes: UInt8 var mSeconds: UInt8 var mFrames: UInt8 var mSubFrameSampleOffset: UInt32 init() init(mHours mHours: Int8, mMinutes mMinutes: UInt8, mSeconds mSeconds: UInt8, mFrames mFrames: UInt8, mSubFrameSampleOffset mSubFrameSampleOffset: UInt32) }

    Objective C

    struct AudioFile_SMPTE_Time { SInt8 mHours; UInt8 mMinutes; UInt8 mSeconds; UInt8 mFrames; UInt32 mSubFrameSampleOffset; }; typedef struct AudioFile_SMPTE_Time AudioFile_SMPTE_Time;

    Поля

    mHours

    Часы.

    mMinutes

    Минуты.

    mSeconds

    Секунды.

    mFrames

    Кадры.

    mSubFrameSampleOffset

    Демонстрационное смещение в кадре.

    Доступность

    Доступный в iOS 2.0 и позже.

  • Аннотирует позицию в аудиофайле.

    Объявление

    Swift

    struct AudioFileMarker { var mFramePosition: Float64 var mName: Unmanaged<CFString>! var mMarkerID: Int32 var mSMPTETime: AudioFile_SMPTE_Time var mType: UInt32 var mReserved: UInt16 var mChannel: UInt16 init() init(mFramePosition mFramePosition: Float64, mName mName: Unmanaged<CFString>!, mMarkerID mMarkerID: Int32, mSMPTETime mSMPTETime: AudioFile_SMPTE_Time, mType mType: UInt32, mReserved mReserved: UInt16, mChannel mChannel: UInt16) }

    Objective C

    struct AudioFileMarker { Float64 mFramePosition; CFStringRef mName; SInt32 mMarkerID; AudioFile_SMPTE_Time mSMPTETime; UInt32 mType; UInt16 mReserved; UInt16 mChannel; }; typedef struct AudioFileMarker AudioFileMarker;

    Поля

    mFramePosition

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

    mName

    Имя маркера.

    mMarkerID

    Уникальный идентификатор для маркера.

    mSMPTETime

    Время SMPTE для этого маркера.

    mType

    Тип маркера.

    mReserved

    Зарезервированное поле. Набор к 0.

    mChannel

    Номер канала именуется маркером. Набор к 0 если маркер применяется ко всем каналам.

    Доступность

    Доступный в iOS 2.0 и позже.

  • Список маркеров связался с аудиофайлом, включая их тип времени SMPTE, число маркеров и самих маркеров.

    Объявление

    Swift

    struct AudioFileMarkerList { var mSMPTE_TimeType: UInt32 var mNumberMarkers: UInt32 var mMarkers: (AudioFileMarker) init() init(mSMPTE_TimeType mSMPTE_TimeType: UInt32, mNumberMarkers mNumberMarkers: UInt32, mMarkers mMarkers: (AudioFileMarker)) }

    Objective C

    struct AudioFileMarkerList { UInt32 mSMPTE_TimeType; UInt32 mNumberMarkers; AudioFileMarker mMarkers[1]; }; typedef struct AudioFileMarkerList AudioFileMarkerList;

    Поля

    mSMPTE_TimeType

    Тип времени SMPTE целого списка маркеров в аудиофайле.

    mNumberMarkers

    Число маркеров в списке.

    mMarkers

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

    Доступность

    Доступный в iOS 2.0 и позже.

  • Область аудиофайла указывает сегмент аудиоданных.

    Объявление

    Swift

    struct AudioFileRegion { var mRegionID: UInt32 var mName: Unmanaged<CFString>! var mFlags: UInt32 var mNumberMarkers: UInt32 var mMarkers: (AudioFileMarker) init() init(mRegionID mRegionID: UInt32, mName mName: Unmanaged<CFString>!, mFlags mFlags: UInt32, mNumberMarkers mNumberMarkers: UInt32, mMarkers mMarkers: (AudioFileMarker)) }

    Objective C

    struct AudioFileRegion { UInt32 mRegionID; CFStringRef mName; UInt32 mFlags; UInt32 mNumberMarkers; AudioFileMarker mMarkers[1]; }; typedef struct AudioFileRegion AudioFileRegion;

    Поля

    mRegionID

    Уникальный идентификатор связался с областью аудиофайла.

    mName

    Имя области.

    mFlags

    Флаги области Audio File Services. Для получения дополнительной информации посмотрите Флаги Области Аудиофайла.

    mNumberMarkers

    Число маркеров в массиве, указанном в mMarkers параметр.

    mMarkers

    Массив mNumberMarkers элементы, описывающие, где запускаются данные в области. Для получения дополнительной информации посмотрите Типы Маркера Аудиофайла.

    Обсуждение

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

    Доступность

    Доступный в iOS 2.0 и позже.

  • Список областей аудиофайла в файле.

    Объявление

    Swift

    struct AudioFileRegionList { var mSMPTE_TimeType: UInt32 var mNumberRegions: UInt32 var mRegions: (AudioFileRegion) init() init(mSMPTE_TimeType mSMPTE_TimeType: UInt32, mNumberRegions mNumberRegions: UInt32, mRegions mRegions: (AudioFileRegion)) }

    Objective C

    struct AudioFileRegionList { UInt32 mSMPTE_TimeType; UInt32 mNumberRegions; AudioFileRegion mRegions[1]; }; typedef struct AudioFileRegionList AudioFileRegionList;

    Поля

    mSMPTE_TimeType

    SMPTE синхронизация схемы используется в файле. Посмотрите Core Audio CAFFile.h заголовочный файл для значений, используемых здесь. Для получения дополнительной информации см. Обзор Core Audio.

    mNumberRegions

    Число областей в списке, указанном в mRegions параметр.

    mRegions

    Переменный массив mNumberRegions элементы, содержащие список больше чем одной области аудиофайла. Для получения информации о AudioFileRegion тип данных, посмотрите AudioFileRegion.

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

    Используйте NextAudioFileRegion макрос удобства для того, чтобы пересечь список области вместо этого. Этот макрос позволяет Вам продвинуться в следующую область в данных та Audio File Services возвраты.

    Обсуждение

    Эта структура используется kAudioFilePropertyRegionList свойство.

    Доступность

    Доступный в iOS 2.0 и позже.

  • Структура данных, используемая kAudioFilePropertyPacketToFrame и kAudioFilePropertyFrameToPacket свойства.

    Объявление

    Swift

    struct AudioFramePacketTranslation { var mFrame: Int64 var mPacket: Int64 var mFrameOffsetInPacket: UInt32 init() init(mFrame mFrame: Int64, mPacket mPacket: Int64, mFrameOffsetInPacket mFrameOffsetInPacket: UInt32) }

    Objective C

    struct AudioFramePacketTranslation { SInt64 mFrame; SInt64 mPacket; UInt32 mFrameOffsetInPacket; }; typedef struct AudioFramePacketTranslation AudioFramePacketTranslation;

    Поля

    mFrame

    Число кадра.

    mPacket

    Пакетное число.

    mFrameOffsetInPacket

    Смещение кадра в пакете.

    Доступность

    Доступный в iOS 2.0 и позже.

  • Структура данных, используемая kAudioFilePropertyByteToPacket и kAudioFilePropertyPacketToByte свойства.

    Объявление

    Swift

    struct AudioBytePacketTranslation { var mByte: Int64 var mPacket: Int64 var mByteOffsetInPacket: UInt32 var mFlags: UInt32 init() init(mByte mByte: Int64, mPacket mPacket: Int64, mByteOffsetInPacket mByteOffsetInPacket: UInt32, mFlags mFlags: UInt32) }

    Objective C

    struct AudioBytePacketTranslation { SInt64 mByte; SInt64 mPacket; UInt32 mByteOffsetInPacket; UInt32 mFlags; }; typedef struct AudioBytePacketTranslation AudioBytePacketTranslation;

    Поля

    mByte

    Число байта.

    mPacket

    Пакетное число.

    mByteOffsetInPacket

    Байтовое смещение в пакете.

    mFlags

    Доступность

    Доступный в iOS 2.0 и позже.

  • Содержит информацию о числе допустимых кадров в файле и где они начинают и заканчиваются.

    Объявление

    Swift

    struct AudioFilePacketTableInfo { var mNumberValidFrames: Int64 var mPrimingFrames: Int32 var mRemainderFrames: Int32 init() init(mNumberValidFrames mNumberValidFrames: Int64, mPrimingFrames mPrimingFrames: Int32, mRemainderFrames mRemainderFrames: Int32) }

    Objective C

    struct AudioFilePacketTableInfo { SInt64 mNumberValidFrames; SInt32 mPrimingFrames; SInt32 mRemainderFrames; }; typedef struct AudioFilePacketTableInfo AudioFilePacketTableInfo;

    Поля

    mNumberValidFrames

    Число допустимых кадров в файле.

    mPrimingFrames

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

    mRemainderFrames

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

    Обсуждение

    Некоторые форматы данных могли бы иметь пакеты с содержанием, которое не абсолютно допустимо, но представляющим воспламенение или кадры остатка, не предназначенные для воспроизведения. Например, файл с 100 пакетами AAC номинально 1024 * 100 = 102 400 кадров данных. Однако первые 2 112 кадров могли бы быть кадрами воспламенения.

    Много кадров остатка могли бы быть добавлены для увеличивания к полному пакету 1 024 кадров. Отбросьте кадры остатка и воспламенение.

    Общее количество пакетов во времена файла кадры на пакет (или считающий кадры каждого пакета индивидуально для переменной структурирует на формат пакета), минус mPrimingFrames, минус mRemainderFrames, должен равняться mNumberValidFrames.

    Доступность

    Доступный в iOS 2.0 и позже.

  • Спецификатор для константыkAudioFileGlobalInfo_AvailableStreamDescriptionsForFormat.

    Объявление

    Swift

    struct AudioFileTypeAndFormatID { var mFileType: AudioFileTypeID var mFormatID: UInt32 init() init(mFileType mFileType: AudioFileTypeID, mFormatID mFormatID: UInt32) }

    Objective C

    struct AudioFileTypeAndFormatID { AudioFileTypeID mFileType; UInt32 mFormatID; }; typedef struct AudioFileTypeAndFormatID AudioFileTypeAndFormatID;

    Поля

    mFileType

    Четыре кода символа для типа файла (например, kAudioFileAIFFType ввести.

    mFormatID

    Четыре кода символа для идентификатора формата такой как kAudioFormatLinearPCM, kAudioFormatMPEG4AAC, и т.д. (См. AudioFormat.h заголовочный файл для объявлений.)

    Обсуждение

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

    Доступность

    Доступный в iOS 2.0 и позже.

Константы

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

    Объявление

    Swift

    typealias AudioFileTypeID = UInt32

    Objective C

    enum { kAudioFileAIFFType = 'AIFF', kAudioFileAIFCType = 'AIFC', kAudioFileWAVEType = 'WAVE', kAudioFileSoundDesigner2Type = 'Sd2f', kAudioFileNextType = 'NeXT', kAudioFileMP3Type = 'MPG3', kAudioFileMP2Type = 'MPG2', kAudioFileMP1Type = 'MPG1', kAudioFileAC3Type = 'ac-3', kAudioFileAAC_ADTSType = 'adts', kAudioFileMPEG4Type = 'mp4f', kAudioFileM4AType = 'm4af', kAudioFileCAFType = 'caff', kAudioFile3GPType = '3gpp', kAudioFile3GP2Type = '3gp2', kAudioFileAMRType = 'amrf' }; typedef UInt32 AudioFileTypeID;

    Константы

    • kAudioFileAIFFType

      Файл Audio Interchange File Format (AIFF).

      Доступный в iOS 2.0 и позже.

    • kAudioFileAIFCType

      Аудио Формат файла Обмена, Сжатый (AIFF-C) файл.

      Доступный в iOS 2.0 и позже.

    • kAudioFileWAVEType

      Файл Microsoft WAVE.

      Доступный в iOS 2.0 и позже.

    • kAudioFileSoundDesigner2Type

      Звукорежиссер II файлов.

      Доступный в iOS 2.0 и позже.

    • kAudioFileNextType

      NeXT или файл Sun Microsystems.

      Доступный в iOS 2.0 и позже.

    • kAudioFileMP3Type

      Уровень 3 аудио MPEG (.mp3) файл.

      Доступный в iOS 2.0 и позже.

    • kAudioFileMP2Type

      Уровень 2 аудио MPEG (.mp2) файл.

      Доступный в iOS 2.0 и позже.

    • kAudioFileMP1Type

      Уровень 1 аудио MPEG (.mp1) файл.

      Доступный в iOS 2.0 и позже.

    • kAudioFileAC3Type

      Файл AC 3.

      Доступный в iOS 2.0 и позже.

    • kAudioFileAAC_ADTSType

      Усовершенствованное кодирование звука (AAC) файл Audio Data Transport Stream (ADTS).

      Доступный в iOS 2.0 и позже.

    • kAudioFileMPEG4Type

      Файл MPEG 4.

      Доступный в iOS 2.0 и позже.

    • kAudioFileM4AType

      Файл M4A.

      Доступный в iOS 2.0 и позже.

    • kAudioFileCAFType

      Файл Формата файла Core Audio.

      Доступный в iOS 2.0 и позже.

    • kAudioFile3GPType

      3GPP файл, подходящий для видеоконтента на Мобильных телефонах стандарта GSM.

      Доступный в iOS 2.0 и позже.

    • kAudioFile3GP2Type

      3GPP2 файл, подходящий для видеоконтента по мобильным телефонам CDMA.

      Доступный в iOS 2.0 и позже.

    • kAudioFileAMRType

      AMR (Адаптивный Мультиуровень) файл, подходящий для сжатой речи.

      Доступный в iOS 2.0 и позже.

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

    Objective C

    @import AudioToolbox;

    Swift

    import AudioToolbox

    Доступность

    Доступный в iOS 2.0 и позже.

  • Флаги для использования с AudioFileCreateWithURL и AudioFileCreate функции.

    Объявление

    Swift

    var kAudioFileFlags_EraseFile: Int { get } var kAudioFileFlags_DontPageAlignAudioData: Int { get }

    Objective C

    enum { kAudioFileFlags_EraseFile = 1 kAudioFileFlags_DontPageAlignAudioData = 2 };

    Константы

    • kAudioFileFlags_EraseFile

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

      Доступный в iOS 2.0 и позже.

    • kAudioFileFlags_DontPageAlignAudioData

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

      Доступный в iOS 2.0 и позже.

  • Флаги для использования с AudioFileOpenURL и AudioFileOpen функции.

    Объявление

    Swift

    var kAudioFileReadPermission: Int { get } var kAudioFileWritePermission: Int { get } var kAudioFileReadWritePermission: Int { get }

    Objective C

    enum { kAudioFileReadPermission = 0x01, kAudioFileWritePermission = 0x02, kAudioFileReadWritePermission = 0x03 };

    Константы

    • kAudioFileReadPermission

      Файл только для чтения.

      Доступный в iOS 2.0 и позже.

    • kAudioFileWritePermission

      Файл только для записи.

      Доступный в iOS 2.0 и позже.

    • kAudioFileReadWritePermission

      Файл имеет разрешение чтения-записи.

      Доступный в iOS 2.0 и позже.

  • Направление воспроизведения циклично выполненного сегмента аудиофайла.

    Объявление

    Swift

    var kAudioFileLoopDirection_NoLooping: Int { get } var kAudioFileLoopDirection_Forward: Int { get } var kAudioFileLoopDirection_Backward: Int { get } var kAudioFileLoopDirection_ForwardAndBackward: Int { get }

    Objective C

    enum { kAudioFileLoopDirection_NoLooping = 0, kAudioFileLoopDirection_Forward = 1, kAudioFileLoopDirection_ForwardAndBackward = 2, kAudioFileLoopDirection_Backward = 3 };

    Константы

    • kAudioFileLoopDirection_NoLooping

      Сегмент не циклично выполняется.

      Доступный в iOS 2.0 и позже.

    • kAudioFileLoopDirection_Forward

      Играйте сегмент вперед.

      Доступный в iOS 2.0 и позже.

    • kAudioFileLoopDirection_Backward

      Играйте сегмент назад.

      Доступный в iOS 2.0 и позже.

    • kAudioFileLoopDirection_ForwardAndBackward

      Играйте сегмент вперед и назад.

      Доступный в iOS 2.0 и позже.

  • Тип маркера в файле, используемом в mType поле AudioFileMarker структура.

    Объявление

    Swift

    var kAudioFileMarkerType_Generic: Int { get }

    Objective C

    enum { kAudioFileMarkerType_Generic = 0, };

    Константы

    • kAudioFileMarkerType_Generic

      Универсальный маркер.

      Доступный в iOS 2.0 и позже.

  • Флаги, указывающие направление воспроизведения для AudioFileRegion структура.

    Объявление

    Swift

    var kAudioFileRegionFlag_LoopEnable: Int { get } var kAudioFileRegionFlag_PlayForward: Int { get } var kAudioFileRegionFlag_PlayBackward: Int { get }

    Objective C

    enum { kAudioFileRegionFlag_LoopEnable = 1, kAudioFileRegionFlag_PlayForward = 2, kAudioFileRegionFlag_PlayBackward = 4 };

    Константы

    • kAudioFileRegionFlag_LoopEnable

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

      Доступный в iOS 2.0 и позже.

    • kAudioFileRegionFlag_PlayForward

      Если установлено, область играется вперед.

      Доступный в iOS 2.0 и позже.

    • kAudioFileRegionFlag_PlayBackward

      Если установлено, область играется назад.

      Доступный в iOS 2.0 и позже.

    Обсуждение

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

  • Флаг, используемый с mFlags поле AudioBytePacketTranslation структура.

    Объявление

    Swift

    var kBytePacketTranslationFlag_IsEstimate: Int { get }

    Objective C

    enum { kBytePacketTranslationFlag_IsEstimate = 1 };

    Константы

    • kBytePacketTranslationFlag_IsEstimate

      Если установлено, значение результата является оценкой.

      Доступный в iOS 2.0 и позже.

  • Значения ключа свойств, чтобы добраться и установить использование функции Audio File Services и обеспечить распространенный способ вытащить ту же информацию из нескольких различных видов файлов.

    Объявление

    Swift

    var kAFInfoDictionary_Artist: String { get } var kAFInfoDictionary_Album: String { get } var kAFInfoDictionary_Tempo: String { get } var kAFInfoDictionary_KeySignature: String { get } var kAFInfoDictionary_TimeSignature: String { get } var kAFInfoDictionary_TrackNumber: String { get } var kAFInfoDictionary_Year: String { get } var kAFInfoDictionary_Composer: String { get } var kAFInfoDictionary_Lyricist: String { get } var kAFInfoDictionary_Genre: String { get } var kAFInfoDictionary_Title: String { get } var kAFInfoDictionary_RecordedDate: String { get } var kAFInfoDictionary_Comments: String { get } var kAFInfoDictionary_Copyright: String { get } var kAFInfoDictionary_SourceEncoder: String { get } var kAFInfoDictionary_EncodingApplication: String { get } var kAFInfoDictionary_NominalBitRate: String { get } var kAFInfoDictionary_ChannelLayout: String { get } var kAFInfoDictionary_ApproximateDurationInSeconds: String { get } var kAFInfoDictionary_SourceBitDepth: String { get } var kAFInfoDictionary_ISRC: String { get } var kAFInfoDictionary_SubTitle: String { get }

    Objective C

    #define kAFInfoDictionary_Artist "artist" #define kAFInfoDictionary_Album "album" #define kAFInfoDictionary_Tempo "tempo" #define kAFInfoDictionary_KeySignature "key signature" #define kAFInfoDictionary_TimeSignature "time signature" #define kAFInfoDictionary_TrackNumber "track number" #define kAFInfoDictionary_Year "year" #define kAFInfoDictionary_Composer "composer" #define kAFInfoDictionary_Lyricist "lyricist" #define kAFInfoDictionary_Genre "genre" #define kAFInfoDictionary_Title "title" #define kAFInfoDictionary_RecordedDate "recorded date" #define kAFInfoDictionary_Comments "comments" #define kAFInfoDictionary_Copyright "copyright" #define kAFInfoDictionary_SourceEncoder "source encoder" #define kAFInfoDictionary_EncodingApplication "encoding application" #define kAFInfoDictionary_NominalBitRate "nominal bit rate" #define kAFInfoDictionary_ChannelLayout "channel layout" #define kAFInfoDictionary_ApproximateDurationInSeconds "approximate duration in seconds" #define kAFInfoDictionary_SourceBitDepth "source bit depth" #define kAFInfoDictionary_ISRC "ISRC" #define kAFInfoDictionary_SubTitle "subtitle"

    Константы

    • kAFInfoDictionary_Artist

      Художник.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_Album

      Альбом.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_Tempo

      В прежнем темпе.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_KeySignature

      Ключ.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_TimeSignature

      Музыкальный размер.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_TrackNumber

      Номер дорожки.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_Year

      Год.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_Composer

      Композитор.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_Lyricist

      Лирик.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_Genre

      Жанр.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_Title

      Заголовок.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_RecordedDate

      Зарегистрированная дата.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_Comments

      Комментарии.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_Copyright

      Авторское право.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_SourceEncoder

      Исходный кодер.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_EncodingApplication

      Приложение кодирования.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_NominalBitRate

      Номинальная скорость передачи.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_ChannelLayout

      Расположение канала.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_ApproximateDurationInSeconds

      Приблизительная продолжительность в секундах.

      Доступный в iOS 2.0 и позже.

    • kAFInfoDictionary_SourceBitDepth

      Битовая глубина исходного аудиопотока. Посмотрите kAudioFilePropertySourceBitDepth.

      Доступный в iOS 4.3 и позже.

    • kAFInfoDictionary_ISRC

      Код записи по международному стандарту.

      Доступный в iOS 4.3 и позже.

    • kAFInfoDictionary_SubTitle

      Подзаголовок.

      Доступный в iOS 4.3 и позже.

  • Свойства, используемые функциями, описанными в получении и установке частей данных в аудиофайлах. Посмотрите Работу с Глобальной информацией для подробных данных.

    Объявление

    Swift

    var kAudioFilePropertyFileFormat: Int { get } var kAudioFilePropertyDataFormat: Int { get } var kAudioFilePropertyFormatList: Int { get } var kAudioFilePropertyIsOptimized: Int { get } var kAudioFilePropertyMagicCookieData: Int { get } var kAudioFilePropertyAudioDataByteCount: Int { get } var kAudioFilePropertyAudioDataPacketCount: Int { get } var kAudioFilePropertyMaximumPacketSize: Int { get } var kAudioFilePropertyDataOffset: Int { get } var kAudioFilePropertyChannelLayout: Int { get } var kAudioFilePropertyDeferSizeUpdates: Int { get } var kAudioFilePropertyDataFormatName: Int { get } var kAudioFilePropertyMarkerList: Int { get } var kAudioFilePropertyRegionList: Int { get } var kAudioFilePropertyPacketToFrame: Int { get } var kAudioFilePropertyFrameToPacket: Int { get } var kAudioFilePropertyPacketToByte: Int { get } var kAudioFilePropertyByteToPacket: Int { get } var kAudioFilePropertyChunkIDs: Int { get } var kAudioFilePropertyInfoDictionary: Int { get } var kAudioFilePropertyPacketTableInfo: Int { get } var kAudioFilePropertyPacketSizeUpperBound: Int { get } var kAudioFilePropertyReserveDuration: Int { get } var kAudioFilePropertyEstimatedDuration: Int { get } var kAudioFilePropertyBitRate: Int { get } var kAudioFilePropertyID3Tag: Int { get } var kAudioFilePropertySourceBitDepth: Int { get } var kAudioFilePropertyAlbumArtwork: Int { get }

    Objective C

    enum { kAudioFilePropertyFileFormat = 'ffmt', kAudioFilePropertyDataFormat = 'dfmt', kAudioFilePropertyIsOptimized = 'optm', kAudioFilePropertyMagicCookieData = 'mgic', kAudioFilePropertyAudioDataByteCount = 'bcnt', kAudioFilePropertyAudioDataPacketCount = 'pcnt', kAudioFilePropertyMaximumPacketSize = 'psze', kAudioFilePropertyDataOffset = 'doff', kAudioFilePropertyChannelLayout = 'cmap', kAudioFilePropertyDeferSizeUpdates = 'dszu', kAudioFilePropertyDataFormatName = 'fnme', kAudioFilePropertyMarkerList = 'mkls', kAudioFilePropertyRegionList = 'rgls', kAudioFilePropertyPacketToFrame = 'pkfr', kAudioFilePropertyFrameToPacket = 'frpk', kAudioFilePropertyPacketToByte = 'pkby', kAudioFilePropertyByteToPacket = 'bypk', kAudioFilePropertyChunkIDs = 'chid', kAudioFilePropertyInfoDictionary = 'info', kAudioFilePropertyPacketTableInfo = 'pnfo', kAudioFilePropertyFormatList = 'flst', kAudioFilePropertyPacketSizeUpperBound = 'pkub', kAudioFilePropertyReserveDuration = 'rsrv', kAudioFilePropertyEstimatedDuration = 'edur', kAudioFilePropertyBitRate = 'brat', kAudioFilePropertyID3Tag = 'id3t', kAudioFilePropertySourceBitDepth = 'sbtd', kAudioFilePropertyAlbumArtwork = 'aart' };

    Константы

    • kAudioFilePropertyFileFormat

      Формат файла аудиоданных.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyDataFormat

      Аудиопоток основное описание, содержащее формат аудиоданных.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyFormatList

      Для поддержки форматов, таких как AAC SBR, в котором закодированный поток данных может декодироваться к многократным целевым форматам значение этого свойства является массивом значений элемента списка формата аудио (объявленный в AudioFormat.h) из тех форматов. Как правило, это - элемент списка формата аудио с тем же аудиопотоком основное описание в kAudioFilePropertyDataFormat свойство.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyIsOptimized

      Указывает, был ли определяемый аудиофайл оптимизирован, т.е. готовый начать писать звуковые данные к нему. Значение 0 указывает, что должен быть оптимизирован файл. Значение 1 указывает, что в настоящее время оптимизируется файл.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyMagicCookieData

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

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyAudioDataByteCount

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

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyAudioDataPacketCount

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

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyMaximumPacketSize

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

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyDataOffset

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

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyChannelLayout

      Структура расположения звукового канала.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyDeferSizeUpdates

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

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyDataFormatName

      Эта константа осуждается в OS X v 10.5 и позже. Не использовать. Вместо этого используйте kAudioFormatProperty_FormatName (объявленный в AudioFormat.h заголовочный файл).

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyMarkerList

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

      При доступе к этому свойству приложение ответственно за выпуск CFStringRef объекты.

      Используйте NumBytesToNumAudioFileMarkers и NumAudioFileMarkersToNumBytes функции для преобразования между маркерами аудиофайла и эквивалентным числом байтов.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyRegionList

      Список значений области аудиофайла определяется в файле.

      При доступе к этому свойству приложение ответственно за выпуск CFStringRef объекты.

      Используйте NextAudioFileRegion функционируйте для обхода через список области.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyPacketToFrame

      Передает аудио пакетную структуру перевода кадра с mPacket заполненное поле и возвраты mFrame поле. mFrameOffsetInPacket поле проигнорировано.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyFrameToPacket

      Передает аудио пакетную структуру перевода кадра с mFrame заполненное поле и возвраты mPacket и mFrameOffsetInPacket поля.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyPacketToByte

      Передает аудио пакетную структуру перевода байта с mPacket заполненное поле и возвраты mByte поле. mByteOffsetInPacket поле проигнорировано. Если значение в mByte поле является оценкой тогда kBytePacketTranslationFlag_IsEstimate флаг установлен в mFlags поле.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyByteToPacket

      Передает аудио пакетную структуру перевода байта с mByte заполненное поле и возвраты mPacket и mByteOffsetInPacket поля. Если значение в mByte поле является оценкой тогда kBytePacketTranslationFlag_IsEstimate флаг установлен в mFlags поле.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyChunkIDs

      Массив четырех кодов символов для каждого вида блока в файле.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyInfoDictionary

      Словарь CF с информацией о данных в файле.

      При доступе к этому свойству приложение ответственно за выпуск CFDictionaryRef объект.

      В OS X, компонент аудиофайла (типа AudioFileComponent свободно добавить ключи к словарям, которые они возвращают для этого свойства.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyPacketTableInfo

      Получает или устанавливает пакетную табличную информационную структуру аудиофайла для ее типов вспомогательного файла. При установке структуры, суммы значений mNumberValidFrames, mPrimingFrames и mRemainderFrames поля должны совпасть с общим количеством кадров во всех пакетах. В противном случае a paramErr возвращается. Для обеспечения этого результата получите значение свойства и удостоверьтесь сумма трех значений, которые Вы устанавливаете, имеет ту же сумму как три значения, которые Вы получили.

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyPacketSizeUpperBound

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

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyReserveDuration

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

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyEstimatedDuration

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

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyBitRate

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

      Доступный в iOS 2.0 и позже.

    • kAudioFilePropertyID3Tag

      A void* значение, указывающее на память, установленную Вашим приложением для содержания полностью отформатированный тег ID3.

      При установке это свойство должно быть установлено прежде, чем вызвать AudioFileWritePackets функция. Это свойство доступно и устанавливаемо при использовании версии 2 ID3. Это доступно только для версии 1 версии ID3. Самим тегом ID3 звукового файла не управляют при получении или установке этого свойства.

      Доступный в iOS 2.1 и позже.

    • kAudioFilePropertySourceBitDepth

      Для сжатых данных значение этого свойства является битовой глубиной источника, несжатый аудиопоток как SInt32 значение, если известный. Если несжатый источник был в формате с плавающей точкой, битовая глубина выражена как отрицательное число. Например, значение свойства -32 используется для float и значение свойства -64 представляет double.

      Доступный в iOS 4.3 и позже.

    • kAudioFilePropertyAlbumArtwork

      A CFDataRef объект, содержащий файл образа, связался с аудиофайлом.

      Данные изображения отформатированы или как JFIF (JPEG) или как PNG (PNG). При доступе к этому свойству приложение ответственно за выпуск CFDataRef объект.

      Доступный в iOS 5.0 и позже.

  • Получите доступ к этим свойствам с помощью функций, описанных в Работе с Глобальной информацией.

    Объявление

    Swift

    var kAudioFileGlobalInfo_ReadableTypes: Int { get } var kAudioFileGlobalInfo_WritableTypes: Int { get } var kAudioFileGlobalInfo_FileTypeName: Int { get } var kAudioFileGlobalInfo_AvailableFormatIDs: Int { get } var kAudioFileGlobalInfo_AvailableStreamDescriptionsForFormat: Int { get } var kAudioFileGlobalInfo_AllExtensions: Int { get } var kAudioFileGlobalInfo_AllHFSTypeCodes: Int { get } var kAudioFileGlobalInfo_AllUTIs: Int { get } var kAudioFileGlobalInfo_AllMIMETypes: Int { get } var kAudioFileGlobalInfo_ExtensionsForType: Int { get } var kAudioFileGlobalInfo_HFSTypeCodesForType: Int { get } var kAudioFileGlobalInfo_UTIsForType: Int { get } var kAudioFileGlobalInfo_MIMETypesForType: Int { get } var kAudioFileGlobalInfo_TypesForExtension: Int { get } var kAudioFileGlobalInfo_TypesForHFSTypeCode: Int { get } var kAudioFileGlobalInfo_TypesForUTI: Int { get } var kAudioFileGlobalInfo_TypesForMIMEType: Int { get }

    Objective C

    enum { kAudioFileGlobalInfo_ReadableTypes = 'afrf', kAudioFileGlobalInfo_WritableTypes = 'afwf', kAudioFileGlobalInfo_FileTypeName = 'ftnm', kAudioFileGlobalInfo_AvailableStreamDescriptionsForFormat = 'sdid', kAudioFileGlobalInfo_AvailableFormatIDs = 'fmid', kAudioFileGlobalInfo_AllExtensions = 'alxt', kAudioFileGlobalInfo_AllHFSTypeCodes = 'ahfs', kAudioFileGlobalInfo_AllUTIs = 'auti', kAudioFileGlobalInfo_AllMIMETypes = 'amim', kAudioFileGlobalInfo_ExtensionsForType = 'fext', kAudioFileGlobalInfo_HFSTypeCodesForType = 'fhfs', kAudioFileGlobalInfo_UTIsForType = 'futi', kAudioFileGlobalInfo_MIMETypesForType = 'fmim', kAudioFileGlobalInfo_TypesForMIMEType = 'tmim', kAudioFileGlobalInfo_TypesForUTI = 'tuti', kAudioFileGlobalInfo_TypesForHFSTypeCode = 'thfs', kAudioFileGlobalInfo_TypesForExtension = 'text' };

    Константы

    • kAudioFileGlobalInfo_ReadableTypes

      Массив UInt32 значения, содержащие типы файлов (такие как AIFF, WAVE, и т.д), который может быть открыт для чтения.

      При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_WritableTypes

      Массив UInt32 значения, содержащие типы файлов (такие как AIFF, WAVE, и т.д), который может быть открыт для записи.

      При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_FileTypeName

      A CFStringRef объект, содержащий имя для типа файла.

      При доступе к этому свойству приложение ответственно за выпуск CFStringRef объект.

      При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла, содержащему тип файла.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_AvailableFormatIDs

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

      При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла, содержащему тип файла.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_AvailableStreamDescriptionsForFormat

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

      Аудиопотоку основные структуры описания заполнили следующие поля: mFormatID, mFormatFlags, и mBitsPerChannel для записи новых файлов. При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла и структуре идентификатора формата.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_AllExtensions

      A CFArray из CFStrings содержа все распознанные расширения файла. Можно использовать этот массив при создании NSOpenPanel (объявленный в AppKit NSOpenPanel.h заголовочный файл).

      При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.

      При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_AllHFSTypeCodes

      Массив кодов типа HFS, содержащих все, распознал коды типа HFS. Для получения дополнительной информации о кодах типа HFS посмотрите Аудио Панель инструментов ExtendedAudioFile.h заголовочный файл.

      При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_AllUTIs

      A CFArray из CFString из всего UTIs (Универсальные Идентификаторы типов) распознанный Audio File Services.

      При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.

      При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_AllMIMETypes

      A CFArray из строк CF всего MIME типы распознаны Audio File Services.

      При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.

      При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_ExtensionsForType

      A CFArray из строк CF, содержащих распознанные расширения файла для указанного типа.

      При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.

      При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла, содержащему тип файла.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_HFSTypeCodesForType

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

      При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_UTIsForType

      A CFArray из CFString из всех Универсальных Идентификаторов типов, распознанных указанным типом файла.

      При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.

      При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_MIMETypesForType

      A CFArray из CFString из всех типов MIME, распознанных указанным типом файла.

      При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.

      При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_TypesForExtension

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

      При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к a CFStringRef содержа расширение файла.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_TypesForHFSTypeCode

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

      При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к HFSTypeCode.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_TypesForUTI

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

      При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к a CFStringRef содержа Универсальный Идентификатор типа.

      Доступный в iOS 2.0 и позже.

    • kAudioFileGlobalInfo_TypesForMIMEType

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

      При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к a CFStringRef содержа Тип MIME.

      Доступный в iOS 2.0 и позже.

    Обсуждение

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

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

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

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

    Значение

    0

    Описание

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

    Доступный в iOS 4.0 и позже.

  • Неустановленная ошибка произошла.

    Значение

    'wht?'

    Описание

    Неустановленная ошибка произошла.

    Доступный в iOS 2.0 и позже.

  • Тип файла не поддерживается.

    Значение

    ‘typ?'

    Описание

    Тип файла не поддерживается.

    Доступный в iOS 2.0 и позже.

  • Формат данных не поддерживается этим типом файла.

    Значение

    ''fmt?'

    Описание

    Формат данных не поддерживается этим типом файла.

    Доступный в iOS 2.0 и позже.

  • Свойство не поддерживается.

    Значение

    'имущество?'

    Описание

    Свойство не поддерживается.

    Доступный в iOS 2.0 и позже.

  • Размер данных свойства не был корректен.

    Значение

    '! siz'

    Описание

    Размер данных свойства не был корректен.

    Доступный в iOS 2.0 и позже.

  • Работа нарушила полномочия файла. Например, была предпринята попытка для записи в файл, открытый с kAudioFileReadPermission постоянный.

    Значение

    'prm?'

    Описание

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

    Доступный в iOS 2.0 и позже.

  • Блоки после блока аудиоданных предотвращают расширение блока аудиоданных. Для записи большего количества данных необходимо оптимизировать файл.

    Значение

    'optm'

    Описание

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

    Доступный в iOS 2.0 и позже.

  • Или блок не существует в файле, или это не поддерживается файлом.

    Значение

    'chk?'

    Описание

    Или блок не существует в файле, или это не поддерживается файлом.

    Доступный в iOS 2.0 и позже.

  • Файловое смещение было слишком большим для типа файла. AIFF и типы формата файла WAVE имеют 32-разрядные пределы размера файла.

    Значение

    'прочь?'

    Описание

    Файловое смещение было слишком большим для типа файла. AIFF и типы формата файла WAVE имеют 32-разрядные пределы размера файла.

    Доступный в iOS 2.0 и позже.

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

    Значение

    'pck?'

    Описание

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

    Доступный в iOS 2.0 и позже.

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

    Значение

    ‘dta?'

    Описание

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

    Доступный в iOS 2.0 и позже.

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

    Значение

    0x6F703F3F

    Описание

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

    Доступный в iOS 2.0 и позже.

  • Файл закрывается.

    Значение

    - 38

    Описание

    Файл закрывается.

    Доступный в iOS 4.2 и позже.

  • Конец файла.

    Значение

    - 39

    Описание

    Конец файла.

    Доступный в iOS 4.0 и позже.

  • Недопустимая позиция файла.

    Значение

    - 40

    Описание

    Недопустимая позиция файла.

    Доступный в iOS 4.0 и позже.

  • Файл, не найденный.

    Значение

    - 43

    Описание

    Файл, не найденный.

    Доступный в iOS 4.0 и позже.