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

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

Разработчик

Ссылка платформы AssetsLibrary ссылка класса ALAsset

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

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

ALAsset

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

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

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

Swift

import AssetsLibrary

Objective C

@import AssetsLibrary;

Доступность

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

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

Активы могут иметь многократные представления, например фотография, полученная в RAW и JPG. Различные представления того же актива могут иметь различные размерности.

Свойства актива
  • valueForProperty (_:) - valueForProperty:

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

    Объявление

    Swift

    func valueForProperty(_ property: String!) -> AnyObject!

    Objective C

    - (id)valueForProperty:(NSString *)property

    Параметры

    property

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

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

    Значение для property. Если property не допустимый ключ, возвраты ALErrorInvalidProperty.

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

    Objective C

    @import AssetsLibrary;

    Swift

    import AssetsLibrary

    Доступность

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

  • editable Свойство

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

    Объявление

    Swift

    var editable: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isEditable) BOOL editable

    Обсуждение

    Значение свойства YEStrue если приложение в состоянии отредактировать актив, и NOfalse если приложение не в состоянии отредактировать актив. Приложениям только позволяют отредактировать активы, которые они первоначально записали.

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

    Objective C

    @import AssetsLibrary;

    Swift

    import AssetsLibrary

    Доступность

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

  • originalAsset Свойство

    Исходная версия актива. (только для чтения)

    Объявление

    Swift

    var originalAsset: ALAsset! { get }

    Objective C

    @property(nonatomic, readonly) ALAsset *originalAsset

    Обсуждение

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

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

    Objective C

    @import AssetsLibrary;

    Swift

    import AssetsLibrary

    Доступность

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

Доступ к представлениям
  • defaultRepresentation () - defaultRepresentation

    Возвращает объект представления актива для представления по умолчанию.

    Объявление

    Swift

    func defaultRepresentation() -> ALAssetRepresentation!

    Objective C

    - (ALAssetRepresentation *)defaultRepresentation

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

    Представление актива возражает для представления по умолчанию.

    Обсуждение

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

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

    Objective C

    @import AssetsLibrary;

    Swift

    import AssetsLibrary

    Доступность

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

  • representationForUTI (_:) - representationForUTI:

    Возвращает объект представления актива для данного представления UTI.

    Объявление

    Swift

    func representationForUTI(_ representationUTI: String!) -> ALAssetRepresentation!

    Objective C

    - (ALAssetRepresentation *)representationForUTI:(NSString *)representationUTI

    Параметры

    representationUTI

    UTI описание представления для актива.

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

    Представление актива возражают для представления, указанного representationUTI, или nil если актив не поддерживает представление.

    Обсуждение

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

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

    Objective C

    @import AssetsLibrary;

    Swift

    import AssetsLibrary

    Доступность

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

  • миниатюра () - миниатюра

    Возвращает представление миниатюры актива.

    Объявление

    Swift

    func thumbnail() -> Unmanaged<CGImage>!

    Objective C

    - (CGImageRef)thumbnail

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

    Представление миниатюры актива.

    Обсуждение

    Размер миниатюры является подходящим для платформы. Изображение возвращается в корректной ориентации (т.е. «подчеркивая» — Вам не придется повернуть изображение).

    Этот метод возвраты NULL для активов от совместно используемого фото потока, которые еще не доступны локально. Если актив становится доступным в будущем, ALAssetsLibraryChangedNotification уведомление отправляется.

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

    Objective C

    @import AssetsLibrary;

    Swift

    import AssetsLibrary

    Доступность

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

  • aspectRatioThumbnail () - aspectRatioThumbnail

    Возвращает миниатюру форматного соотношения актива.

    Объявление

    Swift

    func aspectRatioThumbnail() -> Unmanaged<CGImage>!

    Objective C

    - (CGImageRef)aspectRatioThumbnail

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

    Миниатюра форматного соотношения актива.

    Обсуждение

    Возвращает CGImage с миниатюрой форматного соотношения актива. Размер миниатюры является надлежащим размером для платформы, и в корректной ориентации.

    Этот метод возвраты NULL для активов от совместно используемого фото потока, которые еще не доступны локально. Если актив становится доступным в будущем, ALAssetsLibraryChangedNotification уведомление отправляется.

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

    Objective C

    @import AssetsLibrary;

    Swift

    import AssetsLibrary

    Доступность

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

