PhotoKit 그리고 Photos의 클래스들

PhotoKit 그리고 Photos의 클래스들

https://zeddios.tistory.com/614 과 그 시리즈들

Assets, Collections of Assets, List of Collections

공통점 : read-only, immutable, 메타데이터만 포함

• Assets : 사진, 비디오, 라이브 포토
• Collections of Assets : 앨범 또는 Moments
• List of Collections : 앨범 폴더 또는 Moment 클러스터

PhotoKit

: Photos 프레임워크와 PhotosUI 프레임워크를 가지고 있는 프레임워크.

사진 앱에서 사용자에게 표시되는 객체를 모델링하는 엔티티 그래프를 정의한다 - lightweight, immutable

• 사진 앱의 사진들, 비디오들, 앨범에 접근해 해당 assets를 가져올 수 있게 해준다.
• 사진 앱의 사진 편집 확장 기능 지원
• 표시 및 재생을 위해, 사진 앱의 사진 및 동영상 assets에 직접 접근 및 캐싱 가능

PHObject

: Photo 모델 객체 (assets와 collections)의 상위 추상 클래스.

모든 PhotoKit 객체는 PHObject라는 기본 클래스에서 상속된다.

• 이 클래스 인스턴스를 직접 만들거나 사용해서는 안 된다. 구체적인 하위클래스인 PHAsset, PHAssetCollection, PHCollectionList, PHObjectPlaceHolder의 인스턴스로 작업해야 한다.
• isEqual(_:) 및 해시 메서드
  • localIdentifier 프로퍼티에 따라 구현
  • asset 및 collection 객체를 추적할 수 있음

PHAsset : PHObject

: Photo Library에 있는 이미지, 비디오, 라이브 포토에 대한 표상.

사용자의 사진 라이브러리에 있는 "하나"의 asset(이미지/비디오/라이브 포토)을 나타내며, 해당 asset의 메타데이터를 제공한다.

• PHObject의 하위 클래스
• Asset를 가져와 작업을 시작할 수 있다 - 클래스 메서드 또는 PHAsset인스턴스를 가져온다.
• Asset은 metadata만 포함한다.
• Photos 프레임워크는 각 asset의 썸네일을 다운로드할 수 있다 - PHImageManager 참고
• Asset 객체는 immutable하다 - Asset의 메타데이터를 편집하려면, PHAssetChangeRequest(변경 요청 객체) 객체를 만들어 그 요청대로 업데이트해야 한다. - PHPhotoLibrary 참고
• fetch 메서드들로 사진 앱의 이미지들을 불러올 수 있다.
  • PHAsset.fetchAssets() : 모든 사진의 메타데이터 정보를 불러옴

PHCollection

: Photo Asset Collection과 Collection List를 위한 상위 추상클래스.

• PHObject와 같이, PHCollection의 인스턴스를 직접 만들거나 직접 작업해서는 안 된다.
  • 대신 PHAssetCollection 이나 PHCollectionList라는 하위 리스트 중 하나를 사용해야 한다.

‼️ 사진 라이브러리에 접근/수정하려면 사용자의 명시적인 승인이 필요하다. Fetching Collections 의 메서드 중 하나를 호출하면 사진 앱이 자동으로 사용자에게 승인 요청 메시지를 표시한다. (또는 PHPhotoLibrary.requestAuthorization(_:) 메서드로 원하는 시간에 사용자에게 메시지를 보낼 수 있다.)

앱의 info.plist 파일에서, 앱이 사진 접근을 요청하는 이유를 사용자에게 설명하는 NSPhotoLibraryUsageDescription 값을 제공해야 한다. 그렇지 않으면 iOS 10.0+ 에 연결된 앱이 중단된다

PHAssetCollection : PHCollection

: 사용자 제작 앨범, 스마트 앨범, Moment와 같은 Photo Asset 그룹의 표상.

(사진 또는 비디오 Asset의 collection)

PHAsset의 Collection이며, PHCollection의 하위 클래스이다.

