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

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

Разработчик

Ссылка платформы AVFoundation ссылка класса AVAudioRecorder

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

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

AVAudioRecorder

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

  • Запись, пока пользователь не останавливает запись

  • Запись на указанное время

  • Пауза и резюме запись

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

В iOS зарегистрированное аудио прибывает из устройства, подключенного пользователем — встроенный микрофон или микрофон гарнитуры, например. В OS X аудио прибывает из устройства аудиовхода системы по умолчанию, как установлено пользователем в Установках системы.

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

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

Для конфигурирования надлежащего аудио сеанса для записи обратитесь к Ссылке на протокол Ссылки класса и AVAudioSessionDelegate AVAudioSession.

AVAudioRecorder класс предназначается, чтобы позволить Вам делать аудиозаписи с очень небольшим программированием наверху. Другие классы, которые могут использоваться для записи аудио в iOS и OS X, включают AVCaptureAudioDataOutput и службы Audio Queue описаны в Руководстве по программированию Audio Queue Services.

В OS X можно также использовать AVCaptureAudioFileOutput класс для записи аудио.

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

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

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

Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность

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

Инициализация объекта AVAudioRecorder
  • init (URL:settings:error:) - initWithURL:settings:error:

    Инициализирует и возвращает магнитофон.

    Объявление

    Swift

    init!(URL url: NSURL!, settings settings: [NSObject : AnyObject]!, error outError: NSErrorPointer)

    Objective C

    - (instancetype)initWithURL:(NSURL *)url settings:(NSDictionary *)settings error:(NSError **)outError

    Параметры

    url

    Местоположение файловой системы для записи к. Тип файла для записи к выведен из расширения файла, включенного в значение этого параметра.

    settings

    Настройки для сеанса записи. Для получения информации о настройках, доступных для магнитофона, см. Константы Параметров звука Основы AV.

    outError

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

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

    На успехе, инициализированном AVAudioRecorder объект. Если nil, outError параметр содержит NSError описание отказа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Конфигурирование и управление записью
  • prepareToRecord () - prepareToRecord

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

    Объявление

    Swift

    func prepareToRecord() -> Bool

    Objective C

    - (BOOL)prepareToRecord

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

    YEStrue в случае успеха, иначе NOfalse.

    Обсуждение

    Создает аудиофайл в расположении, указанном url параметр в initWithURL:settings:error: метод. Если файл уже существует в том расположении, этот метод перезаписывает его.

    Когда Вы вызываете, подготовка, вызванная этим методом, имеет место автоматически record. Использовать prepareToRecord когда Вы хотите записать для запуска как можно быстрее по вызову record.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • запись () - запись

    Запускает или продолжает записывать.

    Объявление

    Swift

    func record() -> Bool

    Objective C

    - (BOOL)record

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

    YEStrue в случае успеха, иначе NOfalse.

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • recordForDuration (_:) - recordForDuration:

    Записи на указанное время времени.

    Объявление

    Swift

    func recordForDuration(_ duration: NSTimeInterval) -> Bool

    Objective C

    - (BOOL)recordForDuration:(NSTimeInterval)duration

    Параметры

    duration

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

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

    YEStrue в случае успеха, иначе NOfalse.

    Обсуждение

    Когда продолжительность зарегистрированного аудио достигает значения в, устройство записи останавливается duration параметр.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • пауза () - пауза

    Приостанавливает запись.

    Объявление

    Swift

    func pause()

    Objective C

    - (void)pause

    Обсуждение

    Вызовите record метод, чтобы продолжить записывать.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • остановитесь () - остановиться

    Запись остановок и завершения аудиофайл.

    Объявление

    Swift

    func stop()

    Objective C

    - (void)stop

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • делегат делегат Свойство

    Объект делегата для магнитофона.

    Объявление

    Swift

    unowned(unsafe) var delegate: AVAudioRecorderDelegate!

    Objective C

    @property(assign) id< AVAudioRecorderDelegate > delegate

    Обсуждение

    Для описания делегата магнитофона посмотрите Ссылку на протокол AVAudioRecorderDelegate.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • deleteRecording () - deleteRecording

    Удаляет зарегистрированный аудиофайл.

    Объявление

    Swift

    func deleteRecording() -> Bool

    Objective C

    - (BOOL)deleteRecording

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

    Возвраты YEStrue на успехе; иначе NOfalse.

    Обсуждение

    Магнитофон должен быть остановлен перед вызовом этого метода.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Управление информацией о записи
  • запись запись Свойство

    Булево значение, указывающее, записывает ли магнитофон. (только для чтения)

    Объявление

    Swift

    var recording: Bool { get }

    Objective C

    @property(readonly, getter=isRecording) BOOL recording

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • URL URL Свойство

    URL для аудиофайла связался с магнитофоном. (только для чтения)

    Объявление

    Swift

    var url: NSURL! { get }

    Objective C

    @property(readonly) NSURL *url

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • currentTime currentTime Свойство

    Время, в секундах, с начала записи. (только для чтения)

    Объявление

    Swift

    var currentTime: NSTimeInterval { get }

    Objective C

    @property(readonly) NSTimeInterval currentTime

    Обсуждение

    Когда магнитофон останавливается, вызывание этого метода возвращает значение 0.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • настройки настройки Свойство

    Параметры звука для магнитофона. (только для чтения)

    Объявление

    Swift

    var settings: [NSObject : AnyObject]! { get }

    Objective C

    @property(readonly) NSDictionary *settings

    Обсуждение

    Настройки магнитофона имеют силу только после явного вызова prepareToRecord метод, или после вызова его неявно путем запуска записи. Ключи параметров звука описаны в Константах Параметров звука Основы AV.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Используя измерение уровня звука
  • meteringEnabled meteringEnabled Свойство

    Булево значение, указывающее, включено ли измерение уровня звука.

    Объявление

    Swift

    var meteringEnabled: Bool

    Objective C

    @property(getter=isMeteringEnabled) BOOL meteringEnabled

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • updateMeters () - updateMeters

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

    Объявление

    Swift

    func updateMeters()

    Objective C

    - (void)updateMeters

    Обсуждение

    Для получения текущих значений мощности звука необходимо вызвать этот метод перед вызовом averagePowerForChannel: или peakPowerForChannel:.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    meteringEnabled

  • peakPowerForChannel (_:) - peakPowerForChannel:

    Возвращает пиковое питание для данного канала, в децибелах, для зарегистрированного звука.

    Объявление

    Swift

    func peakPowerForChannel(_ channelNumber: Int) -> Float

    Objective C

    - (float)peakPowerForChannel:(NSUInteger)channelNumber

    Параметры

    channelNumber

    Число канала, для которого Вы хотите пиковое значение питания.

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

    Текущее пиковое питание, в децибелах, для зарегистрированного звука. Возвращаемое значение 0 дБ указывает полный масштаб или максимальную мощность; возвращаемое значение-160 дБ указывает минимальное питание (т.е. около тишины).

    Если сигнал, предоставленный для магнитофона, превышает масштаб ±full, то возвращаемое значение может превысить 0 (т.е. это может ввести положительный диапазон).

    Обсуждение

    Для получения текущего пикового значения питания вызовите updateMeters метод сразу прежде, чем вызвать этот метод.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – averagePowerForChannel:
    meteringEnabled

  • averagePowerForChannel (_:) - averagePowerForChannel:

    Возвращает среднюю мощность для данного канала, в децибелах, для зарегистрированного звука.

    Объявление

    Swift

    func averagePowerForChannel(_ channelNumber: Int) -> Float

    Objective C

    - (float)averagePowerForChannel:(NSUInteger)channelNumber

    Параметры

    channelNumber

    Число канала, для которого Вы хотите значение средней мощности.

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

    Текущая средняя мощность, в децибелах, для зарегистрированного звука. Возвращаемое значение 0 дБ указывает полный масштаб или максимальную мощность; возвращаемое значение-160 дБ указывает минимальное питание (т.е. около тишины).

    Если сигнал, предоставленный для магнитофона, превышает масштаб ±full, то возвращаемое значение может превысить 0 (т.е. это может ввести положительный диапазон).

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    meteringEnabled
    – peakPowerForChannel: