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

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

Разработчик

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

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

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

AVAssetExportSession

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

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

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

Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность

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

AVAssetExportSession возразите транскодирует содержание AVAsset исходный объект для создания вывода формы, описанной указанной предварительной установкой экспорта.

До инициализации экземпляра AVAssetExportSession, можно использовать allExportPresets получить полный список доступных предварительных установок. Использовать exportPresetsCompatibleWithAsset: получить список предварительных установок, которые совместимы с определенным активом.

После инициализации сеанса экспорта с активом содержащим исходные носители, предварительно установленное имя экспорта (presetName), и тип выходного файла (outputFileType), можно запустить экспорт, работающий путем вызова exportAsynchronouslyWithCompletionHandler:. Поскольку экспорт выполняется асинхронно, этот метод сразу возвращается — можно использовать progress проверять прогресс. Когда многократный экспорт опробован, В зависимости от возможностей устройства может быть поставлен в очередь некоторый экспорт. Когда это происходит, status из экспорта с очередями укажет, что он ожидает (AVAssetExportSessionStatusWaiting).

Обработчик завершения Вы предоставляете к exportAsynchronouslyWithCompletionHandler: вызывается, перестал ли экспорт работать, завершается или отменяется. После завершения, status свойство указывает, завершился ли экспорт успешно. Если это перестало работать, значение error свойство предоставляет дополнительную информацию о причине отказа.

Инициализация сеанса

Конфигурирование вывода
  • outputURL Свойство

    URL вывода сеанса экспорта.

    Объявление

    Swift

    @NSCopying var outputURL: NSURL!

    Objective C

    @property(nonatomic, copy) NSURL *outputURL

    Обсуждение

    Можно наблюдать это свойство с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    outputFileType

  • supportedFileTypes Свойство

    Массив, содержащий типы файлов сеанс, может записать. (только для чтения)

    Объявление

    Swift

    var supportedFileTypes: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *supportedFileTypes

    Обсуждение

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

    Можно наблюдать это свойство с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    outputFileType
    – determineCompatibleFileTypesWithCompletionHandler:

  • outputFileType Свойство

    Тип файла, который будет записан сеансом.

    Объявление

    Swift

    var outputFileType: String!

    Objective C

    @property(nonatomic, copy) NSString *outputFileType

    Обсуждение

    Значение является строкой UTI, соответствующей типу файла для использования при записи актива. Для списка констант, указывающих UTIs для стандартных типов файлов, см. Ссылку Констант Основы AV.

    Можно наблюдать это свойство с помощью наблюдения Значения ключа.

    Специальные замечания

    Необходимо установить значение для этого свойства.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    supportedFileTypes
    outputURL

  • fileLengthLimit Свойство

    Указывает длину файла, которую не должен превышать вывод сеанса.

    Объявление

    Swift

    var fileLengthLimit: Int64

    Objective C

    @property(nonatomic) long long fileLengthLimit

    Обсуждение

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

    Можно наблюдать это свойство с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    maxDuration
    timeRange

  • timeRange Свойство

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

    Объявление

    Swift

    var timeRange: CMTimeRange

    Objective C

    @property(nonatomic) CMTimeRange timeRange

    Обсуждение

    Диапазон времени по умолчанию сеанса экспорта kCMTimeZero к kCMTimePositiveInfinity, подразумевать, что (по модулю возможный предел на длине файла) будет экспортироваться полная продолжительность актива.

    Можно наблюдать это свойство с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • metadata Свойство

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

    Объявление

    Swift

    var metadata: [AnyObject]!

    Objective C

    @property(nonatomic, copy) NSArray *metadata

    Обсуждение

    Метаданные являются массивом AVMetadataItem объекты.

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

    Можно наблюдать это свойство с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • metadataItemFilter Свойство

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

    Объявление

    Swift

    var metadataItemFilter: AVMetadataItemFilter!

    Objective C

    @property(nonatomic, retain) AVMetadataItemFilter *metadataItemFilter

    Обсуждение

    Если значение этого ключа nil, никакой фильтр не будет применен. Это - значение по умолчанию.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • audioMix Свойство

    Указывает, включено ли микширование звука не по умолчанию для экспорта и предоставляет параметры для микширования звука.

    Объявление

    Swift

    @NSCopying var audioMix: AVAudioMix!

    Objective C

    @property(nonatomic, copy) AVAudioMix *audioMix

    Обсуждение

    Можно наблюдать это свойство с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • audioTimePitchAlgorithm Свойство

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

    Объявление

    Swift

    var audioTimePitchAlgorithm: String!

    Objective C

    @property(nonatomic, copy) NSString *audioTimePitchAlgorithm

    Обсуждение

    Исключение (NSInvalidArgumentException) если это свойство установлено в значение кроме констант, определенных в, повышен Time Pitch Algorithm Settings.

    Значение по умолчанию AVAudioTimePitchAlgorithmSpectral.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • shouldOptimizeForNetworkUse Свойство

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

    Объявление

    Swift

    var shouldOptimizeForNetworkUse: Bool

    Objective C

    @property(nonatomic) BOOL shouldOptimizeForNetworkUse

    Обсуждение

    Можно наблюдать это свойство с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • videoComposition Свойство

    Указывает, включен ли видео состав для экспорта и предоставляет инструкции для видео состава.

    Объявление

    Swift

    @NSCopying var videoComposition: AVVideoComposition!

    Objective C

    @property(nonatomic, copy) AVVideoComposition *videoComposition

    Обсуждение

    Можно наблюдать это свойство с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • customVideoCompositor Свойство

    Указывает пользовательский видео используемый экземпляр наборщика, если таковые имеются. (только для чтения)

    Объявление

    Swift

    var customVideoCompositor: AVVideoCompositing! { get }

    Objective C

    @property(nonatomic, readonly) id< AVVideoCompositing > customVideoCompositor

    Обсуждение

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

    Если значение videoComposition изменяется от AVVideoComposition это указывает пользовательский видео класс наборщика другого экземпляра AVVideoComposition это указывает тот же пользовательский видео класс наборщика, экземпляр ранее создававшегося пользовательского видео наборщика получит renderContextChanged: обменивайтесь сообщениями и останьтесь в использовании для последующего формирования изображения.

    Это свойство nil если внутренний видео наборщик используется, если нет никакого видео наборщика, или.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • canPerformMultiplePassesOverSourceMediaData Свойство

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

    Объявление

    Swift

    var canPerformMultiplePassesOverSourceMediaData: Bool

    Objective C

    @property(nonatomic) BOOL canPerformMultiplePassesOverSourceMediaData

    Обсуждение

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

    Значение по умолчанию NOfalse. Не все конфигурации сеанса экспорта могут получить преимущества от выполнения многократных передач по исходным носителям. В этих случаях, устанавливая это свойство в YEStrue не имеет никакого эффекта.

    Это свойство не может быть установлено после того, как экспорт запустился.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • directoryForTemporaryFiles Свойство

    Указывает каталог, подходящий для содержания временных файлов, сгенерированных во время процесса экспорта.

    Объявление

    Swift

    @NSCopying var directoryForTemporaryFiles: NSURL!

    Objective C

    @property(nonatomic, copy) NSURL *directoryForTemporaryFiles

    Обсуждение

    Сеанс экспорта актива, возможно, должен записать временные файлы, например когда canPerformMultiplePassesOverSourceMediaData установлен в YEStrue. Это свойство указывает, где в файловой системе создаются те временные файлы. Все временные файлы будут удалены, когда экспорт будет завершен, отменяется, или сбои.

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Предварительные установки экспорта

