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

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

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

Создайте, инициализируйте, откройте и закройте аудиофайлы
Считайте и запишите аудиофайлы
Оптимизируйте аудиофайлы
Работа с пользовательскими данными и глобальной информацией

Функции

Создание и инициализация аудиофайлов


    
    AudioFileCreateWithURL (_: _: _: _: _:)
    AudioFileCreateWithURL

Создает новый аудиофайл или инициализирует существующий файл, указанный 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

Доступность

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


    
    AudioFileInitializeWithCallbacks (_: _: _: _: _: _: _: _: _:)
    AudioFileInitializeWithCallbacks

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

Объявление

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

Доступность

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

См. также

AudioFileOpenWithCallbacks

Открытие и закрытие аудиофайлов


    
    AudioFileOpenURL (_: _: _: _:)
    AudioFileOpenURL

Откройте существующий аудиофайл, указанный 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

Доступность

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

См. также

AudioFileOpenWithCallbacks
AudioFileClose


    
    AudioFileOpenWithCallbacks (_: _: _: _: _: _: _:)
    AudioFileOpenWithCallbacks

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

Объявление

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

Доступность

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

См. также

AudioFileClose
AudioFileInitializeWithCallbacks
AudioFileOpenURL

AudioFileClose (_:) AudioFileClose

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

Объявление

Swift

func AudioFileClose(_ inAudioFile: AudioFileID) -> OSStatus

Objective C

OSStatus AudioFileClose ( AudioFileID inAudioFile );

Параметры

inAudioFile

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

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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

См. также

AudioFileOpenURL
AudioFileOpenWithCallbacks

Чтение и запись аудиофайлов


    
    AudioFileReadBytes (_: _: _: _: _:)
    AudioFileReadBytes

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

Объявление

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

Доступность

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

См. также

AudioFileWriteBytes


    
    AudioFileWriteBytes (_: _: _: _: _:)
    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

Доступность

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

См. также

AudioFileReadBytes


    
    AudioFileReadPacketData (_: _: _: _: _: _: _:)
    AudioFileReadPacketData

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

Объявление

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

Доступность

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

См. также

AudioFileWritePackets


    
    AudioFileReadPackets (_: _: _: _: _: _: _:)
    AudioFileReadPackets

(OS X v10.10)

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

Объявление

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

Доступность

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

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

См. также

AudioFileWritePackets


    
    AudioFileWritePackets (_: _: _: _: _: _: _:)
    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

Доступность

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

См. также

AudioFileReadPackets

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


    
    AudioFileGetProperty (_: _: _: _:)
    AudioFileGetProperty

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

Объявление

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

Доступность

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

См. также

AudioFileGetPropertyInfo
AudioFileSetProperty


    
    AudioFileGetPropertyInfo (_: _: _: _:)
    AudioFileGetPropertyInfo

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

Объявление

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

Доступность

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

См. также

AudioFileGetProperty


    
    AudioFileSetProperty (_: _: _: _:)
    AudioFileSetProperty

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

Объявление

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

Доступность

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

См. также

AudioFileGetProperty
AudioFileGetPropertyInfo

Работа с пользовательскими данными


    
    AudioFileCountUserData (_: _: _:)
    AudioFileCountUserData

Получает число пользовательских элементов данных с указанным 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

Доступность

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


    
    AudioFileGetUserDataSize (_: _: _: _:)
    AudioFileGetUserDataSize

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

