如何使用PHPicker在iOS系統(tǒng)無(wú)授權(quán)下獲取資源

作者：狐友靳凱 2023-10-26 08:57:24

在本篇文章中，我將詳細(xì)介紹如何正確使用PHPicker以及何時(shí)應(yīng)該使用PHPicker。我撰寫(xiě)這篇文章的原因是：在嘗試使用PHPicker訪(fǎng)問(wèn)資源庫(kù)時(shí)遇到了一些問(wèn)題。互聯(lián)網(wǎng)上的許多文章提供的方法都是錯(cuò)誤的，從而導(dǎo)致了對(duì)PHPicker和iOS權(quán)限的一些核心問(wèn)題的誤解。

自iOS14系統(tǒng)開(kāi)始，蘋(píng)果加強(qiáng)了用戶(hù)隱私和安全功能。新增了“Limited Photo Library Access”模式，同時(shí)在授權(quán)彈窗中增加了“Select Photo”選項(xiàng)。這意味著用戶(hù)可以在應(yīng)用程序請(qǐng)求訪(fǎng)問(wèn)相冊(cè)時(shí)選擇部分照片供應(yīng)用程序讀取。從應(yīng)用程序的角度來(lái)看，它只能訪(fǎng)問(wèn)到用戶(hù)選擇的這幾張照片，無(wú)法得知其他照片的存在。然而，并非所有普通用戶(hù)都能夠正確理解這一機(jī)制，實(shí)際用戶(hù)反饋中也反映出了一些誤解。蘋(píng)果推薦使用新的PHPicke來(lái)解決這個(gè)問(wèn)題。

01PHPicker是什么？

從iOS14開(kāi)始，PHPicker是系統(tǒng)提供的Picker ，它允許你從用戶(hù)的照片庫(kù)中訪(fǎng)問(wèn)照片和視頻。新的PHPicker類(lèi)不是在UIKit框架中的，而是位于PhotosUI框架中，包括：

PHPickerViewController
PHPickerConfiguration
PHPickerFilter
PHPickerResult

當(dāng)你展現(xiàn)一個(gè)PHPickerViewController，它有一個(gè)PHPickerConfiguration配置來(lái)告訴它要選擇多少個(gè)媒體項(xiàng)，以及需要選擇的媒體類(lèi)型。通過(guò) PHPickerConfiguration的filter屬性，配置可選擇的媒體類(lèi)型，它的選項(xiàng)可以是任意組合：圖片、實(shí)況照片或視頻。通過(guò)PHPickerConfiguration的selectionLimit屬性來(lái)配置用戶(hù)可以選擇的媒體項(xiàng)數(shù)量。

let photoLibrary = PHPhotoLibrary.shared()
var config = PHPickerConfiguration(photoLibrary: photoLibrary)
                        
let selectedCount = self.albumViewModel.selectArray.count
let limited = min(4-selectedCount, 4)
config.selectionLimit = (type == .pic ? limited : 1)
config.filter = (type == .pic ? .images : .videos)
let pickerViewController = PHPickerViewController(configuration: config)
pickerViewController.delegate = self
self.viewController?.present(pickerViewController, ani

圖片

02真的需要用戶(hù)授權(quán)嗎？

當(dāng)用戶(hù)給予受限訪(fǎng)問(wèn)模式時(shí)，如果需要獲得未授權(quán)的額外資源，網(wǎng)絡(luò)上很多文章建議你使用PHAsset和PHPicker來(lái)獲取額外的數(shù)據(jù)，這樣做的問(wèn)題是，你必須具有訪(fǎng)問(wèn)資源庫(kù)的權(quán)限，這違背了蘋(píng)果建議的使用PHPicker的初衷:在不請(qǐng)求權(quán)限的情況下使用的選擇器。

我們來(lái)模擬一下流程：你的的應(yīng)用程序請(qǐng)求訪(fǎng)問(wèn)用戶(hù)資源庫(kù)的權(quán)限，用戶(hù)說(shuō):“我將只給這個(gè)應(yīng)用程序有限的訪(fǎng)問(wèn)一些照片。” 此時(shí)，如果你的應(yīng)用程序打開(kāi)PHPicker并顯示所有的照片；用戶(hù)說(shuō):“奇怪，我以為我只給有限的訪(fǎng)問(wèn)權(quán)限，為什么所有照片都有？”；接下來(lái)，用戶(hù)選擇了一張他沒(méi)有給我們?cè)L問(wèn)權(quán)限的照片。應(yīng)用程序現(xiàn)在需要什么都不做，為了使用PHAsset獲得他選擇的照片的元數(shù)據(jù)（metadata），他們必須再次更新他們的權(quán)限。用戶(hù)感到困惑。

