AVAudioFile

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

Независимо от фактического формата файла Вы читаете и пишете использование файла AVAudioPCMBuffer объекты, содержащие выборки в AVAudioCommonFormat, называемый форматом обработки файла. Преобразования выполняются к и от фактического формата файла.

Чтения и записи всегда являются последовательным, но произвольным доступом, возможно путем установки framePosition свойство.

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

NSObject
AVAudioFile

NSObject
AVAudioFile

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

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

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

Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность

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

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


    
    init (forReading:commonFormat:interleaved:error:)
    - initForReading:commonFormat:interleaved:error:

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

Объявление

Swift

init!(forReading fileURL: NSURL!, commonFormat format: AVAudioCommonFormat, interleaved interleaved: Bool, error outError: NSErrorPointer)

Objective C

- (instancetype)initForReading:(NSURL *)fileURL commonFormat:(AVAudioCommonFormat)format interleaved:(BOOL)interleaved error:(NSError **)outError

Параметры

`fileURL`	Путь файла для чтения.
`format`	Формат обработки для использования при чтении из файла.
`interleaved`	Использовать ли чередованный формат обработки.
`outError`	Возвраты, ссылкой, описание ошибки, если происходит ошибка.

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

Инициализированный аудиофайл возражает для чтения.

Обсуждение

Формат файла меня быть устранен чередование плавание, которое является AVAudioPCMFormatFloat32. Формат обработки относится к буферам, считанным из файла. Содержание читается и преобразовывается от формата файла до формата обработки. Формат обработки должен быть в той же частоте дискретизации как фактическое содержание файла и должен быть линейным PCM, чередован ли буфер обработки, плавание определяется interleaved параметр.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

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


    
    init (forReading:error:)
    - initForReading:error:

Открывает файл для чтения.

Объявление

Swift

init!(forReading fileURL: NSURL!, error outError: NSErrorPointer)

Objective C

- (instancetype)initForReading:(NSURL *)fileURL error:(NSError **)outError

Параметры

`fileURL`	Путь файла для чтения.
`outError`	Возвраты, ссылкой, описание ошибки, если происходит ошибка.

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

Инициализированный аудиофайл возражает для чтения.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

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


    
    init (forWriting:settings:commonFormat:interleaved:error:)
    - initForWriting:settings:commonFormat:interleaved:error:

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

Объявление

Swift

init!(forWriting fileURL: NSURL!, settings settings: [NSObject : AnyObject]!, commonFormat format: AVAudioCommonFormat, interleaved interleaved: Bool, error outError: NSErrorPointer)

Objective C

- (instancetype)initForWriting:(NSURL *)fileURL settings:(NSDictionary *)settings commonFormat:(AVAudioCommonFormat)format interleaved:(BOOL)interleaved error:(NSError **)outError

Параметры

`fileURL`	Путь для записи файла.
`settings`	Формат файла для создания. (См. `AVAudioRecorder`.)
`format`	Формат обработки для использования при записи в файл.
`interleaved`	Использовать ли чередованный формат обработки.
`outError`	Возвраты, ссылкой, описание ошибки, если происходит ошибка.

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

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

Обсуждение

Тип файла для создания выведен из расширения файла fileURL.

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

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

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

См. также

URL
processingFormat


    
    init (forWriting:settings:error:)
    - initForWriting:settings:error:

Откройте файл для записи.

Объявление

Swift

init!(forWriting fileURL: NSURL!, settings settings: [NSObject : AnyObject]!, error outError: NSErrorPointer)

Objective C

- (instancetype)initForWriting:(NSURL *)fileURL settings:(NSDictionary *)settings error:(NSError **)outError

Параметры

`fileURL`	Путь файла для создания для записи.
`settings`	Формат файла для создания. (См. `settings` свойство в `AVAudioRecorder` класс.)
`outError`	Возвраты, ссылкой, описание ошибки, если происходит ошибка.

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

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