• 하나의 Asset Collection은 사진 라이브러리의 앨범이나, moment이나, 스마트 앨범 중 하나이다.
• asset collections의 멤버를 검색하려면 fetchAssets (: options :)와 같은 PHAsset클래스 메소드를 사용한다.
• asset collections을 찾으려면 Fetching Asset Collections에 나열된 메소드 중 하나를 사용해야 한다.
• PHAsset과 마찬가지로 PHAssetCollection도 immutable 하다 - PHAssetCollectionChangeRequest객체를 만들어 생성/변경/삭제 요청을 해야 한다.
  • 자세한 내용은 PHPhotoLibrary 참고.

PHCollectionList : PHCollection

: Photo Asset Collection을 담고 있는 그룹.

• PHAssetCollection의 모음이라고 보면 된다.
• 역시 immutable 하므로 생성/변경/삭제 작업을 위해서는 PHCollectionListChangeRequest객체를 만들어야 한다.
  • 자세한 내용은 PHPhotoLibrary를 참고.

PHPhotoLibrary : NSObject

: 사용자의 공유 사진 라이브러리(shared photo library)에 대한 접근 및 변경을 관리하는 공유 객체(shared object).

• shared PHPhotoLibrary 객체는 사진 앱에서 관리하는 전체 Asset 및 Collection 집합을 나타낸다.
• 이 객체는 다음 작업에 사용된다:
  • 앱이 사진 컨텐츠에 접근할 수 있는 사용자 권한을 검색 또는 확인
  • Asset 및 Collection을 변경함 - asset 메타테이터 또는 컨텐츠 편집, 새 asset 삽입, collection 요소 재배치...
  • 라이브러리 변경될 때 시스템이 보내는 업데이트 메시지 등록

PHFetchResult : NSObject

: Photos fetch 메서드에 의해 반환된 Assets 또는 Collections의 정렬된 리스트.

사진 앱에서 사진 또는 앨범을 가져오면(fetch), 그 결과물들이 PHFetchResult에 담긴다.

• 업데이트된 컨텐츠를 가져오려면, shared PHPhotoLibrary 객체에 change observer를 등록해야 한다.

PHAsset, PHCollection, PHAssetCollection, PHCollectionList 등의 클래스 메서드를 사용해 객체를 검색하면, Photos는 결과 객체를 fetch의 결과로 제공합니다. Fetch Result의 내용은 NSArray와 같은 메서드 및 컨벤션을 사용해 접근한다.

PHFetchResult 객체는 필요에 따라 Photos 라이브러리에서 내용을 동적으로 로드하므로, 많은 수의 결과를 처리할 때도 최적의 성능을 제공한다.

Fetch result는 내용에 대한 thread-safe한 접근을 제공한다. fetch 후에 fetch count는 일정하며, fetch result의 모든 객체는 동일한 localIdentifier를 유지한다.

Fetch result는 컨텐츠를 캐시하고, 객체 한 묶음(batch)을 가장 최근에 액세스한 인덱스 주위에 유지한다. batch 외부의 객체는 더 이상 캐시되지 않으며, 접근하면 해당 객체를 다시 가져온다. 이 때 해당 객체에서 이전에 읽은 값이 변경될 수 있다.

PHFetchOptions : NSObject

: Asset나 collection 객체를 fetch할 때 Photos가 반환하는 결과(result)의 필터링, 정렬, 관리에 영향을 주는 옵션의 집합.

• PHAsset, PHCollection, PHAssetCollection 및 PHCollectionList 클래스에서 클래스 메서드를 사용하여 assets 또는 collection을 fetch하면, 요청한 객체가 포함된 PHFetchResult객체가 생성됩니다. 지정한 옵션에 따라 fetch result에 포함된 객체, 정렬방법, fetch result의 변경사항을 앱에 알리는 방법을 제어 할 수 있습니다.
• Photos는 제한된 key set을 제공하며, 클래스에 따라 사용 가능한 key set가 다르다 - 공식문서 참고.
  • https://developer.apple.com/documentation/photokit/phfetchoptions/

---

PHAsset은 그 자체로 이미지를 갖는 게 아닌 메타데이터일 뿐이므로, Image Manager에게 PHAsset과 파라미터를 넘겨 실제 이미지를 요청해야 한다.

Image Manager는 PHImageManager, PHCachingImageManger의 2 종류가 있다.