所以，如果你的目的非常明確，就是需要用戶(hù)給予額外的資源授權(quán)來(lái)獲得 PHAsset 對(duì)象，應(yīng)該使用iOS14的新API PHPhotoLibrary.shared().presentLimitedLibraryPicker(from: vc)，反之，使用 PHPicker不應(yīng)該申請(qǐng)獲得用戶(hù)授權(quán)，正確的做法是使用 PHPickerViewControllerDelegate返回的NSItemProvider獲得元數(shù)據(jù)（metadata）信息，我將在稍后詳細(xì)介紹。

03使用PHPicker的方式

1、錯(cuò)誤方式

下面這段代碼是網(wǎng)絡(luò)上廣泛被轉(zhuǎn)載的一段錯(cuò)誤代碼：

import UIKit
import PhotosUI
class PhotoKitPickerViewController: UIViewController, PHPickerViewControllerDelegate {
    @IBAction func presentPicker(_ sender: Any) {
        let photoLibrary = PHPhotoLibrary.shared()
  let configuration = PHPickerConfiguration(photoLibrary: photoLibrary)
  let picker = PHPickerViewController(configuration: configuration)
  picker.delegate = self
  present(picker, animated: true)
 }
  
 func picker(_ picker: PHPickerViewController, didFinishPicking results: [PHPickerResult]) {
  picker.dismiss(animated: true)
  let identifiers = results.compactMap(\.assetIdentifier)
  let fetchResult = PHAsset.fetchAssets(withLocalIdentifiers: identifiers, options: nil)
    
  // TODO: Do something with the fetch result if you have Photos Library access
 }
}

在這段代碼中，你使用PHPickerViewController選擇了受限制的資源，但是在調(diào)用PHAsset.fetchAssets時(shí)返回了一個(gè)空結(jié)果。這是因?yàn)閒etchAssets方法只能檢索用戶(hù)授權(quán)訪(fǎng)問(wèn)的所有資源，而在受限制模式下，只有最近的受限制資源可供訪(fǎng)問(wèn)，所以這種方式是錯(cuò)誤的！

2、正確方式

PHAsset不應(yīng)該與PHPicker一起使用，這不是使用PHPickeri的正確方法！應(yīng)該使用NSItemProvider。NSItemProvider是一個(gè)項(xiàng)目提供程序，用于在拖放或復(fù)制/粘貼活動(dòng)期間在進(jìn)程之間傳輸數(shù)據(jù)或文件，或者從主機(jī)應(yīng)用程序到應(yīng)用程序擴(kuò)展。使用itemProvider，可以讀取對(duì)象的類(lèi)型，并根據(jù)它是照片、視頻還是其他內(nèi)容來(lái)處理它。比較合適的方式如下所示：

func picker(_ picker: PHPickerViewController, didFinishPicking results: [PHPickerResult]) {
    picker.dismiss(animated: true)
    for result in results {
        let itemProvider: NSItemProvider = result.itemProvider;
        if(itemProvider.hasItemConformingToTypeIdentifier(UTType.image.identifier)) {
            // 圖片處理
        } else  if(itemProvider.hasItemConformingToTypeIdentifier(UTType.movie.identifier)) {
            // 視頻處理
        } else {
            // 其他，暫時(shí)忽略
        }
    }
}

04獲得圖片與圖片元數(shù)據(jù)

通過(guò)前一步驟，我們已經(jīng)知道了資源的類(lèi)型。接下來(lái)通過(guò)NSItemProvider的API加載圖片內(nèi)容和獲得元數(shù)據(jù)信息;查閱 NSItemProvider（1）文檔，可以看到加載數(shù)據(jù)，主要提供了下面幾種API：

loadDataRepresentation：返回資源Data數(shù)據(jù)
loadFileRepresentation：返回資源URL
loadObject：指定資源類(lèi)型返回

這里我推薦使用 loadDataRepresentation，返回Data數(shù)據(jù)，方便下一步獲得元數(shù)據(jù)信息。