Объявление

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`	На выводе, указатель размер пользовательского элемента данных.

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

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

Обсуждение

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


    
    AudioFileRemoveUserData (_: _: _:)
    AudioFileRemoveUserData

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

Объявление

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

Доступность

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


    
    AudioFileSetUserData (_: _: _: _: _:)
    AudioFileSetUserData

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

Объявление

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

Доступность

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

См. также

AudioFileGetUserData


    
    AudioFileGetUserData (_: _: _: _: _:)
    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

Доступность

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

См. также

AudioFileSetUserData

Работа с глобальной информацией


    
    AudioFileGetGlobalInfoSize (_: _: _: _:)
    AudioFileGetGlobalInfoSize

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

Объявление

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

Доступность

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


    
    AudioFileGetGlobalInfo (_: _: _: _: _:)
    AudioFileGetGlobalInfo

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

Объявление

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, и другие являются Базовыми объектами Основы.

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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

Оптимизация аудиофайлов

AudioFileOptimize (_:) AudioFileOptimize

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

Объявление

Swift

func AudioFileOptimize(_ inAudioFile: AudioFileID) -> OSStatus

Objective C

OSStatus AudioFileOptimize ( AudioFileID inAudioFile );

Параметры

inAudioFile

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

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

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

Обсуждение

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

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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

Макросы аудиофайла


    
    NumBytesToNumAudioFileMarkers
    NumBytesToNumAudioFileMarkers

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

Объявление

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;

Доступность

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

См. также

AudioFileGetProperty


    
    NumAudioFileMarkersToNumBytes
    NumAudioFileMarkersToNumBytes

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

Объявление

Objective C

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

Параметры


      inNumMarkers

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

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

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

Обсуждение

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

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

Objective C

@import AudioToolbox;

Доступность

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

См. также

AudioFileSetProperty

NextAudioFileRegion NextAudioFileRegion

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

Объявление

Objective C

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

Параметры

inAFRegionPtr

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

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

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

Обсуждение

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

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

Objective C

@import AudioToolbox;

Доступность

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

См. также

AudioFileSetProperty

устаревшие (deprecated) функции


    
    AudioFileCreate
    AudioFileCreate

(OS X v10.6)

Оператор осуждения

Осуждаемый. Использовать AudioFileCreateWithURL вместо этого.

Объявление

Objective C

OSStatus AudioFileCreate ( const struct FSRef *inParentRef, CFStringRef inFileName, AudioFileTypeID inFileType, const AudioStreamBasicDescription *inFormat, UInt32 inFlags, struct FSRef *outNewFileRef, AudioFileID *outAudioFile );

Параметры

`inParentRef`	Указатель на каталог, где должен быть создан новый файл.
`inFileName`	Имя файла, который будет создаваться.
`inFileType`	Тип аудиофайла для создания. Посмотрите `“Built-In Audio File Types”` для констант, которые могут использоваться.
`inFormat`	Указатель на структуру, описывающую формат данных.
`inFlags`	Соответствующие флаги для создания или открытия файла. В настоящее время набор к `0`.
`outNewFileRef`	На выводе, указателе на расположение недавно создаваемого файла.
`outAudioFile`	На выводе, указателе на недавно создаваемый аудиофайл.

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

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

Обсуждение

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

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

Objective C

@import AudioToolbox;

Доступность

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

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

См. также

AudioFileCreateWithURL


    
    AudioFileInitialize
    AudioFileInitialize

(OS X v10.6)

Оператор осуждения

Осуждаемый. Использовать AudioFileInitializeWithCallbacks вместо этого.

Объявление

Objective C

OSStatus AudioFileInitialize ( const struct FSRef *inFileRef, AudioFileTypeID inFileType, const AudioStreamBasicDescription *inFormat, UInt32 inFlags, AudioFileID *outAudioFile );

Параметры

`inFileRef`	Указатель на аудиофайл Вы хотите инициализировать.
`inFileType`	Тип аудиофайла для инициализации файла к.
`inFormat`	Указатель на структуру, описывающую формат данных.
`inFlags`	Флаги для создания или открытия файла. В настоящее время набор к `0`.
`outAudioFile`	На выводе, указателе на недавно создаваемый аудиофайл.

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

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

Обсуждение

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

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

Objective C

@import AudioToolbox;

Доступность

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

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


    
    AudioFileOpen
    AudioFileOpen

(OS X v10.6)

Оператор осуждения

Осуждаемый. Использовать AudioFileOpenURL вместо этого.

Объявление

Objective C

OSStatus AudioFileOpen ( const struct FSRef *inFileRef, SInt8 inPermissions, AudioFileTypeID inFileTypeHint, AudioFileID *outAudioFile );

Параметры

`inFileRef`	Указатель на аудиофайл Вы хотите открыться.
`inPermissions`	Полномочия чтения-записи Вы хотите присвоиться к файлу. Используйте константы разрешения во Флагах Разрешения Аудиофайла.
`inFileTypeHint`	Подсказка для указания типа файла определяемого файла. Для файлов без расширений файла и с типами не легко или уникально определенный от данных (такими как ADTS, AC3), используют эту подсказку для указания типа файла. Иначе, передача `0`. Только используйте эту подсказку в версиях OS X 10.3.1 или больше. Во всех более ранних версиях, любая попытка открыть эти сбои файлов.
`outAudioFile`	На выводе, указателе на недавно открытый файл.

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

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

Обсуждение

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

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

Objective C

@import AudioToolbox;

Доступность

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

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

См. также

AudioFileOpenURL

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

Чтение и запись данных аудиофайла


    
    AudioFile_ReadProc
    AudioFile_ReadProc

Аудиоданные чтений, когда используется в сочетании с 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

Доступность

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


    
    AudioFile_WriteProc
    AudioFile_WriteProc

Обратный вызов для записи данных файла, когда используется в сочетании с 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

Доступность

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

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


    
    AudioFile_GetSizeProc
    AudioFile_GetSizeProc

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

Объявление

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

Доступность

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


    
    AudioFile_SetSizeProc
    AudioFile_SetSizeProc

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

Объявление

Swift

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

Objective C

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

Параметры


      inClientData

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

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

Обсуждение

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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

Типы данных

AudioFileID AudioFileID

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

Объявление

Swift

typealias AudioFileID = COpaquePointer

Objective C

typedef struct OpaqueAudioFileID *AudioFileID;

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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

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

Объявление

Swift

typealias AudioFilePropertyID = UInt32

Objective C

typedef UInt32 AudioFilePropertyID;

Обсуждение

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

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

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

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


      
      AudioFile_SMPTE_Time

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

Объявление

Swift

struct AudioFile_SMPTE_Time { var mHours: Int8 var mMinutes: UInt8 var mSeconds: UInt8 var mFrames: UInt8 var 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`	Демонстрационное смещение в кадре.