Установка новых данных изображения и видеоданных
  • setImageData (_: metadata:completionBlock:) - setImageData:metadata:completionBlock:

    Заменяет данные изображения в получателе с данными данными изображения

    Объявление

    Swift

    func setImageData(_ imageData: NSData!, metadata metadata: [NSObject : AnyObject]!, completionBlock completionBlock: ALAssetsLibraryWriteImageCompletionBlock!)

    Objective C

    - (void)setImageData:(NSData *)imageData metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock

    Параметры

    imageData

    Данные изображения для актива.

    metadata

    Метаданные для изображения.

    completionBlock

    Блок, вызванный после работы сохранения, завершается.

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

    Если приложение не в состоянии отредактировать актив, блоки завершения возвращают a nil актив URL и ALAssetsLibraryWriteFailedError.

    Обсуждение

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

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

    Objective C

    @import AssetsLibrary;

    Swift

    import AssetsLibrary

    Доступность

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

  • setVideoAtPath (_: completionBlock:) - setVideoAtPath:completionBlock:

    Заменяет видеоданные в получателе с видео в данном URL.

    Объявление

    Swift

    func setVideoAtPath(_ videoPathURL: NSURL!, completionBlock completionBlock: ALAssetsLibraryWriteVideoCompletionBlock!)

    Objective C

    - (void)setVideoAtPath:(NSURL *)videoPathURL completionBlock:(ALAssetsLibraryWriteVideoCompletionBlock)completionBlock

    Параметры

    videoPathURL

    URL, указывающий расположение видеоданных.

    completionBlock

    Блок, вызванный после работы сохранения, завершается.

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

    Если приложение не в состоянии отредактировать актив, блоки завершения возвращают a nil актив URL и ALAssetsLibraryWriteFailedError.

    Обсуждение

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

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

    Objective C

    @import AssetsLibrary;

    Swift

    import AssetsLibrary

    Доступность

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

Сохранение к сохраненному фото альбому
  • writeModifiedImageDataToSavedPhotosAlbum (_: metadata:completionBlock:) - writeModifiedImageDataToSavedPhotosAlbum:metadata:completionBlock:

    Сохраняет данные изображения к Сохраненному фото альбому.

    Объявление

    Swift

    func writeModifiedImageDataToSavedPhotosAlbum(_ imageData: NSData!, metadata metadata: [NSObject : AnyObject]!, completionBlock completionBlock: ALAssetsLibraryWriteImageCompletionBlock!)

    Objective C

    - (void)writeModifiedImageDataToSavedPhotosAlbum:(NSData *)imageData metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock

    Параметры

    imageData

    Данные изображения для актива.

    metadata

    Метаданные для изображения.

    completionBlock

    Блок, вызванный после работы сохранения, завершается.

    Обсуждение

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

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

    Objective C

    @import AssetsLibrary;

    Swift

    import AssetsLibrary

    Доступность

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

  • writeModifiedVideoAtPathToSavedPhotosAlbum (_: completionBlock:) - writeModifiedVideoAtPathToSavedPhotosAlbum:completionBlock:

    Сохраняет видео в указанном пути к Сохраненному фото альбому.

    Объявление

    Swift

    func writeModifiedVideoAtPathToSavedPhotosAlbum(_ videoPathURL: NSURL!, completionBlock completionBlock: ALAssetsLibraryWriteVideoCompletionBlock!)

    Objective C

    - (void)writeModifiedVideoAtPathToSavedPhotosAlbum:(NSURL *)videoPathURL completionBlock:(ALAssetsLibraryWriteVideoCompletionBlock)completionBlock

    Параметры

    videoPathURL

    URL, указывающий расположение видеоданных.

    completionBlock

    Блок, вызванный после работы сохранения, завершается.

    Обсуждение

    Этот метод сохраняет видео в videoPathURL к Сохраненному фото альбому как новый актив, который считают измененной версией получателя.

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

    Objective C

    @import AssetsLibrary;

    Swift

    import AssetsLibrary

    Доступность

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

