PhotoKit — шта је то, кључни појмови и PHAsset

Шта је PhotoKit?

PhotoKit — Apple фрејмворк (представљен у iOS 8, macOS 10.11), који пружа објектно-оријентисани API за рад са системском медијатеком. За разлику од AssetsLibrary-а, PhotoKit ради са медијатеком као са базом података: упити враћају објекте PHAsset, PHCollection, PHCollectionList, који представљају садржај и структуру складиштења.

PhotoKit подржава све типове медија: фотографије (JPEG, HEIF, RAW), видео записе (MOV, MP4), Live Photos и серијске снимке. Фрејмворк аутоматски управља iCloud синхронизацијом: ако се слика чува у iCloud-у, PhotoKit је захтева преко мреже и пријављује напредак кроз PHImageRequestOptions.progressHandler.

Кључна карактеристика PhotoKit-а — модел података заснован на PHObject-у са локалним идентификатором (localIdentifier), који остаје стабилан између сесија. Ово омогућава чување референци на медијске објекте и њихово обнављање након поновног покретања апликације без поновног упита.

Како ради PhotoKit: модел података и упити

PhotoKit је изграђен на три нивоа: модел података (PHObject), упити (PHFetchResult) и измене (PHPhotoLibrary.performChanges). Модел података је хијерархијски: PHAsset (фотографија/видео) налази се унутар PHAssetCollection (албум), албуми се групишу у PHCollectionList (фасцикла).

Извршавање упита

Упити се извршавају кроз PHAsset.fetchAssets и PHAssetCollection.fetchAssetCollections. Све fetch методе су синхроне и враћају PHFetchResult, чији објекат одмах извршава упит у бази података медијатеке. PHFetchResult подржава брзи приступ по индексу (object(at:)) и набрајање кроз enumerateObjects.

• fetchAssets(with:options:) — упит свих медија са филтрирањем по типу, датуму, албуму
• fetchAssetCollections(with:subtype:options:) — упит албума и фасцикли
• fetchAssets(in:options:) — упит медија унутар одређеног албума

PHFetchOptions

PHFetchOptions — објекат за конфигурацију упита: сортирање (sortDescriptors), предикат (predicate), укључивање скривених и избрисаних медија (includeHiddenAssets, includeAllBurstAssets). Fetch опције омогућавају филтрирање по типу медија: PHAssetMediaType.image, .video, .audio.

Главне класе PhotoKit-а

PhotoKit укључује скуп класа за приступ, упите и измене медијатеке. Разумевање сваке од њих је неопходно за ефикасан рад са фрејмворком.

PHAsset

PHAsset — непроменљиви објекат који представља један медијски садржај. Садржи метаподатке: mediaType, mediaSubtypes, creationDate, location, pixelWidth, pixelHeight, duration (за видео), isFavorite, burstIdentifier. LocalIdentifier — стабилни текстуални кључ, доступан чак и након поновног покретања апликације.

PHAssetCollection

PHAssetCollection — група медија: системски албуми (Recents, Favorites, Selfies, Screenshots), кориснички албуми или Moments (аутоматски груписани по времену и месту). Атрибути: localizedTitle, assetCollectionType, assetCollectionSubtype, startDate, endDate.

PHCollectionList

PHCollectionList — фасцикла која садржи албуме (PHAssetCollection) или друге фасцикле. Ретко се користи, углавном за приказ хијерархије у корисничком интерфејсу.

PHImageManager и кеширање

PhotoKit не враћа UIImage директно из PHAsset-а — потребно је захтевати слику кроз PHImageManager. Ово гарантује да се слика учитава узимајући у обзир iCloud, кеширање и потребну величину.

PHImageManager подржава три режима испоруке: opportunistic (прво смањена верзија, затим пуна), highQualityFormat (само пуни квалитет) и fastFormat (најбржа доступна верзија). За колекције увек користите PHCachingImageManager са предучитавањем слика за видљиве ћелије.

Примери коришћења PhotoKit-а у Swift-у

PhotoKit се користи за креирање прилагођених галерија, уређивача и апликација за рад са медијима. Размотримо три кључна сценарија.

Упит свих фотографија из медијатеке

PHAsset.fetchAssets са PHFetchOptions и сортирањем по датуму креирања — основни упит за изградњу прилагођене фото галерије. PHFetchResult подржава lazy-loading и стримовски приступ.

let options = PHFetchOptions()
options.sortDescriptors = [NSSortDescriptor(
    key: "creationDate",
    ascending: .false
)]
options.predicate = NSPredicate(
    format: "mediaType == %d",
    PHAssetMediaType.image.rawValue
)

let allPhotos = PHAsset.fetchAssets(with: options)
print("Пронађено \(allPhotos.count) фотографија")

allPhotos.enumerateObjects { asset, index, stop in
    print("Фотографија \(index): \(asset.localIdentifier)")
}

PHFetchResult — thread-safe контејнер. Приступ објектима по индексу кроз object(at:) не блокира UI, али захтев слике кроз PHImageManager мора да се изврши асинхроно.