Доступность

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


      
      AudioFileMarker

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

Объявление

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 }

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` если маркер применяется ко всем каналам.

Доступность

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


      
      AudioFileMarkerList

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

Объявление

Swift

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

Objective C

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

Поля

`mSMPTE_TimeType`	Тип времени SMPTE целого списка маркеров в аудиофайле.
`mNumberMarkers`	Число маркеров в списке.
`mMarkers`	Массив `mNumberMarkers` элементы, каждый из которых является маркером аудиофайла.

Доступность

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


      
      AudioFileRegion

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

Объявление

Swift

struct AudioFileRegion { var mRegionID: UInt32 var mName: Unmanaged<CFString>! var mFlags: UInt32 var mNumberMarkers: UInt32 var 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` элементы, описывающие, где запускаются данные в области. Для получения дополнительной информации посмотрите Типы Маркера Аудиофайла.

Обсуждение

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

Доступность

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


      
      AudioFileRegionList

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

Объявление

Swift

struct AudioFileRegionList { var mSMPTE_TimeType: UInt32 var mNumberRegions: UInt32 var 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 свойство.

Доступность

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


      
      AudioFramePacketTranslation

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

Объявление

Swift

struct AudioFramePacketTranslation { var mFrame: Int64 var mPacket: Int64 var mFrameOffsetInPacket: UInt32 }

Objective C

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

Поля

`mFrame`	Число кадра.
`mPacket`	Пакетное число.
`mFrameOffsetInPacket`	Смещение кадра в пакете.

Доступность

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


      
      AudioBytePacketTranslation

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

Объявление

Swift

struct AudioBytePacketTranslation { var mByte: Int64 var mPacket: Int64 var mByteOffsetInPacket: UInt32 var mFlags: UInt32 }

Objective C

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

Поля

`mByte`	Число байта.
`mPacket`	Пакетное число.
`mByteOffsetInPacket`	Байтовое смещение в пакете.
`mFlags`	Флаг от Пакетных Флагов Перевода Аудиофайла.

Доступность

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


      
      AudioFilePacketTableInfo

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

Объявление

Swift

struct AudioFilePacketTableInfo { var mNumberValidFrames: Int64 var mPrimingFrames: Int32 var 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.

Доступность

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


      
      Идентификатор типа аудиофайла и идентификатор формата

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

Объявление

Swift

struct AudioFileTypeAndFormatID { var mFileType: AudioFileTypeID var mFormatID: UInt32 }

Objective C

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

Поля

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

Обсуждение

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

Доступность

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

Константы

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

Объявление

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
  
  kAudioFileAIFFType
  
  Файл Audio Interchange File Format (AIFF).
  
  Доступный в OS X v10.2 и позже.
- kAudioFileAIFCType
  
  kAudioFileAIFCType
  
  Аудио Формат файла Обмена, Сжатый (AIFF-C) файл.
  
  Доступный в OS X v10.2 и позже.
- kAudioFileWAVEType
  
  kAudioFileWAVEType
  
  Файл Microsoft WAVE.
  
  Доступный в OS X v10.2 и позже.
- kAudioFileSoundDesigner2Type
  
  kAudioFileSoundDesigner2Type
  
  Звукорежиссер II файлов.
  
  Доступный в OS X v10.2 и позже.
- kAudioFileNextType
  
  kAudioFileNextType
  
  NeXT или файл Sun Microsystems.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileMP3Type
  
  kAudioFileMP3Type
  
  Уровень 3 аудио MPEG (.mp3) файл.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileMP2Type
  
  kAudioFileMP2Type
  
  Уровень 2 аудио MPEG (.mp2) файл.
  
  Доступный в OS X v10.5 и позже.
- kAudioFileMP1Type
  
  kAudioFileMP1Type
  
  Уровень 1 аудио MPEG (.mp1) файл.
  
  Доступный в OS X v10.5 и позже.
- kAudioFileAC3Type
  
  kAudioFileAC3Type
  
  Файл AC 3.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileAAC_ADTSType
  
  kAudioFileAAC_ADTSType
  
  Усовершенствованное кодирование звука (AAC) файл Audio Data Transport Stream (ADTS).
  
  Доступный в OS X v10.3 и позже.
- kAudioFileMPEG4Type
  
  kAudioFileMPEG4Type
  
  Файл MPEG 4.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileM4AType
  
  kAudioFileM4AType
  
  Файл M4A.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileCAFType
  
