Ссылка служб аудиофайла
Наследование
Не применимый
Соответствует
Не применимый
Оператор импорта
Swift
import AudioToolbox
Objective C
@import AudioToolbox;
Этот документ описывает Audio File Services, интерфейс программирования C, позволяющий Вам считать или записать большое разнообразие аудиоданных к или от диска или буфера памяти.
С Audio File Services Вы можете:
Создайте, инициализируйте, откройте и закройте аудиофайлы
Считайте и запишите аудиофайлы
Оптимизируйте аудиофайлы
Работа с пользовательскими данными и глобальной информацией
-
Создает новый аудиофайл или инициализирует существующий файл, указанный URL.
Объявление
Swift
func AudioFileCreateWithURL(_
inFileRef
: CFURL!, _inFileType
: AudioFileTypeID, _inFormat
: UnsafePointer<AudioStreamBasicDescription>, _inFlags
: UInt32, _outAudioFile
: UnsafeMutablePointer<AudioFileID>) -> OSStatusObjective C
OSStatus AudioFileCreateWithURL ( CFURLRef inFileRef, AudioFileTypeID inFileType, const AudioStreamBasicDescription *inFormat, UInt32 inFlags, AudioFileID *outAudioFile );
Параметры
inFileRef
Полностью указанный путь файла, чтобы создать или инициализировать.
inFileType
Тип аудиофайла для создания. Посмотрите
“Built-In Audio File Types”
для констант, которые могут использоваться.inFormat
Указатель на структуру, описывающую формат данных.
inFlags
Соответствующие флаги для создания или открытия файла. Если
kAudioFileFlags_EraseFile
установлен, это стирает существующий файл. Если URL является существующим файлом, если флаг не установлен, функциональные сбои сбоев.outAudioFile
На выводе, указателе на недавно создаваемый или инициализированный файл.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
Эта функция использует a
CFURLRef
введите, а неFSRef
введите используемый осуждаемымAudioFileCreate
функция.Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Удаляет содержание существующего файла и присваивает обратные вызовы объекту аудиофайла.
Объявление
Swift
func AudioFileInitializeWithCallbacks(_
inClientData
: UnsafeMutablePointer<Void>, _inReadFunc
: AudioFile_ReadProc, _inWriteFunc
: AudioFile_WriteProc, _inGetSizeFunc
: AudioFile_GetSizeProc, _inSetSizeFunc
: AudioFile_SetSizeProc, _inFileType
: AudioFileTypeID, _inFormat
: UnsafePointer<AudioStreamBasicDescription>, _inFlags
: UInt32, _outAudioFile
: UnsafeMutablePointer<AudioFileID>) -> OSStatusObjective C
OSStatus AudioFileInitializeWithCallbacks ( void *inClientData, AudioFile_ReadProc inReadFunc, AudioFile_WriteProc inWriteFunc, AudioFile_GetSizeProc inGetSizeFunc, AudioFile_SetSizeProc inSetSizeFunc, AudioFileTypeID inFileType, const AudioStreamBasicDescription *inFormat, UInt32 inFlags, AudioFileID *outAudioFile );
Параметры
inClientData
Указатель на константу передал Вашим обратным вызовам. Постоянный Th должен содержать любую информацию, которую Вы используете для управления состоянием для чтения данных из файла.
inReadFunc
Когда объект аудиофайла хочет считать данные, функция обратного вызова вызвала.
inWriteFunc
Когда объект аудиофайла хочет записать данные, функция обратного вызова вызвала.
inGetSizeFunc
Когда объект аудиофайла хочет знать размер файла, функция обратного вызова вызвала.
inSetSizeFunc
Когда объект аудиофайла хочет установить размер файла, функция обратного вызова вызвала.
inFileType
Тип аудиофайла для инициализации
inFormat
Формат для аудиоданные в файле.
inFlags
Флаги для создания или открытия файла. Набор к
0
.outAudioFile
На выводе, указателе на недавно инициализированный аудиофайл.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Откройте существующий аудиофайл, указанный URL.
Объявление
Swift
func AudioFileOpenURL(_
inFileRef
: CFURL!, _inPermissions
: Int8, _inFileTypeHint
: AudioFileTypeID, _outAudioFile
: UnsafeMutablePointer<AudioFileID>) -> OSStatusObjective C
OSStatus AudioFileOpenURL ( CFURLRef inFileRef, SInt8 inPermissions, AudioFileTypeID inFileTypeHint, AudioFileID *outAudioFile );
Параметры
inFileRef
URL существующего аудиофайла.
inPermissions
Полномочия чтения-записи Вы хотите присвоиться к файлу. Используйте константы разрешения во Флагах Разрешения Аудиофайла.
inFileTypeHint
Подсказка для типа файла определяемого файла. Для файлов без расширений файла и с типами не легко или уникально определенный от данных (такими как ADTS или AC3), используйте эту подсказку для указания типа файла. Иначе, передача
0
. Только используйте эту подсказку в версиях OS X 10.3.1 или больше. Во всех более ранних версиях, любая попытка открыть эти сбои файлов.outAudioFile
На выводе, указателе на недавно открытый аудиофайл.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Открывает существующий файл с обратными вызовами, которые Вы обеспечиваете.
Объявление
Swift
func AudioFileOpenWithCallbacks(_
inClientData
: UnsafeMutablePointer<Void>, _inReadFunc
: AudioFile_ReadProc, _inWriteFunc
: AudioFile_WriteProc, _inGetSizeFunc
: AudioFile_GetSizeProc, _inSetSizeFunc
: AudioFile_SetSizeProc, _inFileTypeHint
: AudioFileTypeID, _outAudioFile
: UnsafeMutablePointer<AudioFileID>) -> OSStatusObjective C
OSStatus AudioFileOpenWithCallbacks ( void *inClientData, AudioFile_ReadProc inReadFunc, AudioFile_WriteProc inWriteFunc, AudioFile_GetSizeProc inGetSizeFunc, AudioFile_SetSizeProc inSetSizeFunc, AudioFileTypeID inFileTypeHint, AudioFileID *outAudioFile );
Параметры
inClientData
Указатель на константу передал Вашим обратным вызовам. Константа должна содержать любую информацию, которую Вы используете для управления состоянием для чтения данных из файла.
inReadFunc
Когда объект аудиофайла хочет считать данные, функция обратного вызова вызвала.
inWriteFunc
Когда объект аудиофайла хочет записать данные, функция обратного вызова вызвала.
inGetSizeFunc
Когда объект аудиофайла хочет знать размер файла, функция обратного вызова вызвала.
inSetSizeFunc
Когда объект аудиофайла хочет установить размер файла, функция обратного вызова вызвала.
inFileTypeHint
Подсказка о типе определяемого файла. Для файлов без расширения файла и без типа легко или уникально определенный от данных (ADTS, AC3), используют эту подсказку для указания типа файла. Иначе, передача
0
для этого параметра. Подсказка только доступна на версиях OS X 10.3.1 или больше. В версиях до OS X 10.3.1, вводные файлы такие сбои файлов.outAudioFile
На выводе, указателе на недавно открытый файл.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Закрывает аудиофайл.
Объявление
Swift
func AudioFileClose(_
inAudioFile
: AudioFileID) -> OSStatusObjective C
OSStatus AudioFileClose ( AudioFileID inAudioFile );
Параметры
inAudioFile
Файл Вы хотите закрыться.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Байты чтений аудиоданных от аудиофайла.
Объявление
Swift
func AudioFileReadBytes(_
inAudioFile
: AudioFileID, _inUseCache
: Boolean, _inStartingByte
: Int64, _ioNumBytes
: UnsafeMutablePointer<UInt32>, _outBuffer
: UnsafeMutablePointer<Void>) -> OSStatusObjective C
OSStatus AudioFileReadBytes ( AudioFileID inAudioFile, Boolean inUseCache, SInt64 inStartingByte, UInt32 *ioNumBytes, void *outBuffer );
Параметры
inAudioFile
Аудиофайл, чьи байты аудиоданных Вы хотите считать.
inUseCache
Набор к
true
если Вы хотите кэшировать данные. Если Вы читаете или пишете ту же часть файла многократно, необходимо кэшировать чтения и записи. Запрашивать, чтобы данные не кэшироваться, если это возможно, установили вfalse
. Если Вы читаете или пишете данные из файла только один раз, Вы не должны кэшировать чтения и записи.inStartingByte
Байтовое смещение аудиоданных Вы хотите быть возвращенными.
ioNumBytes
На вводе, указателе на число байтов для чтения. На выводе фактически читал указатель на число байтов.
outBuffer
Указатель на выделенную пользователями память, достаточно большую для требуемых байтов.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
В большинстве случаев необходимо использовать
AudioFileReadPackets
вместо этой функции.Эта функция возвраты
eofErr
когда операция чтения встречается с концом файла. Обратите внимание на то, что Audio File Services только читает один 32-разрядный блок файла за один раз.Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Байты записей аудиоданных к аудиофайлу.
Объявление
Swift
func AudioFileWriteBytes(_
inAudioFile
: AudioFileID, _inUseCache
: Boolean, _inStartingByte
: Int64, _ioNumBytes
: UnsafeMutablePointer<UInt32>, _inBuffer
: UnsafePointer<Void>) -> OSStatusObjective C
OSStatus AudioFileWriteBytes ( AudioFileID inAudioFile, Boolean inUseCache, SInt64 inStartingByte, UInt32 *ioNumBytes, const void *inBuffer );
Параметры
inAudioFile
Аудиофайл, в который Вы хотите записать байты данных.
inUseCache
Набор к
true
если Вы хотите кэшировать данные. Иначе, набор кfalse
.inStartingByte
Байтовое смещение, где должны быть записаны аудиоданные.
ioNumBytes
На вводе, указатель число байтов для записи. На выводе, указателе на число байтов, фактически записанных.
inBuffer
Указатель на буфер, содержащий байты, которые будут записаны.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
В большинстве случаев необходимо использовать
AudioFileWritePackets
вместо этой функции.Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Пакеты чтений аудиоданных от аудиофайла.
Объявление
Swift
func AudioFileReadPacketData(_
inAudioFile
: AudioFileID, _inUseCache
: Boolean, _ioNumBytes
: UnsafeMutablePointer<UInt32>, _outPacketDescriptions
: UnsafeMutablePointer<AudioStreamPacketDescription>, _inStartingPacket
: Int64, _ioNumPackets
: UnsafeMutablePointer<UInt32>, _outBuffer
: UnsafeMutablePointer<Void>) -> OSStatusObjective C
OSStatus AudioFileReadPacketData ( AudioFileID inAudioFile, Boolean inUseCache, UInt32 *ioNumBytes, AudioStreamPacketDescription *outPacketDescriptions, SInt64 inStartingPacket, UInt32 *ioNumPackets, void *outBuffer );
Параметры
inAudioFile
Аудиофайл, аудио пакеты которого Вы хотите считать.
inUseCache
Набор к
true
кэшировать данные. Иначе, набор кfalse
.ioNumBytes
На вводе, размере
outBuffer
параметр, в байтах. На выводе фактически читало число байтов.Если размер байта для числа пакетов Вы запросите в, Вы будете видеть различие в значениях ввода и вывода
ioNumPackets
параметр меньше, чем размер буфера, который Вы передаете вoutBuffer
параметр. В этом случае выходное значение для этого параметра меньше, чем его входное значение.outPacketDescriptions
На выводе, массиве описаний пакета для считанных пакетов. Массив, который Вы передаете в этом параметре, должен быть достаточно большим для размещения описаний для числа пакетов, которые требуют в
ioNumPackets
параметр.Этот параметр применяется только к данным с переменной скоростью передачи. Если считанный файл содержит данные с постоянной скоростью передачи (CBR), такие как линейный PCM, этот параметр не становится заполненным. Передача
NULL
если форматом данных файла является CBR.inStartingPacket
Пакетный индекс первого пакета Вы хотите читать.
ioNumPackets
На вводе, числе пакетов для чтения. На выводе фактически читало число пакетов.
outBuffer
Память, которую Вы выделяете для содержания пакетов чтения. Определите надлежащий размер путем умножения числа пакетов, которые требуют (в
ioNumPackets
параметр) типичным размером пакета для аудиоданных в файле. Для несжатых форматов аудио пакет равен кадру.Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
Используя эту функцию память, эффективная при чтении аудиоданных с переменной скоростью передачи (VBR), размеры пакета которых могут варьироваться на данное время звука.
Если буфер Вы обеспечиваете в
outBuffer
параметр является слишком маленьким для содержания пакетов, в которых Вы запрашиваетеioNumPackets
, выходные значенияioNumPackets
иioNumBytes
сокращены для отражения пакетов, помещенных в буфер. Вы также видите различие в значениях ввода и вывода дляioNumPackets
когда эта функция достигла конца файла, Вы читаете. В этом случае выходное значение для этого параметра меньше, чем его входное значение.Эта функция более эффективна, чем
AudioFileReadPackets
при чтении форматов сжатого файла, не имеющих пакетных таблиц, таких как MP3 или ADTS. Если Вы не должны читать фиксированную продолжительность аудио, эта функция является хорошим выбором для чтения или CBR (постоянная скорость передачи) или данные VBR. Если действительно необходимо считать фиксированную продолжительность аудио, или CBR или VBR, использоватьAudioFileReadPackets
вместо этого.Audio File Services читает один 32-разрядный блок файла за один раз.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.2 и позже.
См. также
-
Читает фиксированную продолжительность аудиоданных от аудиофайла.
Объявление
Swift
func AudioFileReadPackets(_
inAudioFile
: AudioFileID, _inUseCache
: Boolean, _outNumBytes
: UnsafeMutablePointer<UInt32>, _outPacketDescriptions
: UnsafeMutablePointer<AudioStreamPacketDescription>, _inStartingPacket
: Int64, _ioNumPackets
: UnsafeMutablePointer<UInt32>, _outBuffer
: UnsafeMutablePointer<Void>) -> OSStatusObjective C
OSStatus AudioFileReadPackets ( AudioFileID inAudioFile, Boolean inUseCache, UInt32 *outNumBytes, AudioStreamPacketDescription *outPacketDescriptions, SInt64 inStartingPacket, UInt32 *ioNumPackets, void *outBuffer );
Параметры
inAudioFile
Аудиофайл, аудио пакеты которого Вы хотите считать.
inUseCache
Набор к
true
кэшировать данные. Иначе, набор кfalse
.outNumBytes
На выводе фактически читало число байтов.
outPacketDescriptions
На выводе, массиве описаний пакета для считанных пакетов. Массив, который Вы передаете, должен быть достаточно большим для размещения описаний для числа пакетов, которые требуют в
ioNumPackets
параметр.Этот параметр применяется только к данным с переменной скоростью передачи. Если считанный файл содержит данные с постоянной скоростью передачи (CBR), такие как линейный PCM, этот параметр не становится заполненным. Передача
NULL
если форматом данных файла является CBR.inStartingPacket
Пакетный индекс первого пакета Вы хотите читать.
ioNumPackets
На вводе, числе пакетов для чтения. На выводе фактически читало число пакетов.
Вы будете видеть различие в значениях ввода и вывода, когда эта функция достигла конца файла, Вы читаете. В этом случае выходное значение для этого параметра меньше, чем его входное значение.
outBuffer
Память, которую Вы выделяете для содержания пакетов чтения. Определите надлежащий размер путем умножения числа пакетов, которые требуют (в
ioNumPackets
параметр) максимумом (или верхняя граница для) размер пакета аудиофайла. Для несжатых форматов аудио пакет равен кадру.Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
Если Вы не должны читать фиксированную продолжительность аудиоданных, а скорее хотеть использовать Ваш буфер памяти наиболее эффективно, использовать
AudioFileReadPacketData
вместо этой функции.Когда чтение аудиоданных с переменной скоростью передачи (VBR), использование этой функции требуют, чтобы Вы выделили больше памяти, чем Вы были бы для
AudioFileReadPacketData
функция. См. описания дляoutBuffer
параметр в каждой из этих двух функций.Кроме того, эта функция менее эффективна, чем
AudioFileReadPacketData
при чтении форматов сжатого файла, не имеющих пакетных таблиц, таких как MP3 или ADTS. Используйте эту функцию только, когда необходимо считать фиксированную продолжительность аудиоданных, или когда Вы читаете только несжатое аудио.Audio File Services читает один 32-разрядный блок файла за один раз.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 8.0.
См. также
-
Пакеты записей аудиоданных к файлу аудиоданных.
Объявление
Swift
func AudioFileWritePackets(_
inAudioFile
: AudioFileID, _inUseCache
: Boolean, _inNumBytes
: UInt32, _inPacketDescriptions
: UnsafePointer<AudioStreamPacketDescription>, _inStartingPacket
: Int64, _ioNumPackets
: UnsafeMutablePointer<UInt32>, _inBuffer
: UnsafePointer<Void>) -> OSStatusObjective C
OSStatus AudioFileWritePackets ( AudioFileID inAudioFile, Boolean inUseCache, UInt32 inNumBytes, const AudioStreamPacketDescription *inPacketDescriptions, SInt64 inStartingPacket, UInt32 *ioNumPackets, const void *inBuffer );
Параметры
inAudioFile
Аудиофайл для записи в.
inUseCache
Набор к
true
если Вы хотите кэшировать данные. Иначе, набор кfalse
.inNumBytes
Число байтов записанных аудиоданных.
inPacketDescriptions
Указатель на массив описаний пакета для аудиоданных. Не все форматы требуют описаний пакета. Например, если Вы пишете данные CBR, передачу, если не требуются никакие описания пакета
NULL
.inStartingPacket
Пакетный индекс для размещения первого предоставленного пакета.
ioNumPackets
На вводе, указателе на число пакетов для записи. На выводе, указателе на число пакетов, фактически записанных.
inBuffer
Указатель на выделенную пользователями память, содержащую новые аудиоданные для записи в файл аудиоданных.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
Для всех несжатых форматов эта функция приравнивает пакеты с кадрами.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Получает значение свойства аудиофайла.
Объявление
Swift
func AudioFileGetProperty(_
inAudioFile
: AudioFileID, _inPropertyID
: AudioFilePropertyID, _ioDataSize
: UnsafeMutablePointer<UInt32>, _outPropertyData
: UnsafeMutablePointer<Void>) -> OSStatusObjective C
OSStatus AudioFileGetProperty ( AudioFileID inAudioFile, AudioFilePropertyID inPropertyID, UInt32 *ioDataSize, void *outPropertyData );
Параметры
inAudioFile
Аудиофайл Вы хотите получить значение свойства из.
inPropertyID
Свойство, значение которого Вы хотите. Посмотрите Свойства Аудиофайла для возможных значений.
ioDataSize
На вводе размер буфера передал в
outPropertyData
параметр. На выводе, числе байтов, записанных в буфер. ИспользуйтеAudioFileGetPropertyInfo
функция для получения размера значения свойства.outPropertyData
На выводе, значении свойства, указанного в
inPropertyID
параметр.Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Специальные замечания
Некоторые значения свойств Core Audio являются типами C, и другие являются Базовыми объектами Основы.
Если Вы вызываете эту функцию для получения значения, которое является Базовым объектом Основы, то эта функция — несмотря на использование «Get» на его имя — копирует объект. Вы ответственны за выпуск объекта, как описано в Создать Правиле в Руководстве по программированию управления памятью для Базовой Основы.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Получает информацию о свойстве аудиофайла, включая размер значения свойства и перезаписываемо ли значение.
Объявление
Swift
func AudioFileGetPropertyInfo(_
inAudioFile
: AudioFileID, _inPropertyID
: AudioFilePropertyID, _outDataSize
: UnsafeMutablePointer<UInt32>, _isWritable
: UnsafeMutablePointer<UInt32>) -> OSStatusObjective C
OSStatus AudioFileGetPropertyInfo ( AudioFileID inAudioFile, AudioFilePropertyID inPropertyID, UInt32 *outDataSize, UInt32 *isWritable );
Параметры
inAudioFile
Аудиофайл Вы хотите получить информацию о значении свойства из.
inPropertyID
Свойство, информацию о значении которого Вы хотите. Посмотрите Свойства Аудиофайла для возможных значений.
outDataSize
На выводе, размере в байтах значения свойства.
isWritable
На выводе, равняется
1
если свойство перезаписываемо, или0
если это только для чтения.Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Устанавливает значение свойства аудиофайла
Объявление
Swift
func AudioFileSetProperty(_
inAudioFile
: AudioFileID, _inPropertyID
: AudioFilePropertyID, _inDataSize
: UInt32, _inPropertyData
: UnsafePointer<Void>) -> OSStatusObjective C
OSStatus AudioFileSetProperty ( AudioFileID inAudioFile, AudioFilePropertyID inPropertyID, UInt32 inDataSize, const void *inPropertyData );
Параметры
inAudioFile
Аудиофайл, для которого Вы хотите установить значение свойства.
inPropertyID
Свойство, значение которого Вы хотите установить. Посмотрите Свойства Аудиофайла для возможных значений. Используйте
AudioFileGetPropertyInfo
функция, чтобы определить, перезаписываемо ли значение свойства.inDataSize
Размер значения Вы являетесь передающими в
inPropertyData
параметр.inPropertyData
Новое значение для свойства.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Получает число пользовательских элементов данных с указанным ID в файле.
Объявление
Swift
func AudioFileCountUserData(_
inAudioFile
: AudioFileID, _inUserDataID
: UInt32, _outNumberItems
: UnsafeMutablePointer<UInt32>) -> OSStatusObjective C
OSStatus AudioFileCountUserData ( AudioFileID inAudioFile, UInt32 inUserDataID, UInt32 *outNumberItems );
Параметры
inAudioFile
Аудиофайл, пользовательские элементы данных которого должны считаться.
inUserDataID
Четыре кода символа (такой как
COMM
) из пользовательского элемента данных.outNumberItems
На выводе, указателе на число пользовательских элементов данных этого типа в файле.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
В контексте этой функции пользовательские данные относятся к блокам в AIFF, CAF и файлах WAVE, к ресурсам в Звукорежиссере II файлов, и возможно к другим типам информации в других файлах.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Получает размер пользовательского элемента данных в аудиофайле.
Объявление
Swift
func AudioFileGetUserDataSize(_
inAudioFile
: AudioFileID, _inUserDataID
: UInt32, _inIndex
: UInt32, _outUserDataSize
: UnsafeMutablePointer<UInt32>) -> OSStatusObjective C
OSStatus AudioFileGetUserDataSize ( AudioFileID inAudioFile, UInt32 inUserDataID, UInt32 inIndex, UInt32 *outUserDataSize );
Параметры
inAudioFile
Аудиофайл, пользовательский размер элемента данных которого Вы хотите.
inUserDataID
Четыре кода символа определяемого пользовательского элемента данных.
inIndex
Индекс, указывающий, который пользовательский элемент данных с четырьмя кодами символа, указанными в
inUserDataID
параметр Вы хотите запросить.outUserDataSize
На выводе, указатель размер пользовательского элемента данных.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
В контексте этой функции пользовательские данные относятся к блокам в AIFF, CAF и файлах WAVE, к ресурсам в Звукорежиссере II файлов, и возможно к другим типам информации в других файлах.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Удаляет пользовательский элемент данных из аудиофайла.
Объявление
Swift
func AudioFileRemoveUserData(_
inAudioFile
: AudioFileID, _inUserDataID
: UInt32, _inIndex
: UInt32) -> OSStatusObjective C
OSStatus AudioFileRemoveUserData ( AudioFileID inAudioFile, UInt32 inUserDataID, UInt32 inIndex );
Параметры
inAudioFile
Аудиофайл, содержащий пользовательский элемент данных, который Вы хотите удалить.
inUserDataID
Четыре кода символа такой как
COMM
из пользовательского элемента данных.inIndex
Индекс, указывающий блок для удаления. Если файл содержит больше чем один пользовательский элемент данных с четырьмя кодами символа, указанными в, Вы используете этот параметр
inUserDataID
параметр.Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Устанавливает пользовательский элемент данных в аудиофайле.
Объявление
Swift
func AudioFileSetUserData(_
inAudioFile
: AudioFileID, _inUserDataID
: UInt32, _inIndex
: UInt32, _inUserDataSize
: UInt32, _inUserData
: UnsafePointer<Void>) -> OSStatusObjective C
OSStatus AudioFileSetUserData ( AudioFileID inAudioFile, UInt32 inUserDataID, UInt32 inIndex, UInt32 inUserDataSize, const void *inUserData );
Параметры
inAudioFile
Аудиофайл, в котором Вы хотите установить пользовательский элемент данных.
inUserDataID
Четыре кода символа для пользовательского элемента данных.
inIndex
Индекс, указывающий пользовательский элемент данных, Вы хотите установить. Если файл содержит больше чем один пользовательский элемент данных с четырьмя кодами символа, указанными в, Вы используете этот параметр
inUserDataID
параметр.inUserDataSize
На вводе, размере данных для копирования. На выводе размер байтов скопирован с буфера.
inUserData
Указатель на буфер, с которого можно скопировать пользовательские данные.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Получает блок от аудиофайла.
Объявление
Swift
func AudioFileGetUserData(_
inAudioFile
: AudioFileID, _inUserDataID
: UInt32, _inIndex
: UInt32, _ioUserDataSize
: UnsafeMutablePointer<UInt32>, _outUserData
: UnsafeMutablePointer<Void>) -> OSStatusObjective C
OSStatus AudioFileGetUserData ( AudioFileID inAudioFile, UInt32 inUserDataID, UInt32 inIndex, UInt32 *ioUserDataSize, void *outUserData );
Параметры
inAudioFile
Аудиофайл, блок которого Вы хотите получить.
inUserDataID
Четыре кода символа определяемого блока.
inIndex
Индекс, указывающий, который блок с четырьмя кодами символа, указанными в
inUserDataID
параметр Вы хотите запросить.ioUserDataSize
На вводе, указателе на размер буфера, содержащего определяемый блок. На выводе, указателе на размер байтов, скопированных в буфер.
outUserData
Указатель на буфер, в котором можно скопировать данные блока.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Получает размер глобального свойства аудиофайла.
Объявление
Swift
func AudioFileGetGlobalInfoSize(_
inPropertyID
: AudioFilePropertyID, _inSpecifierSize
: UInt32, _inSpecifier
: UnsafeMutablePointer<Void>, _outDataSize
: UnsafeMutablePointer<UInt32>) -> OSStatusObjective C
OSStatus AudioFileGetGlobalInfoSize ( AudioFilePropertyID inPropertyID, UInt32 inSpecifierSize, void *inSpecifier, UInt32 *outDataSize );
Параметры
inPropertyID
Свойство, размер данных которого Вы хотите получить. Для возможных значений посмотрите Глобальные Информационные Свойства Аудиофайла.
inSpecifier
Указатель на спецификатор (указатель на буфер, содержащий некоторые данные, отличающиеся для каждого свойства. Тип требуемых данных описан в описании каждого свойства.)
outDataSize
Указатель на размер в байтах текущей стоимости свойства. Для получения размера значения свойства Вам нужен буфер этого размера.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
Эта функция может использоваться, чтобы получить информацию о возможностях Типов данных службы Аудиофайла, например, определить, который типы файлов могут взять который форматы данных.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Копирует значение глобального свойства в буфер.
Объявление
Swift
func AudioFileGetGlobalInfo(_
inPropertyID
: AudioFilePropertyID, _inSpecifierSize
: UInt32, _inSpecifier
: UnsafeMutablePointer<Void>, _ioDataSize
: UnsafeMutablePointer<UInt32>, _outPropertyData
: UnsafeMutablePointer<Void>) -> OSStatusObjective C
OSStatus AudioFileGetGlobalInfo ( AudioFilePropertyID inPropertyID, UInt32 inSpecifierSize, void *inSpecifier, UInt32 *ioDataSize, void *outPropertyData );
Параметры
inPropertyID
Свойство, значение которого Вы хотите получить. Для возможных значений посмотрите Глобальные Информационные Свойства Аудиофайла.
inSpecifierSize
Размер данных спецификатора.
inSpecifier
Указатель на спецификатор, который, в этом контексте, является указателем на буфер, содержащий некоторые данные, отличающиеся для каждого свойства. Тип требуемых данных описан в описании каждого свойства.
ioDataSize
На вводе указатель на размер буфера указан в outPropertyData параметре. На выводе, указателе на число байтов, записанных в буфер.
outPropertyData
Указатель на буфер, в котором можно записать данные свойства.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
Эта функция может использоваться, чтобы получить информацию о возможностях типов данных Audio File Services, например, определить, который могут взять типы файлов, какие форматы данных, какие типы файлов поддерживаются, какой тип файла может содержать определенный тип данных и т.д. Эта функция не может использоваться для получения информации о свойствах определенных файлов. Таким образом, свойства, информацию которых Вы получаете, являются глобальной переменной к интерфейсу программирования Audio File Services, не свойствами, определенными для любого файла.
Специальные замечания
Некоторые значения свойств Core Audio являются типами C, и другие являются Базовыми объектами Основы.
Если Вы вызываете эту функцию для получения значения, которое является Базовым объектом Основы, то эта функция — несмотря на использование «Get» на его имя — копирует объект. Вы ответственны за выпуск объекта, как описано в Создать Правиле в Руководстве по программированию управления памятью для Базовой Основы.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Консолидирует аудиоданные и выполняет другую внутреннюю оптимизацию файловой структуры.
Объявление
Swift
func AudioFileOptimize(_
inAudioFile
: AudioFileID) -> OSStatusObjective C
OSStatus AudioFileOptimize ( AudioFileID inAudioFile );
Параметры
inAudioFile
Аудиофайл Вы хотите оптимизировать.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
Эта функция оптимизирует файл, таким образом, дополнительная информация о звуке может быть добавлена к существующим данным. Как правило, эта функция консолидирует аудиоданные файла в конце файла. Это улучшает производительность, такой при записи дополнительных данных в файл.
Не используйте эту потенциально дорогую и длительную работу во время строго ограниченных во времени операций. Вместо этого используйте
kAudioFilePropertyIsOptimized
свойство для проверки состояния оптимизации файла. Можно тогда оптимизировать, когда это не окажет негативное влияние приложение.Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Макрос, возвращающий число маркеров аудиофайла, представленных конкретным количеством байтов.
Объявление
Objective C
#define NumBytesToNumAudioFileMarkers (inNumBytes) ( (inNumBytes) < offsetof (AudioFileMarkerList, mMarkers[0]) ? 0 : ((inNumBytes) - offsetof (AudioFileMarkerList, mMarkers[0])) / sizeof (AudioFileMarker) )
Параметры
inNumBytes
Число байтов, для которых Вы хотите знать эквивалентное число маркеров аудиофайла.
Возвращаемое значение
Число маркеров аудиофайла, которые могут содержаться в конкретном количестве байтов.
Обсуждение
Используйте этот макрос удобства, когда Вы вызовете
AudioFileGetProperty
функция сkAudioFilePropertyMarkerList
свойство для вычисления числа маркеров, которые будут возвращены.Оператор импорта
Objective C
@import AudioToolbox;
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Макрос, возвращающий число байтов, соответствующих конкретному количеству маркеров аудиофайла.
Объявление
Objective C
#define NumAudioFileMarkersToNumBytes(inNumMarkers) ( offsetof (AudioFileMarkerList, mMarkers) + (inNumMarkers) * sizeof(AudioFileMarker) )
Параметры
inNumMarkers
Число маркеров аудиофайла, для которых Вы хотите знать эквивалентное число байтов.
Возвращаемое значение
Число байтов, требуемых содержать конкретное количество маркеров аудиофайла.
Обсуждение
Используйте эту функцию удобства, когда Вы вызовете
AudioFileSetProperty
функция сkAudioFilePropertyMarkerList
свойство для вычисления размера буфера должно было содержать определенное число маркеров аудиофайла.Оператор импорта
Objective C
@import AudioToolbox;
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Находит следующую область аудиофайла в списке области.
Объявление
Objective C
#define NextAudioFileRegion (inAFRegionPtr) ( (AudioFileRegion*) ((char*) (inAFRegionPtr) + offsetof(AudioFileRegion, mMarkers) + ((inAFRegionPtr)->mNumberMarkers) * sizeof (AudioFileMarker)) )
Параметры
inAFRegionPtr
Указатель на область аудиофайла в списке области.
Возвращаемое значение
Указатель на следующую область после области, на которую указывают
inAFRegionPtr
параметр. Это значение может быть вне конца списка, поэтому обратить внимание на общее количество областей в списке.Обсуждение
Поскольку области аудиофайла имеют переменную длину, Вы не можете легко обойти список. Используйте эту функцию удобства, когда Вы вызовете
AudioFileGetProperty
функция сkAudioFilePropertyRegionList
свойство для обхода через список областей возвратилось.Оператор импорта
Objective C
@import AudioToolbox;
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Аудиоданные чтений, когда используется в сочетании с
AudioFileOpenWithCallbacks
илиAudioFileInitializeWithCallbacks
функции.)Объявление
Swift
typealias AudioFile_ReadProc = CFunctionPointer<((UnsafeMutablePointer<Void>, Int64, UInt32, UnsafeMutablePointer<Void>, UnsafeMutablePointer<UInt32>) -> OSStatus)>
Objective C
typedef OSStatus (*AudioFile_ReadProc) ( void *inClientData, SInt64 inPosition, UInt32 requestCount, void *buffer, UInt32 *actualCount );
Параметры
inClientData
Указатель на клиентские данные, как начато
inClientData
параметр кAudioFileOpenWithCallbacks
илиAudioFileInitializeWithCallbacks
.inPosition
Смещение в данные, из которых можно читать.
requestCount
Число байтов для чтения.
buffer
Указатель на буфер, в который можно поместить чтение данных.
actualCount
На выводе обратный вызов должен установить этот параметр на указатель на число байтов успешно чтение.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
Когда Audio File Services должна считать данные, эту функцию обратного вызова вызывают.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Обратный вызов для записи данных файла, когда используется в сочетании с
AudioFileOpenWithCallbacks
илиAudioFileCreateWithURL
функции.Объявление
Swift
typealias AudioFile_WriteProc = CFunctionPointer<((UnsafeMutablePointer<Void>, Int64, UInt32, UnsafePointer<Void>, UnsafeMutablePointer<UInt32>) -> OSStatus)>
Objective C
typedef OSStatus (*AudioFile_WriteProc) ( void *inClientData, SInt64 inPosition, UInt32 requestCount, const void *buffer, UInt32 *actualCount );
Параметры
inClientData
Указатель на клиентские данные, как начато
inClientData
параметр кAudioFileOpenWithCallbacks
илиAudioFileInitializeWithCallbacks
.inPosition
Смещение в данные, из которых можно читать.
requestCount
Число байтов для записи.
buffer
Указатель на буфер, содержащий данные для записи.
actualCount
После завершения обратный вызов должен установить это в указатель на число байтов, успешно записанных.
Возвращаемое значение
Код результата. Посмотрите Коды Результата Аудиофайла.
Обсуждение
Когда Audio File Services должна записать данные, эта функция обратного вызова вызывается.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Получает размер данных файла.
Объявление
Swift
typealias AudioFile_GetSizeProc = CFunctionPointer<((UnsafeMutablePointer<Void>) -> Int64)>
Objective C
typedef SInt64 (*AudioFile_GetSizeProc)( void *inClientData );
Параметры
inClientData
Указатель на клиентские данные, как начато
inClientData
параметр кAudioFileOpenWithCallbacks
илиAudioFileInitializeWithCallbacks
функции.Возвращаемое значение
Обратный вызов должен возвратить размер данных.
Обсуждение
Этот обратный вызов вызывается объектом аудиофайла, когда это должно получить размер данных аудиофайла. Вы передаете этот обратный вызов в качестве параметра при вызове
AudioFileOpenWithCallbacks
иAudioFileInitializeWithCallbacks
функции.Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Размер данных файла наборов.
Объявление
Swift
typealias AudioFile_SetSizeProc = CFunctionPointer<((UnsafeMutablePointer<Void>, Int64) -> OSStatus)>
Objective C
typedef SInt64 (*AudioFile_SetSizeProc)( void *inClientData );
Параметры
inClientData
Указатель на клиентские данные, как начато
inClientData
параметр кAudioFileOpenWithCallbacks
илиAudioFileInitializeWithCallbacks
функции.Возвращаемое значение
Обратный вызов должен возвратить размер данных.
Обсуждение
Этот обратный вызов вызывается объектом аудиофайла, когда он должен установить размер данных аудиофайла. Вы передаете этот обратный вызов в качестве параметра при вызове
AudioFileOpenWithCallbacks
иAudioFileInitializeWithCallbacks
функции.Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Непрозрачный тип данных, представляющий объект аудиофайла.
Объявление
Swift
typealias AudioFileID = COpaquePointer
Objective C
typedef struct OpaqueAudioFileID *AudioFileID;
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Идентификатор свойства аудиофайла.
Объявление
Swift
typealias AudioFilePropertyID = UInt32
Objective C
typedef UInt32 AudioFilePropertyID;
Обсуждение
Для списка свойств аудиофайла посмотрите Свойства Аудиофайла.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
Структура данных для описания SMPTE (Общество Изображения движущихся объектов и Телевизионных Инженеров) время.
Объявление
Swift
struct AudioFile_SMPTE_Time { var mHours: Int8 var mMinutes: UInt8 var mSeconds: UInt8 var mFrames: UInt8 var mSubFrameSampleOffset: UInt32 init() init(mHours
mHours
: Int8, mMinutesmMinutes
: UInt8, mSecondsmSeconds
: UInt8, mFramesmFrames
: UInt8, mSubFrameSampleOffsetmSubFrameSampleOffset
: UInt32) }Objective C
struct AudioFile_SMPTE_Time { SInt8 mHours; UInt8 mMinutes; UInt8 mSeconds; UInt8 mFrames; UInt32 mSubFrameSampleOffset; }; typedef struct AudioFile_SMPTE_Time AudioFile_SMPTE_Time;
Поля
mHours
Часы.
mMinutes
Минуты.
mSeconds
Секунды.
mFrames
Кадры.
mSubFrameSampleOffset
Демонстрационное смещение в кадре.
Доступность
Доступный в iOS 2.0 и позже.
-
Аннотирует позицию в аудиофайле.
Объявление
Swift
struct AudioFileMarker { var mFramePosition: Float64 var mName: Unmanaged<CFString>! var mMarkerID: Int32 var mSMPTETime: AudioFile_SMPTE_Time var mType: UInt32 var mReserved: UInt16 var mChannel: UInt16 init() init(mFramePosition
mFramePosition
: Float64, mNamemName
: Unmanaged<CFString>!, mMarkerIDmMarkerID
: Int32, mSMPTETimemSMPTETime
: AudioFile_SMPTE_Time, mTypemType
: UInt32, mReservedmReserved
: UInt16, mChannelmChannel
: UInt16) }Objective C
struct AudioFileMarker { Float64 mFramePosition; CFStringRef mName; SInt32 mMarkerID; AudioFile_SMPTE_Time mSMPTETime; UInt32 mType; UInt16 mReserved; UInt16 mChannel; }; typedef struct AudioFileMarker AudioFileMarker;
Поля
mFramePosition
Кадр в файле, рассчитывающем от запуска аудиоданных.
mName
Имя маркера.
mMarkerID
Уникальный идентификатор для маркера.
mSMPTETime
Время SMPTE для этого маркера.
mType
Тип маркера.
mReserved
Зарезервированное поле. Набор к
0
.mChannel
Номер канала именуется маркером. Набор к
0
если маркер применяется ко всем каналам.Доступность
Доступный в iOS 2.0 и позже.
-
Список маркеров связался с аудиофайлом, включая их тип времени SMPTE, число маркеров и самих маркеров.
Объявление
Swift
struct AudioFileMarkerList { var mSMPTE_TimeType: UInt32 var mNumberMarkers: UInt32 var mMarkers: (AudioFileMarker) init() init(mSMPTE_TimeType
mSMPTE_TimeType
: UInt32, mNumberMarkersmNumberMarkers
: UInt32, mMarkersmMarkers
: (AudioFileMarker)) }Objective C
struct AudioFileMarkerList { UInt32 mSMPTE_TimeType; UInt32 mNumberMarkers; AudioFileMarker mMarkers[1]; }; typedef struct AudioFileMarkerList AudioFileMarkerList;
Поля
mSMPTE_TimeType
Тип времени SMPTE целого списка маркеров в аудиофайле.
mNumberMarkers
Число маркеров в списке.
mMarkers
Массив
mNumberMarkers
элементы, каждый из которых является маркером аудиофайла.Доступность
Доступный в iOS 2.0 и позже.
-
Область аудиофайла указывает сегмент аудиоданных.
Объявление
Swift
struct AudioFileRegion { var mRegionID: UInt32 var mName: Unmanaged<CFString>! var mFlags: UInt32 var mNumberMarkers: UInt32 var mMarkers: (AudioFileMarker) init() init(mRegionID
mRegionID
: UInt32, mNamemName
: Unmanaged<CFString>!, mFlagsmFlags
: UInt32, mNumberMarkersmNumberMarkers
: UInt32, mMarkersmMarkers
: (AudioFileMarker)) }Objective C
struct AudioFileRegion { UInt32 mRegionID; CFStringRef mName; UInt32 mFlags; UInt32 mNumberMarkers; AudioFileMarker mMarkers[1]; }; typedef struct AudioFileRegion AudioFileRegion;
Поля
mRegionID
Уникальный идентификатор связался с областью аудиофайла.
mName
Имя области.
mFlags
Флаги области Audio File Services. Для получения дополнительной информации посмотрите Флаги Области Аудиофайла.
mNumberMarkers
Число маркеров в массиве, указанном в
mMarkers
параметр.mMarkers
Массив
mNumberMarkers
элементы, описывающие, где запускаются данные в области. Для получения дополнительной информации посмотрите Типы Маркера Аудиофайла.Обсуждение
Как правило, область состоит по крайней мере из двух маркеров, определяющих начало и конец сегмента. Другие маркеры могли бы определить дополнительную метаинформацию, такую как точка синхронизации.
Доступность
Доступный в iOS 2.0 и позже.
-
Список областей аудиофайла в файле.
Объявление
Swift
struct AudioFileRegionList { var mSMPTE_TimeType: UInt32 var mNumberRegions: UInt32 var mRegions: (AudioFileRegion) init() init(mSMPTE_TimeType
mSMPTE_TimeType
: UInt32, mNumberRegionsmNumberRegions
: UInt32, mRegionsmRegions
: (AudioFileRegion)) }Objective C
struct AudioFileRegionList { UInt32 mSMPTE_TimeType; UInt32 mNumberRegions; AudioFileRegion mRegions[1]; }; typedef struct AudioFileRegionList AudioFileRegionList;
Поля
mSMPTE_TimeType
SMPTE синхронизация схемы используется в файле. Посмотрите Core Audio
CAFFile.h
заголовочный файл для значений, используемых здесь. Для получения дополнительной информации см. Обзор Core Audio.mNumberRegions
Число областей в списке, указанном в
mRegions
параметр.mRegions
Переменный массив
mNumberRegions
элементы, содержащие список больше чем одной области аудиофайла. Для получения информации оAudioFileRegion
тип данных, посмотритеAudioFileRegion
.Маркеры аудиофайла являются переменной длиной, таким образом, к этому списку нельзя получить доступ как массив. Для получения дополнительной информации на
AudioFileMarker
тип данных, посмотритеAudioFileMarker
.Используйте
NextAudioFileRegion
макрос удобства для того, чтобы пересечь список области вместо этого. Этот макрос позволяет Вам продвинуться в следующую область в данных та Audio File Services возвраты.Обсуждение
Эта структура используется
kAudioFilePropertyRegionList
свойство.Доступность
Доступный в iOS 2.0 и позже.
-
Структура данных, используемая
kAudioFilePropertyPacketToFrame
иkAudioFilePropertyFrameToPacket
свойства.Объявление
Swift
struct AudioFramePacketTranslation { var mFrame: Int64 var mPacket: Int64 var mFrameOffsetInPacket: UInt32 init() init(mFrame
mFrame
: Int64, mPacketmPacket
: Int64, mFrameOffsetInPacketmFrameOffsetInPacket
: UInt32) }Objective C
struct AudioFramePacketTranslation { SInt64 mFrame; SInt64 mPacket; UInt32 mFrameOffsetInPacket; }; typedef struct AudioFramePacketTranslation AudioFramePacketTranslation;
Поля
mFrame
Число кадра.
mPacket
Пакетное число.
mFrameOffsetInPacket
Смещение кадра в пакете.
Доступность
Доступный в iOS 2.0 и позже.
-
Структура данных, используемая
kAudioFilePropertyByteToPacket
иkAudioFilePropertyPacketToByte
свойства.Объявление
Swift
struct AudioBytePacketTranslation { var mByte: Int64 var mPacket: Int64 var mByteOffsetInPacket: UInt32 var mFlags: UInt32 init() init(mByte
mByte
: Int64, mPacketmPacket
: Int64, mByteOffsetInPacketmByteOffsetInPacket
: UInt32, mFlagsmFlags
: UInt32) }Objective C
struct AudioBytePacketTranslation { SInt64 mByte; SInt64 mPacket; UInt32 mByteOffsetInPacket; UInt32 mFlags; }; typedef struct AudioBytePacketTranslation AudioBytePacketTranslation;
Поля
mByte
Число байта.
mPacket
Пакетное число.
mByteOffsetInPacket
Байтовое смещение в пакете.
mFlags
Флаг от Пакетных Флагов Перевода Аудиофайла.
Доступность
Доступный в iOS 2.0 и позже.
-
Содержит информацию о числе допустимых кадров в файле и где они начинают и заканчиваются.
Объявление
Swift
struct AudioFilePacketTableInfo { var mNumberValidFrames: Int64 var mPrimingFrames: Int32 var mRemainderFrames: Int32 init() init(mNumberValidFrames
mNumberValidFrames
: Int64, mPrimingFramesmPrimingFrames
: Int32, mRemainderFramesmRemainderFrames
: Int32) }Objective C
struct AudioFilePacketTableInfo { SInt64 mNumberValidFrames; SInt32 mPrimingFrames; SInt32 mRemainderFrames; }; typedef struct AudioFilePacketTableInfo AudioFilePacketTableInfo;
Поля
mNumberValidFrames
Число допустимых кадров в файле.
mPrimingFrames
Число недопустимых кадров в начале файла.
mRemainderFrames
Число недопустимых кадров в конце файла.
Обсуждение
Некоторые форматы данных могли бы иметь пакеты с содержанием, которое не абсолютно допустимо, но представляющим воспламенение или кадры остатка, не предназначенные для воспроизведения. Например, файл с 100 пакетами AAC номинально 1024 * 100 = 102 400 кадров данных. Однако первые 2 112 кадров могли бы быть кадрами воспламенения.
Много кадров остатка могли бы быть добавлены для увеличивания к полному пакету 1 024 кадров. Отбросьте кадры остатка и воспламенение.
Общее количество пакетов во времена файла кадры на пакет (или считающий кадры каждого пакета индивидуально для переменной структурирует на формат пакета), минус
mPrimingFrames
, минусmRemainderFrames
, должен равнятьсяmNumberValidFrames
.Доступность
Доступный в iOS 2.0 и позже.
-
Спецификатор для константы
kAudioFileGlobalInfo_AvailableStreamDescriptionsForFormat
.Объявление
Swift
struct AudioFileTypeAndFormatID { var mFileType: AudioFileTypeID var mFormatID: UInt32 init() init(mFileType
mFileType
: AudioFileTypeID, mFormatIDmFormatID
: UInt32) }Objective C
struct AudioFileTypeAndFormatID { AudioFileTypeID mFileType; UInt32 mFormatID; }; typedef struct AudioFileTypeAndFormatID AudioFileTypeAndFormatID;
Поля
mFileType
Четыре кода символа для типа файла (например,
kAudioFileAIFFType
ввести.mFormatID
Четыре кода символа для идентификатора формата такой как
kAudioFormatLinearPCM
,kAudioFormatMPEG4AAC
, и т.д. (См.AudioFormat.h
заголовочный файл для объявлений.)Обсуждение
Эта структура указывает желаемый тип аудиофайла и формат данных ID, таким образом, можно получить список потоковых описаний доступных форматов.
Доступность
Доступный в iOS 2.0 и позже.
-
Константы операционной системы, указывающие тип файла, который будет записан или подсказка о том, какой файл для ожидания из данных обеспечил.
Объявление
Swift
typealias AudioFileTypeID = UInt32
Objective C
enum { kAudioFileAIFFType = 'AIFF', kAudioFileAIFCType = 'AIFC', kAudioFileWAVEType = 'WAVE', kAudioFileSoundDesigner2Type = 'Sd2f', kAudioFileNextType = 'NeXT', kAudioFileMP3Type = 'MPG3', kAudioFileMP2Type = 'MPG2', kAudioFileMP1Type = 'MPG1', kAudioFileAC3Type = 'ac-3', kAudioFileAAC_ADTSType = 'adts', kAudioFileMPEG4Type = 'mp4f', kAudioFileM4AType = 'm4af', kAudioFileCAFType = 'caff', kAudioFile3GPType = '3gpp', kAudioFile3GP2Type = '3gp2', kAudioFileAMRType = 'amrf' }; typedef UInt32 AudioFileTypeID;
Константы
-
kAudioFileAIFFType
Файл Audio Interchange File Format (AIFF).
Доступный в iOS 2.0 и позже.
-
kAudioFileAIFCType
Аудио Формат файла Обмена, Сжатый (AIFF-C) файл.
Доступный в iOS 2.0 и позже.
-
kAudioFileWAVEType
Файл Microsoft WAVE.
Доступный в iOS 2.0 и позже.
-
kAudioFileSoundDesigner2Type
Звукорежиссер II файлов.
Доступный в iOS 2.0 и позже.
-
kAudioFileNextType
NeXT или файл Sun Microsystems.
Доступный в iOS 2.0 и позже.
-
kAudioFileMP3Type
Уровень 3 аудио MPEG (
.mp3
) файл.Доступный в iOS 2.0 и позже.
-
kAudioFileMP2Type
Уровень 2 аудио MPEG (
.mp2
) файл.Доступный в iOS 2.0 и позже.
-
kAudioFileMP1Type
Уровень 1 аудио MPEG (
.mp1
) файл.Доступный в iOS 2.0 и позже.
-
kAudioFileAC3Type
Файл AC 3.
Доступный в iOS 2.0 и позже.
-
kAudioFileAAC_ADTSType
Усовершенствованное кодирование звука (AAC) файл Audio Data Transport Stream (ADTS).
Доступный в iOS 2.0 и позже.
-
kAudioFileMPEG4Type
Файл MPEG 4.
Доступный в iOS 2.0 и позже.
-
kAudioFileM4AType
Файл M4A.
Доступный в iOS 2.0 и позже.
-
kAudioFileCAFType
Файл Формата файла Core Audio.
Доступный в iOS 2.0 и позже.
-
kAudioFile3GPType
3GPP файл, подходящий для видеоконтента на Мобильных телефонах стандарта GSM.
Доступный в iOS 2.0 и позже.
-
kAudioFile3GP2Type
3GPP2 файл, подходящий для видеоконтента по мобильным телефонам CDMA.
Доступный в iOS 2.0 и позже.
-
kAudioFileAMRType
AMR (Адаптивный Мультиуровень) файл, подходящий для сжатой речи.
Доступный в iOS 2.0 и позже.
Оператор импорта
Objective C
@import AudioToolbox;
Swift
import AudioToolbox
Доступность
Доступный в iOS 2.0 и позже.
-
-
Флаги для использования с
AudioFileCreateWithURL
иAudioFileCreate
функции.Объявление
Swift
var kAudioFileFlags_EraseFile: Int { get } var kAudioFileFlags_DontPageAlignAudioData: Int { get }
Objective C
enum { kAudioFileFlags_EraseFile = 1 kAudioFileFlags_DontPageAlignAudioData = 2 };
Константы
-
kAudioFileFlags_EraseFile
Если установлено,
AudioFileCreateWithURL
функция стирает содержание существующего файла. Если не набор, то функция перестала работать, если уже существует файл.Доступный в iOS 2.0 и позже.
-
kAudioFileFlags_DontPageAlignAudioData
Как правило, аудиоданные в файле являются выровненной страницей. Для создания чтения данных файла максимально быстро можно использовать выровненные страницей данные для использования в своих интересах путей оптимизированного кода в файловой системе. Однако, когда пространство с надбавкой, Вы могли бы хотеть избежать дополнительного дополнения, требуемого достигнуть выравнивания. Для этого установите этот флаг при вызове
AudioFileCreate
илиAudioFileCreateWithURL
.Доступный в iOS 2.0 и позже.
-
-
Флаги для использования с
AudioFileOpenURL
иAudioFileOpen
функции.Объявление
Swift
var kAudioFileReadPermission: Int { get } var kAudioFileWritePermission: Int { get } var kAudioFileReadWritePermission: Int { get }
Objective C
enum { kAudioFileReadPermission = 0x01, kAudioFileWritePermission = 0x02, kAudioFileReadWritePermission = 0x03 };
Константы
-
Направление воспроизведения циклично выполненного сегмента аудиофайла.
Объявление
Swift
var kAudioFileLoopDirection_NoLooping: Int { get } var kAudioFileLoopDirection_Forward: Int { get } var kAudioFileLoopDirection_Backward: Int { get } var kAudioFileLoopDirection_ForwardAndBackward: Int { get }
Objective C
enum { kAudioFileLoopDirection_NoLooping = 0, kAudioFileLoopDirection_Forward = 1, kAudioFileLoopDirection_ForwardAndBackward = 2, kAudioFileLoopDirection_Backward = 3 };
Константы
-
kAudioFileLoopDirection_NoLooping
Сегмент не циклично выполняется.
Доступный в iOS 2.0 и позже.
-
kAudioFileLoopDirection_Forward
Играйте сегмент вперед.
Доступный в iOS 2.0 и позже.
-
kAudioFileLoopDirection_Backward
Играйте сегмент назад.
Доступный в iOS 2.0 и позже.
-
kAudioFileLoopDirection_ForwardAndBackward
Играйте сегмент вперед и назад.
Доступный в iOS 2.0 и позже.
-
-
Тип маркера в файле, используемом в
mType
полеAudioFileMarker
структура.Объявление
Swift
var kAudioFileMarkerType_Generic: Int { get }
Objective C
enum { kAudioFileMarkerType_Generic = 0, };
Константы
-
Флаги, указывающие направление воспроизведения для
AudioFileRegion
структура.Объявление
Swift
var kAudioFileRegionFlag_LoopEnable: Int { get } var kAudioFileRegionFlag_PlayForward: Int { get } var kAudioFileRegionFlag_PlayBackward: Int { get }
Objective C
enum { kAudioFileRegionFlag_LoopEnable = 1, kAudioFileRegionFlag_PlayForward = 2, kAudioFileRegionFlag_PlayBackward = 4 };
Константы
-
kAudioFileRegionFlag_LoopEnable
Если установлено, область циклично выполняется. Необходимо установить один, или оба из остающихся флагов должны также быть установлены для области быть циклично выполненными.
Доступный в iOS 2.0 и позже.
-
kAudioFileRegionFlag_PlayForward
Если установлено, область играется вперед.
Доступный в iOS 2.0 и позже.
-
kAudioFileRegionFlag_PlayBackward
Если установлено, область играется назад.
Доступный в iOS 2.0 и позже.
Обсуждение
Можно установить один или больше этих флагов. Например, если оба
kAudioFileRegionFlag_LoopEnable
иkAudioFileRegionFlag_PlayForward
установлены, игры области как прямой цикл. Если толькоkAudioFileRegionFlag_PlayForward
установлен, область играется вперед один раз. если обаkAudioFileRegionFlag_PlayForward
иkAudioFileRegionFlag_PlayBackward
установлены, игры области вперед тогда назад, затем передают. -
-
Флаг, используемый с
mFlags
полеAudioBytePacketTranslation
структура.Объявление
Swift
var kBytePacketTranslationFlag_IsEstimate: Int { get }
Objective C
enum { kBytePacketTranslationFlag_IsEstimate = 1 };
Константы
-
Значения ключа свойств, чтобы добраться и установить использование функции Audio File Services и обеспечить распространенный способ вытащить ту же информацию из нескольких различных видов файлов.
Объявление
Swift
var kAFInfoDictionary_Artist: String { get } var kAFInfoDictionary_Album: String { get } var kAFInfoDictionary_Tempo: String { get } var kAFInfoDictionary_KeySignature: String { get } var kAFInfoDictionary_TimeSignature: String { get } var kAFInfoDictionary_TrackNumber: String { get } var kAFInfoDictionary_Year: String { get } var kAFInfoDictionary_Composer: String { get } var kAFInfoDictionary_Lyricist: String { get } var kAFInfoDictionary_Genre: String { get } var kAFInfoDictionary_Title: String { get } var kAFInfoDictionary_RecordedDate: String { get } var kAFInfoDictionary_Comments: String { get } var kAFInfoDictionary_Copyright: String { get } var kAFInfoDictionary_SourceEncoder: String { get } var kAFInfoDictionary_EncodingApplication: String { get } var kAFInfoDictionary_NominalBitRate: String { get } var kAFInfoDictionary_ChannelLayout: String { get } var kAFInfoDictionary_ApproximateDurationInSeconds: String { get } var kAFInfoDictionary_SourceBitDepth: String { get } var kAFInfoDictionary_ISRC: String { get } var kAFInfoDictionary_SubTitle: String { get }
Objective C
#define kAFInfoDictionary_Artist "artist" #define kAFInfoDictionary_Album "album" #define kAFInfoDictionary_Tempo "tempo" #define kAFInfoDictionary_KeySignature "key signature" #define kAFInfoDictionary_TimeSignature "time signature" #define kAFInfoDictionary_TrackNumber "track number" #define kAFInfoDictionary_Year "year" #define kAFInfoDictionary_Composer "composer" #define kAFInfoDictionary_Lyricist "lyricist" #define kAFInfoDictionary_Genre "genre" #define kAFInfoDictionary_Title "title" #define kAFInfoDictionary_RecordedDate "recorded date" #define kAFInfoDictionary_Comments "comments" #define kAFInfoDictionary_Copyright "copyright" #define kAFInfoDictionary_SourceEncoder "source encoder" #define kAFInfoDictionary_EncodingApplication "encoding application" #define kAFInfoDictionary_NominalBitRate "nominal bit rate" #define kAFInfoDictionary_ChannelLayout "channel layout" #define kAFInfoDictionary_ApproximateDurationInSeconds "approximate duration in seconds" #define kAFInfoDictionary_SourceBitDepth "source bit depth" #define kAFInfoDictionary_ISRC "ISRC" #define kAFInfoDictionary_SubTitle "subtitle"
Константы
-
kAFInfoDictionary_Artist
Художник.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_Album
Альбом.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_Tempo
В прежнем темпе.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_KeySignature
Ключ.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_TimeSignature
Музыкальный размер.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_TrackNumber
Номер дорожки.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_Year
Год.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_Composer
Композитор.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_Lyricist
Лирик.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_Genre
Жанр.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_Title
Заголовок.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_RecordedDate
Зарегистрированная дата.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_Comments
Комментарии.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_Copyright
Авторское право.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_SourceEncoder
Исходный кодер.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_EncodingApplication
Приложение кодирования.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_NominalBitRate
Номинальная скорость передачи.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_ChannelLayout
Расположение канала.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_ApproximateDurationInSeconds
Приблизительная продолжительность в секундах.
Доступный в iOS 2.0 и позже.
-
kAFInfoDictionary_SourceBitDepth
Битовая глубина исходного аудиопотока. Посмотрите
kAudioFilePropertySourceBitDepth
.Доступный в iOS 4.3 и позже.
-
kAFInfoDictionary_ISRC
Код записи по международному стандарту.
Доступный в iOS 4.3 и позже.
-
kAFInfoDictionary_SubTitle
Подзаголовок.
Доступный в iOS 4.3 и позже.
-
-
Свойства, используемые функциями, описанными в получении и установке частей данных в аудиофайлах. Посмотрите Работу с Глобальной информацией для подробных данных.
Объявление
Swift
var kAudioFilePropertyFileFormat: Int { get } var kAudioFilePropertyDataFormat: Int { get } var kAudioFilePropertyFormatList: Int { get } var kAudioFilePropertyIsOptimized: Int { get } var kAudioFilePropertyMagicCookieData: Int { get } var kAudioFilePropertyAudioDataByteCount: Int { get } var kAudioFilePropertyAudioDataPacketCount: Int { get } var kAudioFilePropertyMaximumPacketSize: Int { get } var kAudioFilePropertyDataOffset: Int { get } var kAudioFilePropertyChannelLayout: Int { get } var kAudioFilePropertyDeferSizeUpdates: Int { get } var kAudioFilePropertyDataFormatName: Int { get } var kAudioFilePropertyMarkerList: Int { get } var kAudioFilePropertyRegionList: Int { get } var kAudioFilePropertyPacketToFrame: Int { get } var kAudioFilePropertyFrameToPacket: Int { get } var kAudioFilePropertyPacketToByte: Int { get } var kAudioFilePropertyByteToPacket: Int { get } var kAudioFilePropertyChunkIDs: Int { get } var kAudioFilePropertyInfoDictionary: Int { get } var kAudioFilePropertyPacketTableInfo: Int { get } var kAudioFilePropertyPacketSizeUpperBound: Int { get } var kAudioFilePropertyReserveDuration: Int { get } var kAudioFilePropertyEstimatedDuration: Int { get } var kAudioFilePropertyBitRate: Int { get } var kAudioFilePropertyID3Tag: Int { get } var kAudioFilePropertySourceBitDepth: Int { get } var kAudioFilePropertyAlbumArtwork: Int { get }
Objective C
enum { kAudioFilePropertyFileFormat = 'ffmt', kAudioFilePropertyDataFormat = 'dfmt', kAudioFilePropertyIsOptimized = 'optm', kAudioFilePropertyMagicCookieData = 'mgic', kAudioFilePropertyAudioDataByteCount = 'bcnt', kAudioFilePropertyAudioDataPacketCount = 'pcnt', kAudioFilePropertyMaximumPacketSize = 'psze', kAudioFilePropertyDataOffset = 'doff', kAudioFilePropertyChannelLayout = 'cmap', kAudioFilePropertyDeferSizeUpdates = 'dszu', kAudioFilePropertyDataFormatName = 'fnme', kAudioFilePropertyMarkerList = 'mkls', kAudioFilePropertyRegionList = 'rgls', kAudioFilePropertyPacketToFrame = 'pkfr', kAudioFilePropertyFrameToPacket = 'frpk', kAudioFilePropertyPacketToByte = 'pkby', kAudioFilePropertyByteToPacket = 'bypk', kAudioFilePropertyChunkIDs = 'chid', kAudioFilePropertyInfoDictionary = 'info', kAudioFilePropertyPacketTableInfo = 'pnfo', kAudioFilePropertyFormatList = 'flst', kAudioFilePropertyPacketSizeUpperBound = 'pkub', kAudioFilePropertyReserveDuration = 'rsrv', kAudioFilePropertyEstimatedDuration = 'edur', kAudioFilePropertyBitRate = 'brat', kAudioFilePropertyID3Tag = 'id3t', kAudioFilePropertySourceBitDepth = 'sbtd', kAudioFilePropertyAlbumArtwork = 'aart' };
Константы
-
kAudioFilePropertyFileFormat
Формат файла аудиоданных.
Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyDataFormat
Аудиопоток основное описание, содержащее формат аудиоданных.
Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyFormatList
Для поддержки форматов, таких как AAC SBR, в котором закодированный поток данных может декодироваться к многократным целевым форматам значение этого свойства является массивом значений элемента списка формата аудио (объявленный в
AudioFormat.h
) из тех форматов. Как правило, это - элемент списка формата аудио с тем же аудиопотоком основное описание вkAudioFilePropertyDataFormat
свойство.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyIsOptimized
Указывает, был ли определяемый аудиофайл оптимизирован, т.е. готовый начать писать звуковые данные к нему. Значение
0
указывает, что должен быть оптимизирован файл. Значение1
указывает, что в настоящее время оптимизируется файл.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyMagicCookieData
Указатель на память устанавливается вызывающей стороной. Некоторые типы файлов требуют, чтобы волшебный cookie был предоставлен, прежде чем пакеты могут быть записаны в аудиофайл. Установите это свойство перед вызовом
AudioFileWriteBytes
илиAudioFileWritePackets
если существует волшебный cookie.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyAudioDataByteCount
Указывает число байтов аудиоданных в определяемом файле.
Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyAudioDataPacketCount
Указывает число пакетов аудиоданных в определяемом файле.
Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyMaximumPacketSize
Указывает максимальный размер пакета для данных в определяемом файле.
Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyDataOffset
Указывает байтовое смещение в файле определяемых аудиоданных.
Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyChannelLayout
Структура расположения звукового канала.
Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyDeferSizeUpdates
Значение по умолчанию (
0
) всегда заголовок обновлений. Если установлено в1
, обновление размеров файлов в заголовке не выполняется каждый раз, когда данные записаны. Вместо этого обновление задерживается, пока файл не был считан, оптимизирован или закрыт. Этот процесс более эффективен, но не как безопасный. Если сбои приложения перед размером были обновлены, файл не мог бы быть читаемым.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyDataFormatName
Эта константа осуждается в OS X v 10.5 и позже. Не использовать. Вместо этого используйте
kAudioFormatProperty_FormatName
(объявленный вAudioFormat.h
заголовочный файл).Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyMarkerList
Список
CFStringRef
объекты, представляющие маркеры аудиофайла, определяются в файле.При доступе к этому свойству приложение ответственно за выпуск
CFStringRef
объекты.Используйте
NumBytesToNumAudioFileMarkers
иNumAudioFileMarkersToNumBytes
функции для преобразования между маркерами аудиофайла и эквивалентным числом байтов.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyRegionList
Список значений области аудиофайла определяется в файле.
При доступе к этому свойству приложение ответственно за выпуск
CFStringRef
объекты.Используйте
NextAudioFileRegion
функционируйте для обхода через список области.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyPacketToFrame
Передает аудио пакетную структуру перевода кадра с
mPacket
заполненное поле и возвратыmFrame
поле.mFrameOffsetInPacket
поле проигнорировано.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyFrameToPacket
Передает аудио пакетную структуру перевода кадра с
mFrame
заполненное поле и возвратыmPacket
иmFrameOffsetInPacket
поля.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyPacketToByte
Передает аудио пакетную структуру перевода байта с
mPacket
заполненное поле и возвратыmByte
поле.mByteOffsetInPacket
поле проигнорировано. Если значение вmByte
поле является оценкой тогдаkBytePacketTranslationFlag_IsEstimate
флаг установлен вmFlags
поле.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyByteToPacket
Передает аудио пакетную структуру перевода байта с
mByte
заполненное поле и возвратыmPacket
иmByteOffsetInPacket
поля. Если значение вmByte
поле является оценкой тогдаkBytePacketTranslationFlag_IsEstimate
флаг установлен вmFlags
поле.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyChunkIDs
Массив четырех кодов символов для каждого вида блока в файле.
Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyInfoDictionary
Словарь CF с информацией о данных в файле.
При доступе к этому свойству приложение ответственно за выпуск
CFDictionaryRef
объект.В OS X, компонент аудиофайла (типа
AudioFileComponent
свободно добавить ключи к словарям, которые они возвращают для этого свойства.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyPacketTableInfo
Получает или устанавливает пакетную табличную информационную структуру аудиофайла для ее типов вспомогательного файла. При установке структуры, суммы значений
mNumberValidFrames
,mPrimingFrames
иmRemainderFrames
поля должны совпасть с общим количеством кадров во всех пакетах. В противном случае aparamErr
возвращается. Для обеспечения этого результата получите значение свойства и удостоверьтесь сумма трех значений, которые Вы устанавливаете, имеет ту же сумму как три значения, которые Вы получили.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyPacketSizeUpperBound
Теоретический максимальный размер пакета в файле. Это значение получено, фактически не сканируя целый файл для нахождения самого большого пакета, как это могло произойти с
kAudioFilePropertyMaximumPacketSize
.Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyReserveDuration
Продолжительность в секундах данных ожидала быть записанной. Установите это свойство, прежде чем любые данные были записаны для резервирования пространства в заголовке файла для пакетной таблицы и другой информации для появления перед аудиоданными. Иначе, пакетная таблица могла бы быть записана в конце файла, препятствуя тому, чтобы файл был streamable.
Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyEstimatedDuration
Предполагаемая продолжительность в секундах. Если эта продолжительность может быть вычислена, не сканируя весь файл, или все пакеты аудиоданных были отсканированы, значение точно отражает продолжительность аудиоданных.
Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyBitRate
Фактическая скорость передачи (число битов аудиоданных в файле, разделенном на продолжительность файла) для некоторых типов файлов и номинальной скорости передачи (какая скорость передачи кодер была установлена в) для других.
Доступный в iOS 2.0 и позже.
-
kAudioFilePropertyID3Tag
A
void*
значение, указывающее на память, установленную Вашим приложением для содержания полностью отформатированный тег ID3.При установке это свойство должно быть установлено прежде, чем вызвать
AudioFileWritePackets
функция. Это свойство доступно и устанавливаемо при использовании версии 2 ID3. Это доступно только для версии 1 версии ID3. Самим тегом ID3 звукового файла не управляют при получении или установке этого свойства.Доступный в iOS 2.1 и позже.
-
kAudioFilePropertySourceBitDepth
Для сжатых данных значение этого свойства является битовой глубиной источника, несжатый аудиопоток как
SInt32
значение, если известный. Если несжатый источник был в формате с плавающей точкой, битовая глубина выражена как отрицательное число. Например, значение свойства-32
используется дляfloat
и значение свойства-64
представляетdouble
.Доступный в iOS 4.3 и позже.
-
kAudioFilePropertyAlbumArtwork
A
CFDataRef
объект, содержащий файл образа, связался с аудиофайлом.Данные изображения отформатированы или как JFIF (JPEG) или как PNG (PNG). При доступе к этому свойству приложение ответственно за выпуск
CFDataRef
объект.Доступный в iOS 5.0 и позже.
-
-
Получите доступ к этим свойствам с помощью функций, описанных в Работе с Глобальной информацией.
Объявление
Swift
var kAudioFileGlobalInfo_ReadableTypes: Int { get } var kAudioFileGlobalInfo_WritableTypes: Int { get } var kAudioFileGlobalInfo_FileTypeName: Int { get } var kAudioFileGlobalInfo_AvailableFormatIDs: Int { get } var kAudioFileGlobalInfo_AvailableStreamDescriptionsForFormat: Int { get } var kAudioFileGlobalInfo_AllExtensions: Int { get } var kAudioFileGlobalInfo_AllHFSTypeCodes: Int { get } var kAudioFileGlobalInfo_AllUTIs: Int { get } var kAudioFileGlobalInfo_AllMIMETypes: Int { get } var kAudioFileGlobalInfo_ExtensionsForType: Int { get } var kAudioFileGlobalInfo_HFSTypeCodesForType: Int { get } var kAudioFileGlobalInfo_UTIsForType: Int { get } var kAudioFileGlobalInfo_MIMETypesForType: Int { get } var kAudioFileGlobalInfo_TypesForExtension: Int { get } var kAudioFileGlobalInfo_TypesForHFSTypeCode: Int { get } var kAudioFileGlobalInfo_TypesForUTI: Int { get } var kAudioFileGlobalInfo_TypesForMIMEType: Int { get }
Objective C
enum { kAudioFileGlobalInfo_ReadableTypes = 'afrf', kAudioFileGlobalInfo_WritableTypes = 'afwf', kAudioFileGlobalInfo_FileTypeName = 'ftnm', kAudioFileGlobalInfo_AvailableStreamDescriptionsForFormat = 'sdid', kAudioFileGlobalInfo_AvailableFormatIDs = 'fmid', kAudioFileGlobalInfo_AllExtensions = 'alxt', kAudioFileGlobalInfo_AllHFSTypeCodes = 'ahfs', kAudioFileGlobalInfo_AllUTIs = 'auti', kAudioFileGlobalInfo_AllMIMETypes = 'amim', kAudioFileGlobalInfo_ExtensionsForType = 'fext', kAudioFileGlobalInfo_HFSTypeCodesForType = 'fhfs', kAudioFileGlobalInfo_UTIsForType = 'futi', kAudioFileGlobalInfo_MIMETypesForType = 'fmim', kAudioFileGlobalInfo_TypesForMIMEType = 'tmim', kAudioFileGlobalInfo_TypesForUTI = 'tuti', kAudioFileGlobalInfo_TypesForHFSTypeCode = 'thfs', kAudioFileGlobalInfo_TypesForExtension = 'text' };
Константы
-
kAudioFileGlobalInfo_ReadableTypes
Массив
UInt32
значения, содержащие типы файлов (такие как AIFF, WAVE, и т.д), который может быть открыт для чтения.При доступе к значению этого свойства необходимо установить
inSpecifier
параметр кNULL
.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_WritableTypes
Массив
UInt32
значения, содержащие типы файлов (такие как AIFF, WAVE, и т.д), который может быть открыт для записи.При доступе к значению этого свойства необходимо установить
inSpecifier
параметр кNULL
.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_FileTypeName
A
CFStringRef
объект, содержащий имя для типа файла.При доступе к этому свойству приложение ответственно за выпуск
CFStringRef
объект.При доступе к этому свойству обеспечьте указатель, в
inSpecifier
параметр, к идентификатору типа аудиофайла, содержащему тип файла.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_AvailableFormatIDs
Массив идентификаторов формата для форматов, которые могут быть считаны.
При доступе к этому свойству обеспечьте указатель, в
inSpecifier
параметр, к идентификатору типа аудиофайла, содержащему тип файла.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_AvailableStreamDescriptionsForFormat
Массив аудиопотока основные структуры описания, содержащие все форматы для определенного типа файла и идентификатора формата.
Аудиопотоку основные структуры описания заполнили следующие поля:
mFormatID
,mFormatFlags
, иmBitsPerChannel
для записи новых файлов. При доступе к этому свойству обеспечьте указатель, вinSpecifier
параметр, к идентификатору типа аудиофайла и структуре идентификатора формата.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_AllExtensions
A
CFArray
изCFStrings
содержа все распознанные расширения файла. Можно использовать этот массив при созданииNSOpenPanel
(объявленный в AppKitNSOpenPanel.h
заголовочный файл).При доступе к этому свойству приложение ответственно за выпуск
CFArrayRef
объект.При доступе к значению этого свойства необходимо установить
inSpecifier
параметр кNULL
.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_AllHFSTypeCodes
Массив кодов типа HFS, содержащих все, распознал коды типа HFS. Для получения дополнительной информации о кодах типа HFS посмотрите Аудио Панель инструментов
ExtendedAudioFile.h
заголовочный файл.При доступе к значению этого свойства необходимо установить
inSpecifier
параметр кNULL
.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_AllUTIs
A
CFArray
изCFString
из всего UTIs (Универсальные Идентификаторы типов) распознанный Audio File Services.При доступе к этому свойству приложение ответственно за выпуск
CFArrayRef
объект.При доступе к значению этого свойства необходимо установить
inSpecifier
параметр кNULL
.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_AllMIMETypes
A
CFArray
из строк CF всего MIME типы распознаны Audio File Services.При доступе к этому свойству приложение ответственно за выпуск
CFArrayRef
объект.При доступе к значению этого свойства необходимо установить
inSpecifier
параметр кNULL
.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_ExtensionsForType
A
CFArray
из строк CF, содержащих распознанные расширения файла для указанного типа.При доступе к этому свойству приложение ответственно за выпуск
CFArrayRef
объект.При доступе к этому свойству обеспечьте указатель, в
inSpecifier
параметр, к идентификатору типа аудиофайла, содержащему тип файла.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_HFSTypeCodesForType
Массив HFS вводит коды, соответствующие указанному типу файла. Первый тип в массиве является предпочтительным для использования.
При доступе к этому свойству обеспечьте указатель, в
inSpecifier
параметр, к идентификатору типа аудиофайла.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_UTIsForType
A
CFArray
изCFString
из всех Универсальных Идентификаторов типов, распознанных указанным типом файла.При доступе к этому свойству приложение ответственно за выпуск
CFArrayRef
объект.При доступе к этому свойству обеспечьте указатель, в
inSpecifier
параметр, к идентификатору типа аудиофайла.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_MIMETypesForType
A
CFArray
изCFString
из всех типов MIME, распознанных указанным типом файла.При доступе к этому свойству приложение ответственно за выпуск
CFArrayRef
объект.При доступе к этому свойству обеспечьте указатель, в
inSpecifier
параметр, к идентификатору типа аудиофайла.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_TypesForExtension
Массив всех идентификаторов типов аудиофайла, поддерживающих указанное расширение файла.
При доступе к этому свойству обеспечьте указатель, в
inSpecifier
параметр, к aCFStringRef
содержа расширение файла.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_TypesForHFSTypeCode
Массив всех идентификаторов типов аудиофайла, поддерживающих указанное
HFSTypeCode
.При доступе к этому свойству обеспечьте указатель, в
inSpecifier
параметр, кHFSTypeCode
.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_TypesForUTI
Массив всех идентификаторов типов аудиофайла, поддерживающих указанный UTI.
При доступе к этому свойству обеспечьте указатель, в
inSpecifier
параметр, к aCFStringRef
содержа Универсальный Идентификатор типа.Доступный в iOS 2.0 и позже.
-
kAudioFileGlobalInfo_TypesForMIMEType
Массив всех идентификаторов типов аудиофайла, поддерживающих указанный тип MIME.
При доступе к этому свойству обеспечьте указатель, в
inSpecifier
параметр, к aCFStringRef
содержа Тип MIME.Доступный в iOS 2.0 и позже.
Обсуждение
Спецификатор, в контексте одного из этих свойств, является указателем на буферное, содержащее данные, определенные для свойства. Каждое описание свойства называет тип данных требуемым. Вы предоставляете данные при доступе к этим свойствам с помощью функций, описанных в Работе с Глобальной информацией.
-
Эта таблица приводит коды результата, определенные для Audio File Services.
-
Никакая ошибка.
Значение
0
Описание
Никакая ошибка.
Доступный в iOS 4.0 и позже.
-
Неустановленная ошибка произошла.
Значение
'wht?'
Описание
Неустановленная ошибка произошла.
Доступный в iOS 2.0 и позже.
-
Тип файла не поддерживается.
Значение
‘typ?'
Описание
Тип файла не поддерживается.
Доступный в iOS 2.0 и позже.
-
Формат данных не поддерживается этим типом файла.
Значение
''fmt?'
Описание
Формат данных не поддерживается этим типом файла.
Доступный в iOS 2.0 и позже.
-
Свойство не поддерживается.
Значение
'имущество?'
Описание
Свойство не поддерживается.
Доступный в iOS 2.0 и позже.
-
Размер данных свойства не был корректен.
Значение
'! siz'
Описание
Размер данных свойства не был корректен.
Доступный в iOS 2.0 и позже.
-
Работа нарушила полномочия файла. Например, была предпринята попытка для записи в файл, открытый с
kAudioFileReadPermission
постоянный.Значение
'prm?'
Описание
Работа нарушила полномочия файла. Например, была предпринята попытка для записи в файл, открытый с
kAudioFileReadPermission
постоянный.Доступный в iOS 2.0 и позже.
-
Блоки после блока аудиоданных предотвращают расширение блока аудиоданных. Для записи большего количества данных необходимо оптимизировать файл.
Значение
'optm'
Описание
Блоки после блока аудиоданных предотвращают расширение блока аудиоданных. Для записи большего количества данных необходимо оптимизировать файл.
Доступный в iOS 2.0 и позже.
-
Или блок не существует в файле, или это не поддерживается файлом.
Значение
'chk?'
Описание
Или блок не существует в файле, или это не поддерживается файлом.
Доступный в iOS 2.0 и позже.
-
Файловое смещение было слишком большим для типа файла. AIFF и типы формата файла WAVE имеют 32-разрядные пределы размера файла.
Значение
'прочь?'
Описание
Файловое смещение было слишком большим для типа файла. AIFF и типы формата файла WAVE имеют 32-разрядные пределы размера файла.
Доступный в iOS 2.0 и позже.
-
Пакетное смещение прошло конец файла, или не в конце файла, когда формат VBR был записан, или поврежденный размер пакета был считан, когда была создана пакетная таблица.
Значение
'pck?'
Описание
Пакетное смещение прошло конец файла, или не в конце файла, когда формат VBR был записан, или поврежденный размер пакета был считан, когда была создана пакетная таблица.
Доступный в iOS 2.0 и позже.
-
Файл уродлив, или иначе не допустимый экземпляр аудиофайла его типа.
Значение
‘dta?'
Описание
Файл уродлив, или иначе не допустимый экземпляр аудиофайла его типа.
Доступный в iOS 2.0 и позже.
-
Работа не может быть выполнена. Например, установка
kAudioFilePropertyAudioDataByteCount
постоянный для увеличения размера аудиоданных в файле не поддерживаемая работа. Запишите данные вместо этого.Значение
0x6F703F3F
Описание
Работа не может быть выполнена. Например, установка
kAudioFilePropertyAudioDataByteCount
постоянный для увеличения размера аудиоданных в файле не поддерживаемая работа. Запишите данные вместо этого.Доступный в iOS 2.0 и позже.
-
Файл закрывается.
Значение
- 38
Описание
Файл закрывается.
Доступный в iOS 4.2 и позже.
-
Конец файла.
Значение
- 39
Описание
Конец файла.
Доступный в iOS 4.0 и позже.
-
Недопустимая позиция файла.
Значение
- 40
Описание
Недопустимая позиция файла.
Доступный в iOS 4.0 и позже.
-
Файл, не найденный.
Значение
- 43
Описание
Файл, не найденный.
Доступный в iOS 4.0 и позже.