Экспорт
  • exportAsynchronouslyWithCompletionHandler (_:) - exportAsynchronouslyWithCompletionHandler:

    Запускает асинхронное выполнение сеанса экспорта.

    Объявление

    Swift

    func exportAsynchronouslyWithCompletionHandler(_ handler: (() -> Void)!)

    Objective C

    - (void)exportAsynchronouslyWithCompletionHandler:(void (^)(void))handler

    Параметры

    handler

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

    Обсуждение

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

    Если внутренняя подготовка к сбоям экспорта, handler вызывается синхронно. Обработчик можно также вызвать асинхронно, после возвратов метода, в следующих случаях:

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

    2. Если cancelExport вызывается.

    3. После того, как сеанс экспорта успешно выполняется, полностью записав его вывод в outputURL.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

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

  • cancelExport () - cancelExport

    Отменяет выполнение сеанса экспорта.

    Объявление

    Swift

    func cancelExport()

    Objective C

    - (void)cancelExport

    Обсуждение

    Когда экспорт работает, можно вызвать этот метод.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • error Свойство

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

    Объявление

    Swift

    var error: NSError! { get }

    Objective C

    @property(nonatomic, readonly) NSError *error

    Обсуждение

    Если нет никакой ошибки сообщить, значение этого свойства nil.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – exportAsynchronouslyWithCompletionHandler:
    состояние

  • estimatedOutputFileLength Свойство

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

    Объявление

    Swift

    var estimatedOutputFileLength: Int64 { get }

    Objective C

    @property(nonatomic, readonly) long long estimatedOutputFileLength

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • maxDuration Свойство

    Обеспечивает оценку максимальной продолжительности экспортируемых носителей. (только для чтения)

    Объявление

    Swift

    var maxDuration: CMTime { get }

    Objective C

    @property(nonatomic, readonly) CMTime maxDuration

    Обсуждение

    Возвраты 0, когда предварительная установка экспорта AVAssetExportPresetPassthrough или AVAssetExportPresetAppleProRes422LPCM. Это свойство также возвратится 0 если числовое значение (весьма допустимый, неопределенный, или бесконечный) для timeRange свойство не было установлено.

    Можно наблюдать это свойство с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Состояние экспорта
  • progress Свойство

    Прогресс экспорта в масштабе от 0 до 1. (только для чтения)

    Объявление

    Swift

    var progress: Float { get }

    Objective C

    @property(nonatomic, readonly) float progress

    Обсуждение

    Значение 0 означает, что экспорт еще не начался, 1 означает, что экспорт завершен.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • status Свойство

    Состояние сеанса экспорта. (только для чтения)

    Объявление

    Swift

    var status: AVAssetExportSessionStatus { get }

    Objective C

    @property(nonatomic, readonly) AVAssetExportSessionStatus status

    Обсуждение

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

    Можно наблюдать это свойство с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Доступ к активу
  • asset Свойство

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

    Объявление

    Swift

    var asset: AVAsset! { get }

    Objective C

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Константы
  • AVAssetExportSessionStatus

    Константы для указания состояния сеанса.

    Объявление

    Swift

    enum AVAssetExportSessionStatus : Int { case Unknown case Waiting case Exporting case Completed case Failed case Cancelled }

    Objective C

    enum { AVAssetExportSessionStatusUnknown, AVAssetExportSessionStatusWaiting, AVAssetExportSessionStatusExporting, AVAssetExportSessionStatusCompleted, AVAssetExportSessionStatusFailed, AVAssetExportSessionStatusCancelled }; typedef NSInteger AVAssetExportSessionStatus;

    Константы

    • Unknown

      AVAssetExportSessionStatusUnknown

      Указывает, что состояние неизвестно.

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

    • Waiting

      AVAssetExportSessionStatusWaiting

      Указывает, что сеанс ожидает для экспорта большего количества данных.

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

    • Exporting

      AVAssetExportSessionStatusExporting

      Указывает, что сеанс экспорта происходит.

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

    • Completed

      AVAssetExportSessionStatusCompleted

      Указывает, что сеанс экспорта завершился успешно.

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

    • Failed

      AVAssetExportSessionStatusFailed

      Указывает, что сеанс экспорта перестал работать.

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

    • Cancelled

      AVAssetExportSessionStatusCancelled

      Указывает, что был отменен сеанс экспорта.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • Экспортируйте предварительно установленные имена для надлежащих устройству файлов QuickTime

    Вы используете эти опции экспорта произвести QuickTime .mov файлы с размером видео, надлежащим текущему устройству.

    Объявление

    Swift

    let AVAssetExportPresetLowQuality: String let AVAssetExportPresetMediumQuality: String let AVAssetExportPresetHighestQuality: String

    Objective C

    NSString *const AVAssetExportPresetLowQuality; NSString *const AVAssetExportPresetMediumQuality; NSString *const AVAssetExportPresetHighestQuality;

    Константы

    • AVAssetExportPresetLowQuality

      Указывает низкое качество файл QuickTime.

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

    • AVAssetExportPresetMediumQuality

      Указывает среднее качество файл QuickTime.

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

    • AVAssetExportPresetHighestQuality

      Указывает высококачественный файл QuickTime.

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

    Обсуждение

    Экспорт не увеличит масштаб видео от меньшего размера. Видео сжато с помощью H.264; аудио сжато с помощью AAC.

    См. также AVAssetExportSessionStatusCancelled.

  • Экспортируйте предварительно установленные имена для файлов QuickTime данного размера

    Вы используете эти опции экспорта произвести QuickTime .mov файлы с указанным размером видео.

    Объявление

    Swift

    let AVAssetExportPreset640x480: String let AVAssetExportPreset960x540: String let AVAssetExportPreset1280x720: String let AVAssetExportPreset1920x1080: String

    Objective C

    NSString *const AVAssetExportPreset640x480; NSString *const AVAssetExportPreset960x540; NSString *const AVAssetExportPreset1280x720; NSString *const AVAssetExportPreset1920x1080;

    Константы

    • AVAssetExportPreset640x480

      Указывает вывод в 640x480 пикселях.

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

    • AVAssetExportPreset960x540

      Указывает вывод в 960x540 пикселях.

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

    • AVAssetExportPreset1280x720

      Указывает вывод в 1280x720 пикселях.

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

    • AVAssetExportPreset1920x1080

      Указывает вывод в 1920x1080 пикселях.

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

    Обсуждение

    Экспорт не увеличит масштаб видео от меньшего размера. Видео сжато с помощью H.264; аудио сжато с помощью AAC. Некоторые устройства не могут поддерживать некоторые размеры.

  • Экспортируйте Предварительно установленное Имя для Аудио iTunes

    Вы используете эту опцию экспорта произвести .m4a файл только для аудио с надлежащим iTunes сплошные данные воспроизведения.

    Объявление

    Swift

    let AVAssetExportPresetAppleM4A: String

    Objective C

    NSString *const AVAssetExportPresetAppleM4A;

    Константы

    • AVAssetExportPresetAppleM4A

      Указывает .m4a файл только для аудио с надлежащим iTunes сплошные данные воспроизведения.

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

  • Экспортируйте предварительно установленное имя для передачи

    Вы используете эту опцию экспорта позволить всем дорожкам пройти.

    Объявление

    Swift

    let AVAssetExportPresetPassthrough: String

    Objective C

    NSString *const AVAssetExportPresetPassthrough;

    Константы

    • AVAssetExportPresetPassthrough

      Указывает, что все дорожки проходят, если это не возможно.

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

    Обсуждение

    Эта опция не обнаруживается в allExportPresets и exportPresetsCompatibleWithAsset: методы.