  kAudioFileCAFType
  
  Файл Формата файла Core Audio.
  
  Доступный в OS X v10.3 и позже.
- kAudioFile3GPType
  
  kAudioFile3GPType
  
  3GPP файл, подходящий для видеоконтента на Мобильных телефонах стандарта GSM.
  
  Доступный в OS X v10.5 и позже.
- kAudioFile3GP2Type
  
  kAudioFile3GP2Type
  
  3GPP2 файл, подходящий для видеоконтента по мобильным телефонам CDMA.
  
  Доступный в OS X v10.5 и позже.
- kAudioFileAMRType
  
  kAudioFileAMRType
  
  AMR (Адаптивный Мультиуровень) файл, подходящий для сжатой речи.
  
  Доступный в OS X v10.5 и позже.
Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.3 и позже.
Флаги создания аудиофайла
Флаги для использования с AudioFileCreateWithURL и AudioFileCreate функции.

Объявление

Swift

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

Objective C

enum { kAudioFileFlags_EraseFile = 1 kAudioFileFlags_DontPageAlignAudioData = 2 };

Константы
- kAudioFileFlags_EraseFile
  
  kAudioFileFlags_EraseFile
  
  Если установлено, AudioFileCreateWithURL функция стирает содержание существующего файла. Если не набор, то функция перестала работать, если уже существует файл.
  
  Доступный в OS X v10.5 и позже.
- kAudioFileFlags_DontPageAlignAudioData
  
  kAudioFileFlags_DontPageAlignAudioData
  
  Как правило, аудиоданные в файле являются выровненной страницей. Для создания чтения данных файла максимально быстро можно использовать выровненные страницей данные для использования в своих интересах путей оптимизированного кода в файловой системе. Однако, когда пространство с надбавкой, Вы могли бы хотеть избежать дополнительного дополнения, требуемого достигнуть выравнивания. Для этого установите этот флаг при вызове AudioFileCreate или AudioFileCreateWithURL.
  
  Доступный в OS X v10.5 и позже.
Флаги разрешения аудиофайла
Флаги для использования с 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
  
  kAudioFileReadPermission
  
  Файл только для чтения.
  
  Доступный в OS X v10.6 и позже.
- kAudioFileWritePermission
  
  kAudioFileWritePermission
  
  Файл только для записи.
  
  Доступный в OS X v10.6 и позже.
- kAudioFileReadWritePermission
  
  kAudioFileReadWritePermission
  
  Файл имеет разрешение чтения-записи.
  
  Доступный в OS X v10.6 и позже.
Константы направления цикла аудиофайла
Направление воспроизведения циклично выполненного сегмента аудиофайла.

Объявление

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
  
  kAudioFileLoopDirection_NoLooping
  
  Сегмент не циклично выполняется.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileLoopDirection_Forward
  
  kAudioFileLoopDirection_Forward
  
  Играйте сегмент вперед.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileLoopDirection_Backward
  
  kAudioFileLoopDirection_Backward
  
  Играйте сегмент назад.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileLoopDirection_ForwardAndBackward
  
  kAudioFileLoopDirection_ForwardAndBackward
  
  Играйте сегмент вперед и назад.
  
  Доступный в OS X v10.3 и позже.
Типы маркера аудиофайла
Тип маркера в файле, используемом в mType поле AudioFileMarker структура.

Объявление

Swift

var kAudioFileMarkerType_Generic: Int { get }

Objective C

enum { kAudioFileMarkerType_Generic = 0, };

Константы
- kAudioFileMarkerType_Generic
  
  kAudioFileMarkerType_Generic
  
  Универсальный маркер.
  
  Доступный в OS X v10.3 и позже.
Флаги области аудиофайла
Флаги, указывающие направление воспроизведения для 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
  
  kAudioFileRegionFlag_LoopEnable
  
  Если установлено, область циклично выполняется. Необходимо установить один, или оба из остающихся флагов должны также быть установлены для области быть циклично выполненными.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileRegionFlag_PlayForward
  
  kAudioFileRegionFlag_PlayForward
  
  Если установлено, область играется вперед.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileRegionFlag_PlayBackward
  
  kAudioFileRegionFlag_PlayBackward
  
  Если установлено, область играется назад.
  
  Доступный в OS X v10.3 и позже.
Обсуждение

Можно установить один или больше этих флагов. Например, если оба 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
  
  kBytePacketTranslationFlag_IsEstimate
  
  Если установлено, значение результата является оценкой.
  
  Доступный в OS X v10.6 и позже.
Информационные строковые ключи
Значения ключа свойств, чтобы добраться и установить использование функции 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
  
  kAFInfoDictionary_Artist
  
  Художник.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_Album
  
  kAFInfoDictionary_Album
  
  Альбом.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_Tempo
  
  kAFInfoDictionary_Tempo
  
  В прежнем темпе.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_KeySignature
  