Учитавање слике са кеширањем

PHCachingImageManager — подкласа PHImageManager-а са методама startCachingImages и stopCachingImages за предучитавање. Користи се у UICollectionView-у за глатко скроловање.

let cachingManager = PHCachingImageManager()
let targetSize = CGSize(width: 200, height: 200)

// Предучитавање за видљиве ћелије
cachingManager.startCachingImages(
    for: visibleAssets,
    targetSize: targetSize,
    contentMode: .aspectFill,
    options: nil
)

// Захтев слике кроз PHImageRequestOptions са iCloud fallback-ом
let requestOptions = PHImageRequestOptions()
requestOptions.deliveryMode = .opportunistic
requestOptions.isNetworkAccessAllowed = .true
requestOptions.progressHandler = { progress, error, stop, info in
    DispatchQueue.main.async {
        print("Преузимање са iCloud-а: \(progress * 100)%")
    }
}

let requestID = cachingManager.requestImage(
    for: asset,
    targetSize: targetSize,
    contentMode: .aspectFill,
    options: requestOptions
) { image, info in
    print("Слика примљена: \(image?.size ?? .zero)")
}

Уређивање медијатеке: додавање у омиљене

Измене у медијатеци се врше кроз PHPhotoLibrary.shared().performChanges унутар changeRequest блока. Све операције се групишу и примењују транзакционо.

PHPhotoLibrary.shared().performChanges {
    let changeRequest = PHAssetChangeRequest(for: asset)
    changeRequest.isFavorite = .true
} completionHandler: { success, error in
    if success {
        print("Додато у омиљене")
    }
}

Промене и посматрање кроз Change Tracking

PhotoKit пружа механизам посматрања промена у медијатеци кроз протокол PHPhotoLibraryChangeObserver. При било каквим променама (креирање, брисање, уређивање) позива се метода photoLibraryDidChange са PHChange објектом.

PHChange садржи changeDetails за сваки тип упита: PHFetchResultChangeDetails са removedIndexes, insertedIndexes, changedIndexes. Ово омогућава примену промена у UI-ју са анимацијом: performBatchUpdates са move, insert, delete за UICollectionView.

class PhotosViewController: UIViewController {
    var fetchResult: PHFetchResult>PHAsset>?

    override func viewDidLoad() {
        super.viewDidLoad()
        PHPhotoLibrary.shared().register(self)
    }

    deinit {
        PHPhotoLibrary.shared().unregisterChangeObserver(self)
    }
}

extension PhotosViewController: PHPhotoLibraryChangeObserver {
    func photoLibraryDidChange(_ changeInstance: PHChange) {
        guard let fetchResult,
              let details = changeInstance.changeDetails(for: fetchResult)
        else { return }

        DispatchQueue.main.async {
            self.fetchResult = details.fetchResultAfterChanges
            // Примени измене на collectionView
        }
    }
}

Уређивање RAW-а и проширења

PhotoKit подржава уређивање медија кроз механизам PHContentEditingInput и PHContentEditingOutput. Апликација захтева editingInput са оригиналним подацима, примењује измене и чува резултат кроз editingOutput. Фрејмворк аутоматски чува оригинал, омогућавајући кориснику да врати измене ресетовањем на оригинал.

RAW фотографије (DNG, CR2, NEF) су подржане кроз PHAssetResourceManager, који пружа приступ оригиналној RAW датотеци. За обраду RAW-а препоручује се коришћење CoreImage-а са CIRAWFilter филтером, који подржава подешавање температуре, експозиције и оштрине. PhotoKit такође подржава проширења уређивача кроз Photo Editing Extension (iOS) — апликација може бити позвана из системског уређивача за обраду изабране фотографије или видеа.

Оптимизација рада са PhotoKit-ом

PhotoKit — моћан, али ресурсно захтеван фрејмворк. Неправилна употреба може довести до успорења при скроловању и прекомерне потрошње меморије. Пратите препоруке за оптималне перформансе.

• Користите PHCachingImageManager за колекције — предучитавање слика за видљиве +-1 екран ћелије елиминише кашњења при скроловању
• Поставите targetSize — никада не захтевајте PHImageManagerMaximumSize за минијатуре. Користите величину једнаку физичкој величини ћелије помноженој са scale екрана
• Откажите упите при поновној употреби ћелије — сачувајте PHImageRequestID и позовите cancelImageRequest у prepareForReuse
• Ограничите iCloud упите — при брзом скроловању поставите isNetworkAccessAllowed = false и учитавајте iCloud фотографије само при заустављању
• Кеширајте PHFetchResult — поновљени fetchAssets са истим опцијама враћа нови PHFetchResult. Чувајте резултат у својству и ажурирајте кроз Change Observer

PHLivePhoto — захтева засебан упит кроз PHLivePhoto.request(with:targetSize:contentMode:options:resultHandler:). Не захтевајте Live Photo за ћелије где се приказује само фотографија — користите PHLivePhotoBadge за индикацију.