PHAssetCollection

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

NSObject
PHObject
PHCollection
PHAssetCollection

NSObject
PHObject
PHCollection
PHAssetCollection

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

AnyObject
CVarArgType
Сопоставимый
Hashable
NSCopying
NSObjectProtocol
Печатаемый
NSCopying
NSObject

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

Swift

import Photos

Objective C

@import Photos;

Доступность

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

A PHAssetCollection объект представляет набор фотографии или видео активов. Наборы актива включают моменты и альбомы, видимые в фото приложении, а также специальных наборах, таких как Совместно используемые фото Потоки.

В фото платформе объекты коллекции (включая наборы актива) непосредственно не ссылаются на свои задействованные объекты, и нет никаких других объектов этого непосредственно ссылочные объекты коллекции. Для получения элементов набора актива выберите их с a PHAsset метод класса такой как fetchAssetsInAssetCollection:options:. Для нахождения наборов актива используйте один из методов, перечисленных в Выборке Наборов Актива.

Как активы и списки набора, наборы актива являются неизменными. Для создания переименуйте или удалите наборы актива, или добавить, удалить, или перестроить элементы в наборе актива, создать a PHAssetCollectionChangeRequest объект в фото библиотеке изменяет блок. Для получения дополнительной информации при использовании запросов на изменение и блоков изменения для обновления фото библиотеки посмотрите Ссылку класса PHPhotoLibrary.

Выборка наборов актива


    
    fetchAssetCollectionsWithLocalIdentifiers (_: опции:)
    + fetchAssetCollectionsWithLocalIdentifiers:options:

Получает наборы актива с указанными уникальными идентификаторами.

Объявление

Swift

class func fetchAssetCollectionsWithLocalIdentifiers(_ identifiers: [AnyObject]!, options options: PHFetchOptions!) -> PHFetchResult!

Objective C

+ (PHFetchResult *)fetchAssetCollectionsWithLocalIdentifiers:(NSArray *)identifiers options:(PHFetchOptions *)options

Параметры

`identifiers`	Массив `NSString` объекты, каждый `localIdentifier` строка набора актива.
`options`	Опции, указывающие предикат фильтра и порядок сортировки для выбранных наборов актива, или `nil` использовать опции по умолчанию. Для получения дополнительной информации посмотрите Ссылку класса PHFetchOptions.

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

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

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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


    
    fetchAssetCollectionsWithType (_: subtype:options:)
    + fetchAssetCollectionsWithType:subtype:options:

Получает наборы актива указанного типа и подтипа.

Объявление

Swift

class func fetchAssetCollectionsWithType(_ type: PHAssetCollectionType, subtype subtype: PHAssetCollectionSubtype, options options: PHFetchOptions!) -> PHFetchResult!

Objective C

+ (PHFetchResult *)fetchAssetCollectionsWithType:(PHAssetCollectionType)type subtype:(PHAssetCollectionSubtype)subtype options:(PHFetchOptions *)options

Параметры

`type`	Тип набора актива, такого как альбом или момент. Посмотрите `PHAssetCollectionType`.
`subtype`	Подтип набора актива. Посмотрите `PHAssetCollectionSubtype`.
`options`	Опции, указывающие предикат фильтра и порядок сортировки для выбранных наборов актива, или `nil` использовать опции по умолчанию. Для получения дополнительной информации посмотрите Ссылку класса PHFetchOptions.

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

Обсуждение

По умолчанию, возвращенный PHFetchResult объект содержит все наборы актива с указанным типом и подтипом. Для получения более определенного набора наборов актива обеспечьте a PHFetchOptions объект, содержащий предикат фильтра.

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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


    
    fetchAssetCollectionsContainingAsset (_: withType:options:)
    + fetchAssetCollectionsContainingAsset:withType:options:

Получает наборы актива указанного типа, содержащего указанный актив.

Объявление

Swift