PHImageManager : NSObject

: 미리보기 썸네일과 Asset 데이터 검색 및 생성을 용이하게 해 주는 객체.

기능

• full-size 사진 Asset,
• 썸네일 이미지,
• 비디오 Asset을 재생/전송하기 위한 AVFoundation 객체 를 가져오기 위해 사용 가능한 메서드를 제공.

사용법

사진 / 비디오 데이터를 가져오려면

1. PHAsset 클래스로 관심 있는 Asset 가져오기
2. default() 호출해 shared image manager 객체 검색
3. Asset의 사진/비디오 데이터 로드를 위해, Requesting Images 및 Requesting Video Objects의 메서드 중 하나를 사용하기

• PHImageManager는 제공하는 asset 이미지와 데이터를 캐시한다.
  • 유사한 매개변수를 사용하는 동일 asset에 대해 다시 요청하면 결과를 더 빨리 반환함
• 여러 asset의 이미지 데이터를 함께 로드해야 하는 경우, PHCachingImageManager를 사용해 필요한 이미지를 로드하여 캐시를 준비해라.

PHCachingImageManager : PHImageManager

: 미리보기 썸네일의 검색 또는 생성을 용이하게 하며, 많은 수의 Asset을 사전에 일괄 로드하는 데 최적화되어 있는 객체.

• 많은 Asset 작업을 할 때의 빠른 성능을 위해, 추후 개별 이미지를 요청할 때 지연되지 않게 하기 위해 asset image를 백그라운드에서 준비할 수 있다.
  • 예를 들어 사진/비디오 asset의 썸네일로 collectionView 등의 UI를 채우기 위해 사용 가능.
• PHCachingImageManager의 주요 기능은, 대부분 상위 클래스인 PHImageManager에 의해 정의되어 있다.

사용법

1. PHCachingImageManager인스턴스를 만듭니다.
2. PHAsset클래스 메소드를 사용하여 관심있는 asset을 가져옵니다.
3. asset에 대한 이미지를 준비하려면, 추후 개별 asset에 대한 이미지를 요청 할 때 사용 할 target size, content mode 및 옵션과 함께startCachingImages(for:targetSize:contentMode:options:)메소드를 호출하세요.
4. 개별 asset에 대한 이미지가 필요한 경우 requestImage(for:targetSize:contentMode:options:resultHandler:) 메서드를 호출하고, 해당 asset을 준비할 때 사용한 것과 동일한 매개변수를 전달합니다.
5. 요청한 이미지가 이미 준비된 이미지 중 하나인 경우, PHCachingImageManager객체는 해당 이미지를 즉시 반환합니다. 그렇지 않으면 Photos가 필요에 따라 이미지를 준비하고, 나중에 사용하기 위해 캐싱합니다.

이외에 startCachingImages, stopCachingImages 등의 메서드도 제공한다.

---

예제 코드

:

import Photos
import UIKit

class PhotoManager: NSObject {
    enum NotificationNames {
        static let didChangePhotos = Notification.Name("PhotoManagerDidChangePhotos")
    }

    private var photos: PHFetchResult<PHAsset>

    var count: Int {
        return self.photos.count
    }

    override init() {
        self.photos = PHAsset.fetchAssets(with: .image, options: nil)
        super.init()

        switch PHPhotoLibrary.authorizationStatus() {
            case .authorized:
                PHPhotoLibrary.shared().register(self)
            default:
                return
        }
    }

    func makePhotoData(index: Int, size: CGSize) -> UIImage? {
        let asset = self.photos.object(at: index)
        var photo: UIImage?

        PHCachingImageManager().requestImage(for: asset, targetSize: size, contentMode: .aspectFit, options: nil) { (image, _) in
            photo = image
        }
        return photo
    }
}

extension PhotoManager: PHPhotoLibraryChangeObserver {
    func photoLibraryDidChange(_ changeInstance: PHChange) {

        let previousPhotos = self.photos
        let changedPhotos = changeInstance.changeDetails(for: previousPhotos)
        self.photos = changedPhotos?.fetchResultAfterChanges ?? previousPhotos

        NotificationCenter.default.post(name: NotificationNames.didChangePhotos, object: self)
    }
}