func picker(_ picker: PHPickerViewController, didFinishPicking results: [PHPickerResult]) {
    picker.dismiss(animated: true)
    for result in results {
        let itemProvider: NSItemProvider = result.itemProvider;
        if(itemProvider.hasItemConformingToTypeIdentifier(UTType.image.identifier)) {
            // 圖片處理
            itemProvider.loadDataRepresentation(forTypeIdentifier: UTType.image.identifier) { data, error in
                    //處理業(yè)務(wù)model轉(zhuǎn)換
                    if let model = self.createPhotoResourcesModel(data: data, assetIdentifier: assetIdentifier){
                        self.albumViewModel.selectArrayAddObject(model)
                        
                        DispatchQueue.main.async {
                            //更新UI
                        }
                    }
              }
            
        } else  if(itemProvider.hasItemConformingToTypeIdentifier(UTType.movie.identifier)) {
            // 視頻處理
        } else {
            // 其他，暫時(shí)忽略
        }
    }
}

在處理業(yè)務(wù)model轉(zhuǎn)換函數(shù)中，由于Data類(lèi)型很容易轉(zhuǎn)換成UIImage，并且通過(guò)將Data轉(zhuǎn)換為CFData 類(lèi)型，可以通過(guò)系統(tǒng)預(yù)設(shè)的key/value鍵值對(duì)獲得元數(shù)據(jù)信息，

let imgSrc = CGImageSourceCreateWithData(data, options as CFDictionary)
let metadata = CGImageSourceCopyPropertiesAtIndex(imgSrc, 0, options as CFDictionary)
colorModel = metadata[kCGImagePropertyColorModel] as? String
pixelWidth = metadata[kCGImagePropertyPixelWidth] as? Double;
pixelHeight = metadata[kCGImagePropertyPixelHeight] as? Double;

這里我們使用了Github上開(kāi)源的 ExifData（2）代碼，完整實(shí)現(xiàn)了所有字段的獲取封裝，使用起來(lái)非常方便。

func createPhotoResourcesModel(data:Data?,
                            assetIdentifier:String?) -> SNSResourcesModel? {
        guard let imageData = data, let uiimage = UIImage(data: imageData) else {
            return nil
        }
        let model = SNSResourcesModel()
        model.assetLocalIdentifier = assetIdentifier
        model.assetType = .photo
        model.assetSource = .album
        model.originImage = uiimage
        model.bigPreviewImage = uiimage
        
        let exifData = ExifData(data: imageData)
        model.pixelWidth = Int(exifData.pixelWidth ?? 0)
        model.pixelHeight = Int(exifData.pixelHeight ?? 0)
        if imageData.imageType == .GIF{
            model.isGif = true
            model.gifData = imageData
        }
        return model
}

05處理特殊格式圖片

如果用戶(hù)在資源庫(kù)中選擇了一張WebP格式圖片或者GIF動(dòng)圖，由于展示所需代碼和形式均不同，所以需要特別區(qū)分，那么如何來(lái)區(qū)別處理呢？

我們可以通過(guò)UTType來(lái)具體區(qū)分不同類(lèi)型，UTType是Uniform Type Identifier的縮寫(xiě)，用于標(biāo)識(shí)特定類(lèi)型的文件或數(shù)據(jù)。在macOS和iOS等操作系統(tǒng)中，UTType通常用于識(shí)別文件類(lèi)型、將文件分組到合適的應(yīng)用程序中、在不同應(yīng)用程序之間共享數(shù)據(jù)等。

UTType由兩部分組成：類(lèi)型標(biāo)識(shí)符(type identifier)和類(lèi)型標(biāo)簽(type tag)。類(lèi)型標(biāo)識(shí)符是一串唯一的字符串，用于標(biāo)識(shí)特定類(lèi)型的文件或數(shù)據(jù)，通常采用反向DNS風(fēng)格的命名方式，如com.adobe.pdf、public.image等。類(lèi)型標(biāo)簽是一個(gè)可選的字符串，用于描述特定類(lèi)型的文件或數(shù)據(jù)，例如"PDF document"或"JPEG image"等。

if(itemProvider.hasItemConformingToTypeIdentifier(UTType.image.identifier)) {
    // 圖片處理
    // 判斷webp
    if itemProvider.hasItemConformingToTypeIdentifier(UTType.webP.identifier){
        //處理webp
    }
    //判斷GIF
    if itemProvider.hasItemConformingToTypeIdentifier(UTType.gif.identifier){
        //處理GIF
    }        
}

06獲得視頻

獲得視頻時(shí)，推薦使用loadFileRepresentation，返回URL，通過(guò)URL可以獲得 AVAsset。

