[Swift] PhotoKit 라이브러리 사용하기

생각했던 것 보다 훨씬 방대한 내용이라 정리가 필요해 보여서 포스팅 해봅니다. 

클래스, Privacy, 이미지 가져오기 순으로 살펴 볼 까 합니다.

---

컨텐츠 목록

---

클래스 알아보기

Privacy 갤러리 접근 사용자 권한 (아직 작성중)

썸네일 이미지 가져오기

원본 이미지 가져오기

 

---

클래스 알아보기

PHAsset : PHObject

포토 라이브러리에서 하나의 이미지나 비디오, 라이브 포토를 표현한다. 에셋은 이미지나 비디오에 대한 메타 데이터를 포함한다. 

static 메소드인 fecthAssets은 PHFetchResult를 반환한다.

메타데이터를 사용하는 이유는 이미지 자체를 불러오려면 아주 많은 메모리와 자원이 필요하다. 따라서 경우에 따라 많은 이미지를 불러오면 크래쉬 되는 일이 발생 할 수 있다. 

여기에는 실제 이미지를 반환 받을 수 있는 정보도 포함된다. 이미지를 반환 받으려 할 때 PHImageManager가 필요하다. 

 

PHImageManager

구체적인 이미지와 비디오를 PHAsset 인스턴스로부터 접근할 수 있다. 

PHCachingImageManager는 이미지 캐싱에 대한 레버러지를 이용할 수 있다. 

developer.apple.com/documentation/photokit/phimagemanager?language=objc

PHFetchResult

fetch 리퀘스트로 부터 PHAsses을 콜렉션으로 담고 있다. 

 

PHFetchOptions

어떤 에셋을 생성하고 필터링 할 것인지에 대해 선택하거나 바꿀 수 있다.

 

PHPhotoLibrary

정보를 요청하고 갤러리를 바꿀 수 있다. 또한 메소드를 사용해서 갤러리에 접근할 수 있는 사용자 권한을 줬는지 확인할 수 있다. 

requestAuthorization

 

PHImageRequestOptions

포토 에셋으로 표현되는 스틸 이미지 전송에 영향을 미치는 옵션 집합니다. image manager 로 부터 요청하여 사용할 수 있다.

이미지의 퀄리티를 deliveryMode로 지정할 수 있다. PHImageRequestOptionsDeliveryMode enum을 포함하고 있다. 이미지 데이터 요청에 대한 옵션을 지정할 수 있는데 여기에 deliveryMode 프로퍼티가 사용된다. 

 

.opportunistic

여러장의 사진이 자동적으로 밸런스와 퀄리티,  반응성 있는 한개 이상의 결과를 제공한다.

 

.highQualityFormat

여러장의 사진은 오직 고화질의 이미지 제공만이 가능. 다만 이 기능은 얼마간에 시간이 걸리든 상관쓰지 않는다.

 

.fastFormat

여러장의 사진은 오직 빠른 속도의 로딩 이미지를 제공한다. 이미지의 퀄리티가 저하될 수 있다.

 

 

--> 추가 : 비디오 관련

AVAsset

비디오를 필요로하거나 수정하기 위해서 에셋을 사용할 수 있다. 

 

AVPlayerItem

플레이백(?)을 위한 기능 구현이 필요한 경우 사용

developer.apple.com/documentation/avfoundation/avplayeritem

---

사용자 갤러리에 접근하기 위한 Privacy

 

---

어떻게 이미지를 가져 올 수 있을까?

PHAsset은 메모리를 좀 더 효율적으로 관리하기 위해 대량의 정보를 가지고 있는 이미지를 그대로 가져 오지 않고 이미지에 대한 정보를 가지고 있는 메타 데이터를 PHFetchResult 콜렉션에 PHAsset으로 담을 수 있다. 따라서 이미지 자체가 아니므로 이 메타 데이터를 사용해서 이미지를 가지고 와야 한다. 이때 PHImageManager를 사용하여 이미지를 반환 받을 수 있다. 

requestImage(for:targetSize:contentMode:options:resultHandler:)

 

asset

PHAsset.fetchAssets(with: nil) 등을 통해 반환 받은 PHFetchResult 콜렉션에 있는 PHAsset 중 로드해야 하는 이미지 데이터를 선택해 줍니다. PHFetchResult<PHAsset> 에서 필요로 하는 이미지 데이터를 얻기 위해 인덱스로 접근할 수 있습니다. 

 

targetSize

반환 받을 이미지의 크기를 나타냅니다.

 

contentMode