class func fetchAssetCollectionsContainingAsset(_ asset: PHAsset!, withType type: PHAssetCollectionType, options options: PHFetchOptions!) -> PHFetchResult!

Objective C

+ (PHFetchResult *)fetchAssetCollectionsContainingAsset:(PHAsset *)asset withType:(PHAssetCollectionType)type options:(PHFetchOptions *)options

Параметры

`asset`	Фото актив.
`type`	Тип набора актива, такой как альбом или момент. Посмотрите `PHAssetCollectionType`.
`options`	Опции, указывающие предикат фильтра и порядок сортировки для выбранных наборов актива, или `nil` использовать опции по умолчанию. Для получения дополнительной информации посмотрите Ссылку класса PHFetchOptions.

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

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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


    
    fetchAssetCollectionsWithALAssetGroupURLs (_: опции:)
    + fetchAssetCollectionsWithALAssetGroupURLs:options:

Получает наборы актива с помощью URLs, предоставленного платформой Библиотеки Активов.

Объявление

Swift

class func fetchAssetCollectionsWithALAssetGroupURLs(_ assetGroupURLs: [AnyObject]!, options options: PHFetchOptions!) -> PHFetchResult!

Objective C

+ (PHFetchResult *)fetchAssetCollectionsWithALAssetGroupURLs:(NSArray *)assetGroupURLs options:(PHFetchOptions *)options

Параметры

`assetGroupURLs`	Массив `NSURL` объекты, каждый группа актива URL, ранее полученный от `ALAssetsGroup` объект.
`options`	Опции, указывающие предикат фильтра и порядок сортировки для выбранных наборов актива, или `nil` использовать опции по умолчанию. Для получения дополнительной информации посмотрите Ссылку класса PHFetchOptions.

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

Обсуждение

В iOS 8.0 и позже, фото платформа обеспечивает лучшую альтернативу платформе Библиотеки Активов. Используйте этот метод, если Ваше приложение ранее сохранило URLs от ALAssetsGroup объекты и Вы должны получить соответствующие фото объекты платформы.

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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


    
    fetchMomentsInMomentList (_: опции:)
    + fetchMomentsInMomentList:options:

Получает наборы актива в указанном наборе списка момента.

Объявление

Swift

class func fetchMomentsInMomentList(_ momentList: PHCollectionList!, options options: PHFetchOptions!) -> PHFetchResult!

Objective C

+ (PHFetchResult *)fetchMomentsInMomentList:(PHCollectionList *)momentList options:(PHFetchOptions *)options

Параметры

`momentList`	Список набора, тип которого `PHCollectionListTypeMomentList`.
`options`	Опции, указывающие предикат фильтра и порядок сортировки для выбранных наборов актива, или `nil` использовать опции по умолчанию. Для получения дополнительной информации посмотрите Ссылку класса PHFetchOptions.

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

Обсуждение

Фото приложение автоматически создает моменты для группировки активов ко времени и расположению, и также создает списки момента для группировки связанных моментов. Списки момента имеют два подтипа: кластер момента группы несколько связанных моментов и год момента группы все моменты в календарный год.

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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


    
    fetchMomentsWithOptions (_:)
    + fetchMomentsWithOptions:

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

Объявление

Swift

class func fetchMomentsWithOptions(_ options: PHFetchOptions!) -> PHFetchResult!

Objective C

+ (PHFetchResult *)fetchMomentsWithOptions:(PHFetchOptions *)options

Параметры


      options

Опции, указывающие предикат фильтра и порядок сортировки для выбранных наборов актива, или nil использовать опции по умолчанию. Для получения дополнительной информации посмотрите Ссылку класса PHFetchOptions.

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

Обсуждение

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

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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

Чтение метаданных набора актива

assetCollectionType Свойство

Тип набора актива, такого как альбом или момент. (только для чтения)

Объявление

Swift

var assetCollectionType: PHAssetCollectionType { get }

Objective C

@property(nonatomic, assign, readonly) PHAssetCollectionType assetCollectionType