  kAFInfoDictionary_KeySignature
  
  Ключ.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_TimeSignature
  
  kAFInfoDictionary_TimeSignature
  
  Музыкальный размер.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_TrackNumber
  
  kAFInfoDictionary_TrackNumber
  
  Номер дорожки.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_Year
  
  kAFInfoDictionary_Year
  
  Год.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_Composer
  
  kAFInfoDictionary_Composer
  
  Композитор.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_Lyricist
  
  kAFInfoDictionary_Lyricist
  
  Лирик.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_Genre
  
  kAFInfoDictionary_Genre
  
  Жанр.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_Title
  
  kAFInfoDictionary_Title
  
  Заголовок.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_RecordedDate
  
  kAFInfoDictionary_RecordedDate
  
  Зарегистрированная дата.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_Comments
  
  kAFInfoDictionary_Comments
  
  Комментарии.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_Copyright
  
  kAFInfoDictionary_Copyright
  
  Авторское право.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_SourceEncoder
  
  kAFInfoDictionary_SourceEncoder
  
  Исходный кодер.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_EncodingApplication
  
  kAFInfoDictionary_EncodingApplication
  
  Приложение кодирования.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_NominalBitRate
  
  kAFInfoDictionary_NominalBitRate
  
  Номинальная скорость передачи.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_ChannelLayout
  
  kAFInfoDictionary_ChannelLayout
  
  Расположение канала.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_ApproximateDurationInSeconds
  
  kAFInfoDictionary_ApproximateDurationInSeconds
  
  Приблизительная продолжительность в секундах.
  
  Доступный в OS X v10.3 и позже.
- kAFInfoDictionary_SourceBitDepth
  
  kAFInfoDictionary_SourceBitDepth
  
  Битовая глубина исходного аудиопотока. Посмотрите kAudioFilePropertySourceBitDepth.
  
  Доступный в OS X v10.7 и позже.
- kAFInfoDictionary_ISRC
  
  kAFInfoDictionary_ISRC
  
  Код записи по международному стандарту.
  
  Доступный в OS X v10.7 и позже.
- kAFInfoDictionary_SubTitle
  
  kAFInfoDictionary_SubTitle
  
  Подзаголовок.
  
  Доступный в OS X v10.7 и позже.
Свойства аудиофайла
Свойства, используемые функциями, описанными в получении и установке частей данных в аудиофайлах. Посмотрите Работу с Глобальной информацией для подробных данных.

Объявление

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

Константы
- kAudioFilePropertyFileFormat
  
  kAudioFilePropertyFileFormat
  
  Формат файла аудиоданных.
  
  Доступный в OS X v10.2 и позже.
- kAudioFilePropertyDataFormat
  
  kAudioFilePropertyDataFormat
  
  Аудиопоток основное описание, содержащее формат аудиоданных.
  
  Доступный в OS X v10.2 и позже.
- kAudioFilePropertyFormatList
  
  kAudioFilePropertyFormatList
  
  Для поддержки форматов, таких как AAC SBR, в котором закодированный поток данных может декодироваться к многократным целевым форматам значение этого свойства является массивом значений элемента списка формата аудио (объявленный в AudioFormat.h) из тех форматов. Как правило, это - элемент списка формата аудио с тем же аудиопотоком основное описание в kAudioFilePropertyDataFormat свойство.
  
  Доступный в OS X v10.5 и позже.
- kAudioFilePropertyIsOptimized
  
  kAudioFilePropertyIsOptimized
  
  Указывает, был ли определяемый аудиофайл оптимизирован, т.е. готовый начать писать звуковые данные к нему. Значение 0 указывает, что должен быть оптимизирован файл. Значение 1 указывает, что в настоящее время оптимизируется файл.
  
  Доступный в OS X v10.2 и позже.
- kAudioFilePropertyMagicCookieData
  
  kAudioFilePropertyMagicCookieData
  
  Указатель на память устанавливается вызывающей стороной. Некоторые типы файлов требуют, чтобы волшебный cookie был предоставлен, прежде чем пакеты могут быть записаны в аудиофайл. Установите это свойство перед вызовом AudioFileWriteBytes или AudioFileWritePackets если существует волшебный cookie.
  
  Доступный в OS X v10.2 и позже.
- kAudioFilePropertyAudioDataByteCount
  
  kAudioFilePropertyAudioDataByteCount
  
  Указывает число байтов аудиоданных в определяемом файле.
  
  Доступный в OS X v10.2 и позже.
- kAudioFilePropertyAudioDataPacketCount
  
  kAudioFilePropertyAudioDataPacketCount
  
  Указывает число пакетов аудиоданных в определяемом файле.
  
  Доступный в OS X v10.2 и позже.
- kAudioFilePropertyMaximumPacketSize
  
  kAudioFilePropertyMaximumPacketSize
  
  Указывает максимальный размер пакета для данных в определяемом файле.
  