리퀘스트한 이미지 사이즈가 어떤 모드로 보여야 할 지 설정해 줍니다. PHImageContentMode에는 aspectFit, aspectFill이 있고 aspectFit이 default로 설정되어 있습니다. aspectFit은 이미지 사이즈에 맞춰서 잘리지 않게 배치되고 aspectFill은 이미지가 잘리더라도 화면에 꽉 채워지게 됩니다.

그런데 말입니다,,, 🧐🧐

왼쪽이 aspectFill 오른쪽이 aspectFit

예상한 것과 달리 바뀐게 없어서 뚫어져라 봤는데 화질이 달라집니다. (정확히 아시는 분의 제보를 기다립니다..예..)

.aspectFit은 이미지를 지정한 타겟의 사이즈에 맞도록 줄이게 되고 .aspectFill은 타겟 사이즈에 완전하게 채우는 방식으로 스케일을 줄이게 됩니다. 

 

scaleAspectFit

예상했던 aspectFit은 위 사진과 같은데 조금 다르게 작동하나 봅니다. 우선 scaleAspectFit을 사용하고 싶다면 이미지 뷰 자체의 contentMode로 지정해 주시면 위와 같은 결과를 얻을 수 있습니다;; 

 

resultHandler

func requestImage(for asset: PHAsset, 
       targetSize: CGSize, 
      contentMode: PHImageContentMode, 
          options: PHImageRequestOptions?, 
    resultHandler: @escaping (UIImage?, [AnyHashable : Any]?) -> Void) -> PHImageRequestID

resultHandler를 통해 반환되는 첫번째 인자 UIImage에 이미지를 사용하면 됩니다. 사이즈와 옵션, 컨텐츠 모드를 지정하고 해당 조건을 만족하는 이미지를 얻을 수 있습니다.

---

원본 이미지가 필요한 경우

이쯤에서 생기는 의문! 이미지 사이즈를 셀의 사이즈 대로 지정해 주기 때문에 원본 사이즈 보다 더 작거나 큰 사이즈를 가지고 있습니다 (대부분 더 작은 사이즈). 이미지의 사이즈는 스케일 대로 변경되어 있고 원본의 화질이 아니기 때문에 원본의 이미지가 필요하거나 저장해야 하는 경우 targetSize로 지정하여 얻어온 이미지를 그대로 사용할 수가 없습니다. 

 

위에서 PHImageRequestOptions를 봅시다. 여기에 deliveryMode를 지정하여 고퀄리티의 사진을 가져 올 수 있습니다. 그러나 적혀 있듯이 다른 문제가 발생합니다. 퀄리티가 높은 사진을 가져오기 때문에 시간이 고려되지 않으며 오래 걸립니다. 사진 로드하는 시간이 길고 사진을 로드하는데 많은 메모리 자원을 사용하기 때문에 움직임도 자연스럽지 않게 됩니다. 

 

갤러리 자체에다가 보여지는 이미지는 썸네일 이미지를 활용해서 빨리 로드하는 것이 더 효율적이며 이미지가 필요한 경우 해당 에셋을 사용해서 필요한 이미지만 고퀄리티로 받는게 좋습니다. 

 

        let requestImageOption = PHImageRequestOptions()
        requestImageOption.deliveryMode = PHImageRequestOptionsDeliveryMode.highQualityFormat

원본 사진의 고퀄리티 사진을 가져오기 위해 deliveryMode를 highqualityFormat 으로 지정해 줍니다. 

 

requestImageOption.deliveryMode = PHImageRequestOptionsDeliveryMode.highQualityFormat 는 물론

requestImageOption.deliveryMode = .highQualityFormat이렇게 작성할 수 있습니다 (스위프트 좋다. 너무 🤗)

let imageManager = PHImageManager()
imageManager.requestImage(for: asset, 
                          targetSize: PHImageManagerMaximumSize, 
                          contentMode: PHImageContentMode.default, 
                          options: requestImageOption) { (image, info) in

}

옵션을 위와 같이 지정해 줍니다. 여기서 contentMode 는 default로 지정되어 있으나 필요한 모드를 선택해 줍니다. 

PHImageManagerMaximumSize는 PHImageManager의 전역 변수로서 원본 이미지 데이터의 리퀘스트나 가장 최대로 렌더링 된 이미지가 가능하게 해줍니다. 

---

참고 사이트

 

How to get Original Image and media type from PHAsset?

Swiftly over the PhotoKit (1)

이상하거나 잘못된 내용이 있을시 댓글 부탁드립니다