Обсуждение

Посмотрите PHAssetCollectionType для возможных значений.

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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

Подтип набора актива. (только для чтения)

Объявление

Swift

var assetCollectionSubtype: PHAssetCollectionSubtype { get }

Objective C

@property(nonatomic, assign, readonly) PHAssetCollectionSubtype assetCollectionSubtype

Обсуждение

Используйте подтипы для создания незначительных различий между наборами того же типа. Для альбомов, например, Вы могли бы отличить создаваемые пользователями альбомы от синхронизировавших от iPhoto. Посмотрите PHAssetCollectionSubtype для возможных значений.

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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

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

Объявление

Swift

var estimatedAssetCount: Int { get }

Objective C

@property(nonatomic, assign, readonly) NSUInteger estimatedAssetCount

Обсуждение

Это количество может не соответствовать текущее число активов в наборе. Для получения нового количества выберите активы набора с fetchAssetsInAssetCollection:options: метод и читал count свойство результата выборки.

Если информация о количестве актива не доступна для набора, значение этого свойства NSNotFound.

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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

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

Объявление

Swift

var startDate: NSDate! { get }

Objective C

@property(nonatomic, strong, readonly) NSDate *startDate

Обсуждение

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

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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

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

Объявление

Swift

var endDate: NSDate! { get }

Objective C

@property(nonatomic, strong, readonly) NSDate *endDate

Обсуждение

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

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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

Расположение, представляющее те из всех активов в наборе. (только для чтения)

Объявление

Swift

var approximateLocation: CLLocation! { get }

Objective C

@property(nonatomic, strong, readonly) CLLocation *approximateLocation

Обсуждение

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

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

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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

Имена расположений, сгруппированных набором (массив NSString объекты). (только для чтения)

Объявление

Swift

var localizedLocationNames: [AnyObject]! { get }

Objective C

@property(nonatomic, strong, readonly) NSArray *localizedLocationNames

Обсуждение

Это свойство применяется только к наборам актива, тип которых PHAssetCollectionTypeMoment. Фото приложение автоматически создает моменты для группировки активов ко времени и расположению. Момент мог бы сгруппировать активы, полученные в многократных расположениях, таким образом, этот массив может содержать многократные имена. Для других типов набора актива значение этого свойства nil.

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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

Создание временных наборов актива


    
    transientAssetCollectionWithAssets (_: заголовок:)
    + transientAssetCollectionWithAssets:title:

Создает временный набор актива, содержащий указанные активы.

Объявление

Swift

class func transientAssetCollectionWithAssets(_ assets: [AnyObject]!, title title: String!) -> PHAssetCollection!

Objective C

+ (PHAssetCollection *)transientAssetCollectionWithAssets:(NSArray *)assets title:(NSString *)title

Параметры

`assets`	Массив `PHAsset` объекты.
`title`	Имя для нового временного набора актива.

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

Новый набор актива.

Обсуждение

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

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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


    
    transientAssetCollectionWithAssetFetchResult (_: заголовок:)
    + transientAssetCollectionWithAssetFetchResult:title:

Создает временный набор актива, содержащий активы от указанного результата выборки.

Объявление

Swift

class func transientAssetCollectionWithAssetFetchResult(_ fetchResult: PHFetchResult!, title title: String!) -> PHAssetCollection!

Objective C

+ (PHAssetCollection *)transientAssetCollectionWithAssetFetchResult:(PHFetchResult *)fetchResult title:(NSString *)title

Параметры

`fetchResult`	Результат выборки, содержащий один или больше `PHAsset` объекты.
`title`	Имя для нового временного набора актива.

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

Новый набор актива.

Обсуждение

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

Objective C

@import Photos;

Swift

import Photos

Доступность

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

Константы

PHAssetCollectionType
Главные различия между видами наборов актива, используемых assetCollectionType свойство и fetchAssetCollectionsContainingAsset:withType:options: и fetchAssetCollectionsWithType:subtype:options: методы.