  Доступный в OS X v10.2 и позже.
- kAudioFilePropertyDataOffset
  
  kAudioFilePropertyDataOffset
  
  Указывает байтовое смещение в файле определяемых аудиоданных.
  
  Доступный в OS X v10.3 и позже.
- kAudioFilePropertyChannelLayout
  
  kAudioFilePropertyChannelLayout
  
  Структура расположения звукового канала.
  
  Доступный в OS X v10.3 и позже.
- kAudioFilePropertyDeferSizeUpdates
  
  kAudioFilePropertyDeferSizeUpdates
  
  Значение по умолчанию (0) всегда заголовок обновлений. Если установлено в 1, обновление размеров файлов в заголовке не выполняется каждый раз, когда данные записаны. Вместо этого обновление задерживается, пока файл не был считан, оптимизирован или закрыт. Этот процесс более эффективен, но не как безопасный. Если сбои приложения перед размером были обновлены, файл не мог бы быть читаемым.
  
  Доступный в OS X v10.3 и позже.
- kAudioFilePropertyDataFormatName
  
  kAudioFilePropertyDataFormatName
  
  Эта константа осуждается в OS X v 10.5 и позже. Не использовать. Вместо этого используйте kAudioFormatProperty_FormatName (объявленный в AudioFormat.h заголовочный файл).
  
  Доступный в OS X v10.2 и позже.
- kAudioFilePropertyMarkerList
  
  kAudioFilePropertyMarkerList
  
  Список CFStringRef объекты, представляющие маркеры аудиофайла, определяются в файле.
  
  При доступе к этому свойству приложение ответственно за выпуск CFStringRef объекты.
  
  Используйте NumBytesToNumAudioFileMarkers и NumAudioFileMarkersToNumBytes функции для преобразования между маркерами аудиофайла и эквивалентным числом байтов.
  
  Доступный в OS X v10.3 и позже.
- kAudioFilePropertyRegionList
  
  kAudioFilePropertyRegionList
  
  Список значений области аудиофайла определяется в файле.
  
  При доступе к этому свойству приложение ответственно за выпуск CFStringRef объекты.
  
  Используйте NextAudioFileRegion функционируйте для обхода через список области.
  
  Доступный в OS X v10.3 и позже.
- kAudioFilePropertyPacketToFrame
  
  kAudioFilePropertyPacketToFrame
  
  Передает аудио пакетную структуру перевода кадра с mPacket заполненное поле и возвраты mFrame поле. mFrameOffsetInPacket поле проигнорировано.
  
  Доступный в OS X v10.3 и позже.
- kAudioFilePropertyFrameToPacket
  
  kAudioFilePropertyFrameToPacket
  
  Передает аудио пакетную структуру перевода кадра с mFrame заполненное поле и возвраты mPacket и mFrameOffsetInPacket поля.
  
  Доступный в OS X v10.3 и позже.
- kAudioFilePropertyPacketToByte
  
  kAudioFilePropertyPacketToByte
  
  Передает аудио пакетную структуру перевода байта с mPacket заполненное поле и возвраты mByte поле. mByteOffsetInPacket поле проигнорировано. Если значение в mByte поле является оценкой тогда kBytePacketTranslationFlag_IsEstimate флаг установлен в mFlags поле.
  
  Доступный в OS X v10.6 и позже.
- kAudioFilePropertyByteToPacket
  
  kAudioFilePropertyByteToPacket
  
  Передает аудио пакетную структуру перевода байта с mByte заполненное поле и возвраты mPacket и mByteOffsetInPacket поля. Если значение в mByte поле является оценкой тогда kBytePacketTranslationFlag_IsEstimate флаг установлен в mFlags поле.
  
  Доступный в OS X v10.6 и позже.
- kAudioFilePropertyChunkIDs
  
  kAudioFilePropertyChunkIDs
  
  Массив четырех кодов символов для каждого вида блока в файле.
  
  Доступный в OS X v10.3 и позже.
- kAudioFilePropertyInfoDictionary
  
  kAudioFilePropertyInfoDictionary
  
  Словарь CF с информацией о данных в файле.
  
  При доступе к этому свойству приложение ответственно за выпуск CFDictionaryRef объект.
  