func picker(_ picker: PHPickerViewController, didFinishPicking results: [PHPickerResult]) {
    picker.dismiss(animated: true)
    for result in results {
        let itemProvider: NSItemProvider = result.itemProvider;
        if(itemProvider.hasItemConformingToTypeIdentifier(UTType.image.identifier)) {
            // 圖片處理
        } else  if(itemProvider.hasItemConformingToTypeIdentifier(UTType.movie.identifier)) {
            // 視頻處理
            itemProvider.loadFileRepresentation(forTypeIdentifier: UTType.movie.identifier) { url, error in
                    //業(yè)務(wù)model轉(zhuǎn)換
                    if let model = self.createVideoResourcesModel(url: url, assetIdentifier: assetIdentifier){
                        self.albumViewModel.selectArrayAddObject(model)
                        
                        DispatchQueue.main.async {
                            //展示UI
                        }
                    }
            }
        } else {
            // 其他，暫時(shí)忽略
        }
    }
}

07獲取加載進(jìn)度

當(dāng)獲取的資源文件較大時(shí)，我們需要獲得加載數(shù)據(jù)的進(jìn)度，此時(shí)可以使用 NSItemProvider的加載數(shù)據(jù)函數(shù)提供的返回值NSProgress對(duì)象。

var progress:Progress?
progress = itemProvider.loadDataRepresentation(forTypeIdentifier: UTType.image.identifier) { data, error in
    //...
}
//添加觀(guān)察者
progress?.addObserver(self, forKeyPath: "fractionCompleted", options: [.new], context: nil)

override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    if keyPath == "fractionCompleted" {
        print("fractinotallow=\(self.progress?.fractionCompleted)")
    }
}

在上面的示例代碼中，我們首先創(chuàng)建了一個(gè)NSItemProvider對(duì)象和一個(gè)指定類(lèi)型標(biāo)識(shí)符。然后，我們使用 loadDataRepresentation(forTypeIdentifier:completionHandler:) 方法加載數(shù)據(jù)，并返回一個(gè)NSProgress對(duì)象。我們可以將該對(duì)象添加為觀(guān)察者，并在觀(guān)察者的回調(diào)方法中更新進(jìn)度條的值。

請(qǐng)注意，NSProgress對(duì)象是線(xiàn)程安全的，因此可以在不同的線(xiàn)程中使用。此外，如果你需要在多個(gè)地方使用同一個(gè)NSProgress對(duì)象；

NSProgress對(duì)象的fractionCompleted屬性，該屬性表示任務(wù)的完成度，其值在0.0和1.0之間。

06總結(jié)

本文要點(diǎn)包含以下：

PHPicker是iOS14開(kāi)始引入的新組件,它允許在不需要用戶(hù)授權(quán)的情況下訪(fǎng)問(wèn)照片庫(kù)的所有資源；
使用PHPicker的正確方式是通過(guò)PHPickerViewControllerDelegate回調(diào)返回的NSItemProvider來(lái)獲取所選資源,而不是通過(guò)PHAsset來(lái)獲取,后者需要提前獲取用戶(hù)的相冊(cè)訪(fǎng)問(wèn)授權(quán)；
通過(guò)NSItemProvider可以判斷資源類(lèi)型,加載資源數(shù)據(jù)或文件URL,獲取圖片、視頻等多媒體資源；
對(duì)于圖片,可以通過(guò)loadDataRepresentation獲取Data,并利用該Data獲取圖片元數(shù)據(jù)信息。對(duì)于視頻,可以通過(guò)loadFileRepresentation獲取URL,并利用URL獲取AVAsset；
通過(guò)UTType可以進(jìn)一步判斷特殊格式資源如webp、gif等進(jìn)行不同處理；
可以通過(guò)NSProgress監(jiān)聽(tīng)資源加載進(jìn)度；
正確使用PHPicker可以避免引起用戶(hù)疑惑,提高用戶(hù)體驗(yàn),是iOS14訪(fǎng)問(wèn)多媒體資源的推薦方式。

總之,本文詳細(xì)介紹了在iOS14中如何正確使用PHPicker訪(fǎng)問(wèn)用戶(hù)選擇的部分照片資源,其要點(diǎn)是不需要提前獲取授權(quán),通過(guò)NSItemProvider處理多媒體資源,這是一種更符合系統(tǒng)設(shè)計(jì)初衷和提高用戶(hù)體驗(yàn)的方式。