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

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

Разработчик

Фото ссылка платформы ссылка класса PHAdjustmentData

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

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

PHAdjustmentData

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

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

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

Swift

import Photos

Objective C

@import Photos;

Доступность

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

Когда пользователь редактирует актив, фотографии сохраняет a PHAdjustmentData объект вместе с измененными данными изображения или видеоданными. Этот объект обеспечивает определенный с помощью приложения «рецепт», который можно использовать для восстановления редактирования. Например, если Ваше приложение применяет фильтры к фотографии, Вы, сила могла бы создать данные корректировки, идентифицирующие, какие фильтры пользователь выбрал, параметры для каждого и порядок применить фильтры в. Позже, пользователь может продолжить работать с теми фильтрами и параметрами при помощи Вашего приложения или другого приложения, понимающего Ваш формат данных корректировки.

Вы работаете с данными корректировки при редактировании актива, использовании любого requestContentEditingInputWithOptions:completionHandler: метод или фото расширение просматривают контроллер, реализующий PHContentEditingController протокол.

  • Когда Вы начинаете редактирование (через a PHContentEditingInput объект), исследуйте ввод редактирования adjustmentData свойство, чтобы решить, совместимо ли последнее редактирование, сделанное к активу, с Вашим приложением. Если так, можно позволить пользователю продолжать работать с тем редактированием. В противном случае можно сделать дальнейшие редактирования к последней сохраненной версии фотографии.

  • Когда Вы фиксируете редактирование (через a PHContentEditingOutput объект), обеспечьте новую корректировку, данные которой представляют изменения Ваше сделанное приложение.

Для каждого актива фотографии хранят только один PHAdjustmentData объект — это описывает новое редактирование, сделанное к содержанию актива.

Создание корректировки
  • init (formatIdentifier:formatVersion:data:) - initWithFormatIdentifier:formatVersion:data:

    Инициализирует объект корректировки с указанным форматом и данными.

    Объявление

    Swift

    init!(formatIdentifier formatIdentifier: String!, formatVersion formatVersion: String!, data data: NSData!)

    Objective C

    - (instancetype)initWithFormatIdentifier:(NSString *)formatIdentifier formatVersion:(NSString *)formatVersion data:(NSData *)data

    Параметры

    formatIdentifier

    Строка, однозначно определяющая формат данных корректировки.

    formatVersion

    Номер версии для формата данных корректировки.

    data

    Сериализированная форма любой информации необходима для восстановления корректировки.

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

    Инициализированный объект корректировки.

    Обсуждение

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

    Например, в первой версии Вашего приложения, Вы могли бы сохранить данные корректировки с помощью идентификатора com.example.myApp и версия 1.0. Если более поздняя версия Вашего приложения добавляет несовместимую информацию к данным корректировки, можно использовать тот же идентификатор и увеличить номер версии до 2.0.

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

Идентификация формата данных корректировки
  • formatIdentifier Свойство

    Строка, однозначно определяющая формат данных корректировки. (только для чтения)

    Объявление

    Swift

    var formatIdentifier: String! { get }

    Objective C

    @property(readonly, copy) NSString *formatIdentifier

    Обсуждение

    Установите этот идентификатор при создании объекта корректировки с initWithFormatIdentifier:formatVersion:data: метод. Для лучших результатов идентифицируйте свою организацию или продукт с помощью имени обратного стиля DNS, такой как com.example.myApp.

    Считайте это свойство, и formatVersion свойство, чтобы определить, создавались ли данные корректировки, сохраненные с активом, Вашим приложением или иначе совместимы с Вашим приложением.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • formatVersion Свойство

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

    Объявление

    Swift

    var formatVersion: String! { get }

    Objective C

    @property(readonly, copy) NSString *formatVersion

    Обсуждение

    Установите этот идентификатор при создании объекта корректировки с initWithFormatIdentifier:formatVersion:data: метод.

    Считайте это свойство, и formatIdentifier свойство, чтобы определить, создавались ли данные корректировки, сохраненные с активом, Вашим приложением или иначе совместимы с Вашим приложением.

    Например, в первой версии Вашего приложения, Вы могли бы сохранить данные корректировки с помощью идентификатора com.example.myApp и версия 1.0. Если более поздняя версия Вашего приложения добавляет несовместимую информацию к данным корректировки, можно использовать тот же идентификатор и увеличить номер версии до 2.0.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

Чтение данных корректировки
  • data Свойство

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

    Объявление

    Swift

    var data: NSData! { get }

    Objective C

    @property(readonly, strong) NSData *data

    Обсуждение

    Используйте это свойство, чтобы продолжить работать с последним редактированием, сделанным к активу. Например, если Ваше приложение применяет Базовые фильтры Изображения к фотографиям, это свойство может содержать сериализированный список свойств, описывающий фильтры и их параметры. Используйте formatIdentifier и formatVersion свойства, чтобы определить, являются ли данные корректировки, сохраненные с активом, в формате, который может понять Ваше приложение.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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