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

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

Разработчик

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

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

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

AVAssetReader

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

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

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

Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность

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

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

AVAssetReader позволяет Вам:

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

  • Смешайте многократные аудиотреки актива и составьте многократные видеотреки (при помощи AVAssetReaderAudioMixOutput и AVAssetReaderVideoCompositionOutput).

AVAssetReaderконвейеры многопоточны внутренне. После инициирования чтения с initWithAsset:error:, читатель загружает и обрабатывает разумную сумму демонстрационных данных перед использованием так, чтобы операции извлечения такой как copyNextSampleBuffer (AVAssetReaderOutput) может иметь очень низкую задержку.

Создание читателя
  • init (asset:error:) - initWithAsset:error:

    Инициализирует читателя актива для чтения данных носителей из указанного актива.

    Объявление

    Swift

    init!(asset asset: AVAsset!, error outError: NSErrorPointer)

    Objective C

    - (instancetype)initWithAsset:(AVAsset *)asset error:(NSError **)outError

    Параметры

    asset

    Актив, из которого должны быть считаны данные носителей.

    outError

    Если инициализация сбоев читателя, по возврату содержит ошибку, описывающую проблему.

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

    Читатель актива, инициализированный для чтения данных носителей из asset.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    + assetReaderWithAsset:error:

  • + assetReaderWithAsset:error:

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

    Объявление

    Objective C

    + (instancetype)assetReaderWithAsset:(AVAsset *)asset error:(NSError **)outError

    Параметры

    asset

    Актив, из которого должны быть считаны данные носителей.

    outError

    Если инициализация сбоев читателя, по возврату содержит ошибку, описывающую проблему.

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

    Читатель актива, инициализированный для чтения данных носителей из asset.

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

    Objective C

    @import AVFoundation;

    Доступность

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

    См. также

    – initWithAsset:error:

Управление выводами
  • outputs Свойство

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

    Объявление

    Swift

    var outputs: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *outputs

    Обсуждение

    Массив содержит конкретные экземпляры AVAssetReaderOutput связанный с читателем.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – canAddOutput:
    – addOutput:

  • addOutput (_:) - addOutput:

    Добавляет данный вывод к получателю.

    Объявление

    Swift

    func addOutput(_ output: AVAssetReaderOutput!)

    Objective C

    - (void)addOutput:(AVAssetReaderOutput *)output

    Параметры

    output

    Читатель вывел для добавления.

    Обсуждение

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – canAddOutput:
    выводы
    актив

  • canAddOutput (_:) - canAddOutput:

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

    Объявление

    Swift

    func canAddOutput(_ output: AVAssetReaderOutput!) -> Bool

    Objective C

    - (BOOL)canAddOutput:(AVAssetReaderOutput *)output

    Параметры

    output

    Читатель вывел, чтобы быть протестированным.

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

    YEStrue если output может быть добавлен к получателю, иначе NOfalse.

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – addOutput:
    выводы

Управление чтением
  • status Свойство

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

    Объявление

    Swift

    var status: AVAssetReaderStatus { get }

    Objective C

    @property(readonly) AVAssetReaderStatus status

    Обсуждение

    Это свойство ориентировано на многопотоковое исполнение. Для возможных значений посмотрите AVAssetReaderStatus.

    Значение этого свойства указывает, происходит ли чтение, завершилось успешно, было отменено или перестало работать. Необходимо проверить значение этого свойства после AVAssetReaderOutput метод copyNextSampleBuffer возвраты NULL определить, почему не могло быть считано больше выборок.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • startReading () - startReading

    Подготавливает получатель к получению демонстрационных буферов от актива.

    Объявление

    Swift

    func startReading() -> Bool

    Objective C

    - (BOOL)startReading

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

    YEStrue если читатель в состоянии начать читать, иначе NOfalse.

    Обсуждение

    Этот метод проверяет весь набор настроек для выводов для дорожек, для аудио mixdown, и для видео состава и инициирует чтение всех выводов.

    status если отказ происходит, сигнализирует терминальное состояние читателя актива, и error описывает отказ.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – cancelReading
    состояние
    ошибка

  • cancelReading () - cancelReading

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

    Объявление

    Swift

    func cancelReading()

    Objective C

    - (void)cancelReading

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – startReading
    состояние
    ошибка

  • error Свойство

    Описывает ошибку, произошедшую, если состояние AVAssetReaderStatusFailed. (только для чтения)

    Объявление

    Swift

    var error: NSError! { get }

    Objective C

    @property(readonly) NSError *error

    Обсуждение

    Это свойство ориентировано на многопотоковое исполнение.

    Значение этого свойства описывает то, что заставило читателя больше не быть в состоянии считать его актив. Если состояние читателя не AVAssetReaderStatusFailed, значение этого свойства nil.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – startReading
    состояние

  • timeRange Свойство

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

    Объявление

    Swift

    var timeRange: CMTimeRange

    Objective C

    @property(nonatomic) CMTimeRange timeRange

    Обсуждение

    Пересечение значения этого свойства и CMTimeRangeMake(kCMTimeZero, asset.duration) определяет диапазон времени актива, из которого будут считаны данные носителей.

    Значение по умолчанию CMTimeRangeMake(kCMTimeZero, kCMTimePositiveInfinity).

    Вы не можете изменить значение этого свойства после того, как запустилось чтение.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Свойства актива
  • asset Свойство

    Актив, с которым был инициализирован получатель. (только для чтения)

    Объявление

    Swift

    var asset: AVAsset! { get }

    Objective C

    @property(nonatomic, retain, readonly) AVAsset *asset

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Константы
  • AVAssetReaderStatus

    Константы, указывающие состояние читателя.

    Объявление

    Swift

    enum AVAssetReaderStatus : Int { case Unknown case Reading case Completed case Failed case Cancelled }

    Objective C

    enum { AVAssetReaderStatusUnknown = 0, AVAssetReaderStatusReading, AVAssetReaderStatusCompleted, AVAssetReaderStatusFailed, AVAssetReaderStatusCancelled, }; typedef NSInteger AVAssetReaderStatus;

    Константы

    • Unknown

      AVAssetReaderStatusUnknown

      Указывает это startReading еще не был вызван.

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

    • Reading

      AVAssetReaderStatusReading

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

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

    • Completed

      AVAssetReaderStatusCompleted

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

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

    • Failed

      AVAssetReaderStatusFailed

      Указывает то отказавшее чтение.

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

    • Cancelled

      AVAssetReaderStatusCancelled

      Указывает, что чтение было отменено с помощью cancelReading.

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

    Обсуждение

    Вы получаете доступ к состоянию читателя с помощью status свойство.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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