Объявление

Swift

enum PHAssetCollectionType : Int { case Album case SmartAlbum case Moment }

Objective C

typedef enum : NSInteger { PHAssetCollectionTypeAlbum = 1, PHAssetCollectionTypeSmartAlbum = 2, PHAssetCollectionTypeMoment = 3, } PHAssetCollectionType;

Константы
- Album
  
  PHAssetCollectionTypeAlbum
  
  Альбом в фото приложении.
  
  Альбомы могут быть созданы в фото приложении или появиться на устройстве на iOS через синхронизацию iTunes.
  
  Доступный в iOS 8.0 и позже.
- SmartAlbum
  
  PHAssetCollectionTypeSmartAlbum
  
  Умный альбом, содержание которого обновляет динамично.
  
  Встроенные умные альбомы отображений приложения фотографий для группировки определенных видов связанных активов (см. Asset Collection Subtypes).
  
  Доступный в iOS 8.0 и позже.
- Moment
  
  PHAssetCollectionTypeMoment
  
  Момент в фото приложении.
  
  Фото приложение автоматически создает моменты для группировки активов ко времени и расположению.
  
  Доступный в iOS 8.0 и позже.
Оператор импорта

Objective C

@import Photos;

Swift

import Photos

Доступность

Доступный в iOS 8.0 и позже.
PHAssetCollectionSubtype
Незначительные различия между видами наборов актива, используемых assetCollectionSubtype свойство и fetchAssetCollectionsWithType:subtype:options: метод.

Объявление

Swift

enum PHAssetCollectionSubtype : Int { case AlbumRegular case AlbumSyncedEvent case AlbumSyncedFaces case AlbumSyncedAlbum case AlbumImported case AlbumMyPhotoStream case AlbumCloudShared case SmartAlbumGeneric case SmartAlbumPanoramas case SmartAlbumVideos case SmartAlbumFavorites case SmartAlbumTimelapses case SmartAlbumAllHidden case SmartAlbumRecentlyAdded case SmartAlbumBursts case SmartAlbumSlomoVideos case SmartAlbumUserLibrary case Any }

Objective C

typedef enum : NSInteger { PHAssetCollectionSubtypeAlbumRegular = 2, PHAssetCollectionSubtypeAlbumSyncedEvent = 3, PHAssetCollectionSubtypeAlbumSyncedFaces = 4, PHAssetCollectionSubtypeAlbumSyncedAlbum = 5, PHAssetCollectionSubtypeAlbumImported = 6, PHAssetCollectionSubtypeAlbumCloudShared = 101, PHAssetCollectionSubtypeSmartAlbumGeneric = 200, PHAssetCollectionSubtypeSmartAlbumPanoramas = 201, PHAssetCollectionSubtypeSmartAlbumVideos = 202, PHAssetCollectionSubtypeSmartAlbumFavorites = 203, PHAssetCollectionSubtypeSmartAlbumTimelapses = 204, PHAssetCollectionSubtypeSmartAlbumAllHidden = 205, PHAssetCollectionSubtypeSmartAlbumRecentlyAdded = 206, PHAssetCollectionSubtypeSmartAlbumBursts = 207, PHAssetCollectionSubtypeSmartAlbumSlomoVideos = 208, PHAssetCollectionSubtypeAny = NSIntegerMax } PHAssetCollectionSubtype;

Константы
- AlbumRegular
  
  PHAssetCollectionSubtypeAlbumRegular
  
  Альбом создается в фото приложении.
  
  Доступный в iOS 8.0 и позже.
- AlbumSyncedEvent
  
  PHAssetCollectionSubtypeAlbumSyncedEvent
  
  Событие, синхронизировавшее к устройству от iPhoto.
  
  Доступный в iOS 8.0 и позже.
- AlbumSyncedFaces
  
  PHAssetCollectionSubtypeAlbumSyncedFaces
  
  Группа Поверхностей синхронизировала к устройству от iPhoto.
  
  Доступный в iOS 8.0 и позже.