Константы
  • Ключи свойства

    Константы для ключей для свойств можно добраться от актива.

    Объявление

    Swift

    let ALAssetPropertyType: String let ALAssetPropertyLocation: String let ALAssetPropertyDuration: String let ALAssetPropertyOrientation: String let ALAssetPropertyDate: String let ALAssetPropertyRepresentations: String let ALAssetPropertyURLs: String let ALAssetPropertyAssetURL: String

    Objective C

    NSString *const ALAssetPropertyType; NSString *const ALAssetPropertyLocation; NSString *const ALAssetPropertyDuration; NSString *const ALAssetPropertyOrientation; NSString *const ALAssetPropertyDate; NSString *const ALAssetPropertyRepresentations; NSString *const ALAssetPropertyURLs; NSString *const ALAssetPropertyAssetURL;

    Константы

    • ALAssetPropertyType

      Ключ для получения типа актива.

      Возможные значения даны в Типах Актива.

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

    • ALAssetPropertyLocation

      Ключ для получения информации о расположении актива.

      Соответствующее значение является a CLLocation объект. Если службы определения местоположения включены для вызывающей стороны, это только доступно.

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

    • ALAssetPropertyDuration

      Ключ для получения продолжительности времени воспроизведения видео актива.

      Соответствующее значение является двойным, обернутым в NSNumber объект. Для фотографий, ALErrorInvalidProperty возвращается.

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

    • ALAssetPropertyOrientation

      Ключ для получения ориентации актива.

      Соответствующее значение NSNumber объект, содержащий ориентацию актива, как описано форматом TIFF.

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

    • ALAssetPropertyDate

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

      Соответствующее значение NSDate объект.

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

    • ALAssetPropertyRepresentations

      Ключ для получения представлений, доступных для данного актива (например, RAW, JPEG).

      Соответствующее значение NSArray объект, содержащий UTIs, выраженный как строки.

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

    • ALAssetPropertyURLs

      Ключ для получения словаря, отображающего представления актива UTIs на URLs, однозначно определяющий актив.

      Соответствующее значение NSDictionary объект.

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

    • ALAssetPropertyAssetURL

      Ключ для получения идентификатора URL для актива.

      Соответствующее значение NSURL объект.

      Этот URL используется уведомлениями изменения библиотеки для идентификации групп актива и активов. Только ALAssetRepresentation и ALAssetsGroup классы поддерживают это свойство.

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

  • Недопустимое значение свойства

    Константа, чтобы указать, что свойство, к которому получают доступ valueForProperty: недопустимо.

    Объявление

    Swift

    let ALErrorInvalidProperty: String

    Objective C

    NSString *const ALErrorInvalidProperty;

    Константы

    • ALErrorInvalidProperty

      Значение, возвращенное valueForProperty: . если свойство, к которому Вы попытались получить доступ недопустимо,

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

  • Типы актива

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

    Объявление

    Swift

    let ALAssetTypePhoto: String let ALAssetTypeVideo: String let ALAssetTypeUnknown: String

    Objective C

    NSString *const ALAssetTypePhoto; NSString *const ALAssetTypeVideo; NSString *const ALAssetTypeUnknown;

    Константы

    • ALAssetTypePhoto

      Указывает, что актив является фотографией.

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

    • ALAssetTypeVideo

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

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

    • ALAssetTypeUnknown

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

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

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

    Обсуждение

    Эти константы представляют значения, которые можно возвратить для ALAssetPropertyType свойство.