  В OS X, компонент аудиофайла (типа AudioFileComponent свободно добавить ключи к словарям, которые они возвращают для этого свойства.
  
  Доступный в OS X v10.3 и позже.
- kAudioFilePropertyPacketTableInfo
  
  kAudioFilePropertyPacketTableInfo
  
  Получает или устанавливает пакетную табличную информационную структуру аудиофайла для ее типов вспомогательного файла. При установке структуры, суммы значений mNumberValidFrames, mPrimingFrames и mRemainderFrames поля должны совпасть с общим количеством кадров во всех пакетах. В противном случае a paramErr возвращается. Для обеспечения этого результата получите значение свойства и удостоверьтесь сумма трех значений, которые Вы устанавливаете, имеет ту же сумму как три значения, которые Вы получили.
  
  Доступный в OS X v10.3 и позже.
- kAudioFilePropertyPacketSizeUpperBound
  
  kAudioFilePropertyPacketSizeUpperBound
  
  Теоретический максимальный размер пакета в файле. Это значение получено, фактически не сканируя целый файл для нахождения самого большого пакета, как это могло произойти с kAudioFilePropertyMaximumPacketSize.
  
  Доступный в OS X v10.5 и позже.
- kAudioFilePropertyReserveDuration
  
  kAudioFilePropertyReserveDuration
  
  Продолжительность в секундах данных ожидала быть записанной. Установите это свойство, прежде чем любые данные были записаны для резервирования пространства в заголовке файла для пакетной таблицы и другой информации для появления перед аудиоданными. Иначе, пакетная таблица могла бы быть записана в конце файла, препятствуя тому, чтобы файл был streamable.
  
  Доступный в OS X v10.5 и позже.
- kAudioFilePropertyEstimatedDuration
  
  kAudioFilePropertyEstimatedDuration
  
  Предполагаемая продолжительность в секундах. Если эта продолжительность может быть вычислена, не сканируя весь файл, или все пакеты аудиоданных были отсканированы, значение точно отражает продолжительность аудиоданных.
  
  Доступный в OS X v10.5 и позже.
- kAudioFilePropertyBitRate
  
  kAudioFilePropertyBitRate
  
  Фактическая скорость передачи (число битов аудиоданных в файле, разделенном на продолжительность файла) для некоторых типов файлов и номинальной скорости передачи (какая скорость передачи кодер была установлена в) для других.
  
  Доступный в OS X v10.5 и позже.
- kAudioFilePropertyID3Tag
  
  kAudioFilePropertyID3Tag
  
  A void* значение, указывающее на память, установленную Вашим приложением для содержания полностью отформатированный тег ID3.
  
  При установке это свойство должно быть установлено прежде, чем вызвать AudioFileWritePackets функция. Это свойство доступно и устанавливаемо при использовании версии 2 ID3. Это доступно только для версии 1 версии ID3. Самим тегом ID3 звукового файла не управляют при получении или установке этого свойства.
  
  Доступный в OS X v10.6 и позже.
- kAudioFilePropertySourceBitDepth
  
  kAudioFilePropertySourceBitDepth
  
  Для сжатых данных значение этого свойства является битовой глубиной источника, несжатый аудиопоток как SInt32 значение, если известный. Если несжатый источник был в формате с плавающей точкой, битовая глубина выражена как отрицательное число. Например, значение свойства -32 используется для float и значение свойства -64 представляет double.
  
  Доступный в OS X v10.7 и позже.
- kAudioFilePropertyAlbumArtwork
  
  kAudioFilePropertyAlbumArtwork
  
  A CFDataRef объект, содержащий файл образа, связался с аудиофайлом.
  
  Данные изображения отформатированы или как JFIF (JPEG) или как PNG (PNG). При доступе к этому свойству приложение ответственно за выпуск CFDataRef объект.
  
  Доступный в OS X v10.7 и позже.
Глобальные информационные свойства аудиофайла
Получите доступ к этим свойствам с помощью функций, описанных в Работе с Глобальной информацией.

Объявление

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
  
  kAudioFileGlobalInfo_ReadableTypes
  
  Массив UInt32 значения, содержащие типы файлов (такие как AIFF, WAVE, и т.д), который может быть открыт для чтения.
  
  При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileGlobalInfo_WritableTypes
  
  kAudioFileGlobalInfo_WritableTypes
  
  Массив UInt32 значения, содержащие типы файлов (такие как AIFF, WAVE, и т.д), который может быть открыт для записи.
  
  При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileGlobalInfo_FileTypeName
  
  kAudioFileGlobalInfo_FileTypeName
  
  A CFStringRef объект, содержащий имя для типа файла.
  
  При доступе к этому свойству приложение ответственно за выпуск CFStringRef объект.
  
  При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла, содержащему тип файла.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileGlobalInfo_AvailableFormatIDs
  
  kAudioFileGlobalInfo_AvailableFormatIDs
  
  Массив идентификаторов формата для форматов, которые могут быть считаны.
  
  При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла, содержащему тип файла.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileGlobalInfo_AvailableStreamDescriptionsForFormat
  
  kAudioFileGlobalInfo_AvailableStreamDescriptionsForFormat
  
  Массив аудиопотока основные структуры описания, содержащие все форматы для определенного типа файла и идентификатора формата.
  
  Аудиопотоку основные структуры описания заполнили следующие поля: mFormatID, mFormatFlags, и mBitsPerChannel для записи новых файлов. При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла и структуре идентификатора формата.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileGlobalInfo_AllExtensions
  
  kAudioFileGlobalInfo_AllExtensions
  
  A CFArray из CFStrings содержа все распознанные расширения файла. Можно использовать этот массив при создании NSOpenPanel (объявленный в AppKit NSOpenPanel.h заголовочный файл).
  
  При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.
  
  При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileGlobalInfo_AllHFSTypeCodes
  
  kAudioFileGlobalInfo_AllHFSTypeCodes
  
  Массив кодов типа HFS, содержащих все, распознал коды типа HFS. Для получения дополнительной информации о кодах типа HFS посмотрите Аудио Панель инструментов ExtendedAudioFile.h заголовочный файл.
  
  При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileGlobalInfo_AllUTIs
  
  kAudioFileGlobalInfo_AllUTIs
  
  A CFArray из CFString из всего UTIs (Универсальные Идентификаторы типов) распознанный Audio File Services.
  
  При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.
  
  При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.
  
  Доступный в OS X v10.5 и позже.
- kAudioFileGlobalInfo_AllMIMETypes
  
  kAudioFileGlobalInfo_AllMIMETypes
  
  A CFArray из строк CF всего MIME типы распознаны Audio File Services.
  
  При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.
  
  При доступе к значению этого свойства необходимо установить inSpecifier параметр к NULL.
  
  Доступный в OS X v10.5 и позже.
- kAudioFileGlobalInfo_ExtensionsForType
  
  kAudioFileGlobalInfo_ExtensionsForType
  
  A CFArray из строк CF, содержащих распознанные расширения файла для указанного типа.
  
  При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.
  
  При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла, содержащему тип файла.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileGlobalInfo_HFSTypeCodesForType
  
  kAudioFileGlobalInfo_HFSTypeCodesForType
  
  Массив HFS вводит коды, соответствующие указанному типу файла. Первый тип в массиве является предпочтительным для использования.
  
  При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла.
  
  Доступный в OS X v10.3 и позже.
- kAudioFileGlobalInfo_UTIsForType
  
  kAudioFileGlobalInfo_UTIsForType
  
  A CFArray из CFString из всех Универсальных Идентификаторов типов, распознанных указанным типом файла.
  
  При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.
  
  При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла.
  
  Доступный в OS X v10.5 и позже.
- kAudioFileGlobalInfo_MIMETypesForType
  
  kAudioFileGlobalInfo_MIMETypesForType
  
  A CFArray из CFString из всех типов MIME, распознанных указанным типом файла.
  
  При доступе к этому свойству приложение ответственно за выпуск CFArrayRef объект.
  
  При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к идентификатору типа аудиофайла.
  
  Доступный в OS X v10.5 и позже.
- kAudioFileGlobalInfo_TypesForExtension
  
  kAudioFileGlobalInfo_TypesForExtension
  
  Массив всех идентификаторов типов аудиофайла, поддерживающих указанное расширение файла.
  
  При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к a CFStringRef содержа расширение файла.
  
  Доступный в OS X v10.5 и позже.
- kAudioFileGlobalInfo_TypesForHFSTypeCode
  
  kAudioFileGlobalInfo_TypesForHFSTypeCode
  
  Массив всех идентификаторов типов аудиофайла, поддерживающих указанное HFSTypeCode.
  
  При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к HFSTypeCode.
  
  Доступный в OS X v10.5 и позже.
- kAudioFileGlobalInfo_TypesForUTI
  
  kAudioFileGlobalInfo_TypesForUTI
  
  Массив всех идентификаторов типов аудиофайла, поддерживающих указанный UTI.
  
  При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к a CFStringRef содержа Универсальный Идентификатор типа.
  
  Доступный в OS X v10.5 и позже.
- kAudioFileGlobalInfo_TypesForMIMEType
  
  kAudioFileGlobalInfo_TypesForMIMEType
  
  Массив всех идентификаторов типов аудиофайла, поддерживающих указанный тип MIME.
  
  При доступе к этому свойству обеспечьте указатель, в inSpecifier параметр, к a CFStringRef содержа Тип MIME.
  
  Доступный в OS X v10.5 и позже.
Обсуждение

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

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

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

noErr

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

Значение

0

Описание

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

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

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

Значение

'wht?'

Описание

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

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

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

Значение

‘typ?'

Описание

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

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

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

Значение

''fmt?'

Описание

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

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

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

Значение

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

Описание

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

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

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

Значение

'! siz'

Описание

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

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

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

Значение

'prm?'

Описание

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

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

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

Значение

'optm'

Описание

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

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

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

Значение

'chk?'

Описание

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

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

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

Значение

'прочь?'

Описание

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

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

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

Значение

'pck?'

Описание

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

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

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

Значение

‘dta?'

Описание

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

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

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

Значение

0x6F703F3F

Описание

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

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

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

Значение

- 38

Описание

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

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

Конец файла.

Значение

- 39

Описание

Конец файла.

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

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

Значение

- 40

Описание

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

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

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

Значение

- 43

Описание

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

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