Обсуждение

Тип файла для создания выведен из расширения файла fileURL. Если файл уже будет существовать, этот метод перезапишет файл в указанном URL.

Файл открыт для записи использования стандартного формата, AVAudioPCMFormatFloat32.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

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

См. также

URL

Чтение и запись аудио буфера


    
    readIntoBuffer (_: ошибка:)
    - readIntoBuffer:error:

Буфер, из которого можно читать в файл.

Объявление

Swift

func readIntoBuffer(_ buffer: AVAudioPCMBuffer!, error outError: NSErrorPointer) -> Bool

Objective C

- (BOOL)readIntoBuffer:(AVAudioPCMBuffer *)buffer error:(NSError **)outError

Параметры

`buffer`	Буфер, из которого можно считать файл. Его формат должен соответствовать формат обработки файла.
`outError`	Возвраты, ссылкой, описание ошибки, если происходит ошибка.

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

YEStrue, если чтение было успешно; иначе NOfalse.

Обсуждение

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

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

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

См. также

– readIntoBuffer:frameCount:error:
framePosition
длина


    
    readIntoBuffer (_: frameCount:error:)
    - readIntoBuffer:frameCount:error:

Считайте часть буфера.

Объявление

Swift

func readIntoBuffer(_ buffer: AVAudioPCMBuffer!, frameCount frames: AVAudioFrameCount, error outError: NSErrorPointer) -> Bool

Objective C

- (BOOL)readIntoBuffer:(AVAudioPCMBuffer *)buffer frameCount:(AVAudioFrameCount)frames error:(NSError **)outError

Параметры

`buffer`	Буфер, из которого можно считать файл. Его формат должен соответствовать формат обработки файла.
`frames`	Число кадров для чтения.
`outError`	Возвраты, ссылкой, описание ошибки, если происходит ошибка.

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

YEStrue, если чтение было успешно; иначе NOfalse.

Обсуждение

Как read:error: метод, но может использоваться для чтения меньшего количества кадров, чем buffer frameCapacity.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

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

См. также

– readIntoBuffer:error:


    
    writeFromBuffer (_: ошибка:)
    - writeFromBuffer:error:

Запишите буфер.

Объявление

Swift

func writeFromBuffer(_ buffer: AVAudioPCMBuffer!, error outError: NSErrorPointer) -> Bool

Objective C

- (BOOL)writeFromBuffer:(const AVAudioPCMBuffer *)buffer error:(NSError **)outError

Параметры

`buffer`	Буфер, от которого можно записать в файл. Его формат должен соответствовать формат обработки файла.
`outError`	Возвраты, ссылкой, описание ошибки, если происходит ошибка.

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

YEStrue, если чтение было успешно.

Обсуждение

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

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

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

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

формат файла формат файла Свойство

Дисковый формат файла. (только для чтения)

Объявление

Swift

var fileFormat: AVAudioFormat! { get }

Objective C

@property(nonatomic, readonly) AVAudioFormat *fileFormat

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

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

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

Объявление

Swift

var framePosition: AVAudioFramePosition

Objective C

@property(nonatomic) AVAudioFramePosition framePosition

Обсуждение

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

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
длина длина Свойство

Число демонстрационных кадров в файле. (только для чтения)

Объявление

Swift

var length: AVAudioFramePosition { get }

Objective C

@property(nonatomic, readonly) AVAudioFramePosition length

Обсуждение

Это может быть в вычислительном отношении дорого для вычислений впервые.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

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

Формат обработки файла. (только для чтения)

Объявление

Swift

var processingFormat: AVAudioFormat! { get }

Objective C

@property(nonatomic, readonly) AVAudioFormat *processingFormat

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

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

URL файл читает или пишет. (только для чтения)

Объявление

Swift

var url: NSURL! { get }

Objective C

@property(nonatomic, readonly) NSURL *url

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

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