- AlbumSyncedAlbum
  
  PHAssetCollectionSubtypeAlbumSyncedAlbum
  
  Альбом, синхронизировавший к устройству от iPhoto.
  
  Доступный в iOS 8.0 и позже.
- AlbumImported
  
  PHAssetCollectionSubtypeAlbumImported
  
  Альбом, импортированный из камеры или внешнего хранения.
  
  Доступный в iOS 8.0 и позже.
- AlbumMyPhotoStream
  
  PHAssetCollectionSubtypeAlbumMyPhotoStream
  
  Персональный фото Поток iCloud пользователя.
  
  Доступный в iOS 8.0 и позже.
- AlbumCloudShared
  
  PHAssetCollectionSubtypeAlbumCloudShared
  
  ICloud Совместно используемый фото Поток.
  
  Доступный в iOS 8.0 и позже.
- SmartAlbumGeneric
  
  PHAssetCollectionSubtypeSmartAlbumGeneric
  
  Умный альбом никакого более определенного подтипа.
  
  Этот подтип применяется к умным альбомам, синхронизировавшим к устройству от iPhoto.
  
  Доступный в iOS 8.0 и позже.
- SmartAlbumPanoramas
  
  PHAssetCollectionSubtypeSmartAlbumPanoramas
  
  Умный альбом, что группы все фотографии обзора в фото библиотеке.
  
  Доступный в iOS 8.0 и позже.
- SmartAlbumVideos
  
  PHAssetCollectionSubtypeSmartAlbumVideos
  
  Умный альбом, что группы все видео активы в фото библиотеке.
  
  Доступный в iOS 8.0 и позже.
- SmartAlbumFavorites
  
  PHAssetCollectionSubtypeSmartAlbumFavorites
  
  Умный альбом, что группы все активы, которые пользователь отметил как избранное.
  
  Любимые активы пользователя - те чей favorite свойство YEStrue. Вы отмечаете актив как фаворита путем установки favorite свойство a PHAssetChangeRequest объект.
  
  Доступный в iOS 8.0 и позже.
- SmartAlbumTimelapses
  
  PHAssetCollectionSubtypeSmartAlbumTimelapses
  
  Умный альбом, что группы все видео промежутка времени в фото библиотеке.
  
  Доступный в iOS 8.0 и позже.
- SmartAlbumAllHidden
  
  PHAssetCollectionSubtypeSmartAlbumAllHidden
  
  Умный альбом, что группы все активы, скрытые от представления Moments в фото приложении.
  
  Скрытые активы имеют a hidden значение YEStrue и не появляйтесь в наборах момента. Вы скрываетесь (или покажите), актив путем установки hidden свойство a PHAssetChangeRequest объект.
  
  Доступный в iOS 8.0 и позже.
- SmartAlbumRecentlyAdded
  
  PHAssetCollectionSubtypeSmartAlbumRecentlyAdded
  
  Умный альбом, что активы групп, недавно добавленные к фото библиотеке.
  
  Доступный в iOS 8.0 и позже.
- SmartAlbumBursts
  
  PHAssetCollectionSubtypeSmartAlbumBursts
  
  Умный альбом, который группы вся пакетная фотография упорядочивают в фото библиотеке.
  
  Доступный в iOS 8.0 и позже.
- SmartAlbumSlomoVideos
  
  PHAssetCollectionSubtypeSmartAlbumSlomoVideos
  
  Умный альбом, что группы все Медленные-Mo видео в фото библиотеке.
  
  Доступный в iOS 8.0 и позже.
- Any
  
  PHAssetCollectionSubtypeAny
  
  Немного маски, представляющей все возможные подтипы.
  
  Когда выбирающие наборы актива, используйте это значение для выборки наборов любого подтипа.
  
  Доступный в iOS 8.0 и позже.
Оператор импорта

Objective C

@import Photos;

Swift

import Photos

Доступность

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