您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

PhotoKit 深度解析:從物件模型到照片庫變更觀察

編輯:iOS 開發基礎

介紹

每天用 iPhone 拍下的照片數量,超過任何一台相機的產出。iOS 裝置的螢幕品質也一年比一年好——回溯到 iPad 剛誕生、還沒有 Retina 螢幕的時代,大螢幕的殺手級應用之一就是把使用者的照片攤開來欣賞。自從相機成為 iPhone 最重要也最受歡迎的功能,能管理與加工使用者照片庫的 App 與工具,需求就一直居高不下。

直到 2014 年夏天以前,開發者只能用 AssetsLibrary 框架存取這個日益膨脹的照片庫。幾年之間,相機 App 與照片 App 變化劇烈,長出了「時刻」這類全新的組織方式;而 AssetsLibrary 卻停在原地。

iOS 8 帶來了現代化的替代方案——PhotoKit。它比 AssetsLibrary 更高效,也具備讓 App 與裝置照片庫無縫協作的能力。

概要

我們先鳥瞰框架的物件模型:實體之間的關係、如何取得實體實例、以及如何處理取回的結果。接著會談一些過去用 AssetsLibrary 拿不到的資源元資料,然後進入載入圖像資料的環節——流程本身、可選項、以及那些容易踩到的邊界情況。最後則是重點之一:如何觀察外部參與者對照片庫造成的變更,並提交我們自己的修改。

PhotoKit 物件模型

PhotoKit 定義的實體圖表,與系統「照片」App 展示給使用者的模型一致。這些照片實體都是輕量、不可變的物件,全部繼承自抽象基底類別 PHObject,而它的公開介面只有一個 localIdentifier 屬性。

PHAsset 代表照片庫中的單一資源,負責提供該資源的元資料。

成組的資源稱為資源集合,以 PHAssetCollection 表示。一個集合可以是相簿、一個時刻,或一張「智慧型相簿」——像是所有影片、最近加入的項目、我的最愛、所有連拍照片等等。PHAssetCollection 是 PHCollection 的子類。

PHCollectionList 則表示「集合的集合」。由於它本身就是 PHCollection,集合清單可以包含其他集合清單,於是形成巢狀結構。照片 App 的「時刻」分頁就是例子:照片 → 時刻 → 精選 → 年度。

取得(Fetch)照片實體

取得 vs. 枚舉

熟悉 AssetsLibrary 的人應該記得,那個框架得靠特定屬性去篩找資源,而且往往必須遍歷整個照片庫才能找到匹配項。它雖然提供了縮小搜尋範圍的手段,效率仍然不理想。

PhotoKit 走了完全不同的路:實體實例是「取得」來的。用過 Core Data 的人會覺得這套概念與語彙都相當親切。

取得請求

取得動作由前述實體的類方法實作。該用哪個類、哪個方法,取決於問題的範圍以及你希望如何瀏覽照片庫。所有取得方法的命名高度一致:class func fetchXXX(..., options: PHFetchOptions) -> PHFetchResult。options 參數提供了過濾與排序的途徑,作用近似 NSFetchRequest 的 predicate 與 sortDescriptors。

取得結果

你可能已經注意到:這些取得操作並非非同步的。它們回傳一個 PHFetchResult,可用類似 NSArray 的介面存取集合內容,並會視需要動態載入、快取最近索取過的項目。這行為類似設定了 batchSize 的 NSFetchRequest 結果陣列;差别在於 PHFetchResult 沒有參數能調整它,官方文件只保證「即使處理大量結果,仍能維持最佳表現」。

另外要留意:即使照片庫內容改變了,取得時回傳的 PHFetchResult 不會自動更新。後面會說明如何觀察並處理這些變更。

臨時集合(Transient Collections)

如果你做了一個能操作資源集合的元件,又希望它能處理「任意一組資源」,PhotoKit 的臨時資源集合正好派上用場。

你可以用 PHAsset 陣列,或含資源的 PHFetchResult,透過 PHAssetCollection 的 transientAssetCollectionWithAssets(...) 與 transientAssetCollectionWithFetchResult(...) 工廠方法建立臨時集合。產物使用方式與一般 PHAssetCollection 相同,但不會寫入照片庫,自然也不會出現在照片 App 裡。

集合清單也有對應的 PHCollectionList 的 transientCollectionListWithXXX(...) 系列工廠方法。

當你需要合併兩次取得請求的結果時,這機制格外好用。

照片元資料

如開頭所說,PhotoKit 揭露了一批過去用 ALAssetsLibrary 拿不到、或很難拿到的資源資訊。

HDR 與全景照片

透過照片資源的 mediaSubtypes 屬性,可以判斷這張圖拍攝時是否開啟了 HDR,或是否使用了相機 App 的全景模式。

收藏與隱藏資源

想知道某個資源是否被使用者標記為收藏或隱藏,檢查 PHAsset 的 favorite 與 hidden 即可。

連拍模式照片

若某資源的 representsBurst 為 true,代表它是按住快門拍攝的一組連拍中的代表照片。另一個屬性 burstIdentifier 可用來取得同組的其他照片:把這個值傳給 fetchAssetsWithBurstIdentifier(...) 即可。

使用者可以在連拍中做標記,系統也會自動用各種啟發式規則標出「使用者可能會選」的候選。這份資訊透過 PHAsset 的 burstSelectionTypes 存取,是由三個常數組成的位掩碼:.userPick(使用者手動標記)、.autoPick(系統推測的候選)、.none(未標記)。

這張截圖呈現了照片 App 如何在連拍中自動標示候選照片。

照片載入

在處理使用者照片庫的這些年裡,開發者累積了上百(甚至上千)個提升載入與顯示效率的小技巧:請求的派發與取消、圖像尺寸調整與裁切、快取等等。PhotoKit 用一個更便捷、更現代化的類別把這些全包了:PHImageManager。

請求圖像

圖像請求透過 requestImage(for:...) 派發。這個方法接受一個 PHAsset,可設定回傳圖像的尺寸與其他選項(透過 PHImageRequestOptions 物件),並附上一個結果回呼。它的回傳值是一組請求 ID,用來在資料不再需要時取消請求。

圖像尺寸與裁切

有點奇怪的是,回傳圖像的尺寸與裁切參數分散在兩處。targetSize 與 contentMode 直接傳入請求方法;contentMode 的語意近似 UIView 的同名屬性,決定照片是以等比縮放還是等比填滿的方式放進目標尺寸。若不打算改尺寸或裁切,參數就是 PHImageManagerMaximumSize 與 .default。

此外,PHImageRequestOptions 的 resizeMode 決定縮放策略:.exact(結果必須與目標尺寸相符)、.fast(效率更高,但尺寸可能有落差)、.none。另外 normalizedCroppingMode 決定裁切方式;注意:一旦設定了它,resizeMode 就必須是 .exact。

遞送與進度

預設情況下,若圖像管理器判斷採「最有利策略」,它會先給你一個低品質版本,再把高品質版本送來。這行為由 deliveryMode 控制,預設值為 .opportunistic。只想要高品質、也願意多等一會兒,設為 .highQualityFormat;想要快、可以犧牲一點畫質,設為 .fastFormat。

你可以用 PHImageRequestOptions 的 synchronous 屬性,讓 requestImage 系列方法變成同步呼叫。注意:一旦 synchronous 為 true,deliveryMode 會被忽略並視同 .highQualityFormat。

設定這些參數時,務必記得部分使用者開啟了 iCloud 照片圖庫——這一點非常重要。PhotoKit 的 API 不一定會區分裝置上的照片與 iCloud 上的照片,兩者都走同一個 requestImage 方法。這代表任何一次圖像請求,都可能是走蜂窩網路、慢得令人心痛的網路請求。當你選用 .highQualityFormat 或做同步請求時,請把這件事牢記在心。想確保請求不走網路,把 networkAccessAllowed 設為 false。

另一個與 iCloud 相關的屬性是 progressHandler。將它設為一個 PHAssetImageProgressHandler block,從 iCloud 下載照片時,圖像管理器就會自動呼叫它。

資源版本

PhotoKit 允許對照片做無損修改。對編輯過的照片,系統會另外保留一份原圖拷貝,以及屬於該 App 的調整資料。透過圖像管理器取得資源時,你可以指定要哪一種版本,方式是設定 version 屬性:.current 會遞送包含所有調整與修改的圖像;.unadjusted 遞送未套用任何修改的版本;.original 遞送原始、最高品質的格式(例如 RAW 資料;若設為 .unadjusted,則會得到一張 JPEG)。

想深入了解這塊,可以讀 Sam Davies 的文章《照片擴展》。

結果回呼

結果回呼是一個帶有 UIImage 與 info 字典兩個參數的 block。依參數與請求選項而定,在整個請求生命週期中,它可能被圖像管理器呼叫多次。

info 字典描述當前請求狀態,例如:

圖像是否必須從 iCloud 取得(若你初始化時把 networkAccessAllowed 設為 false,就得重新發一次請求)——PHImageResultIsInCloudKey。

當前遞送的 UIImage 是否為最終結果的低品質版本;高品質圖像還在下載時,你可以先拿它當預覽圖——PHImageResultIsDegradedKey。

請求 ID(方便取消)以及請求是否已被取消——PHImageResultRequestIDKey 與 PHImageCancelledKey。

若完全沒有圖像可交給回呼,字典裡還會帶一個錯誤——PHImageErrorKey。

這些值讓你能更新 UI、告知使用者目前的載入狀態;搭配前面提到的 progressHandler,進度呈現就更完整了。

快取

當圖像即將上螢幕時——例如在滾動的 collection view 上大量展示縮圖——預先把部分圖像載入記憶體往往很有幫助。PhotoKit 提供了一個 PHImageManager 的子類專門處理這種場景:PHImageCachingManager。

關鍵方法是 startCachingImages(for:...):傳入一組 PHAsset、若干請求參數,以及請求單張圖像時會用到的選項。此外也有方法能通知快取管理器停止快取特定清單,或停止快取全部。

allowsCachingHighQualityImages 屬性用來指定是否要準備高品質圖像。當快取的是一份短且不變的清單,預設值 true 表現良好;但若使用者在 collection view 上快速滑動時還要做快取,最好設成 false。

注意:以我的經驗,當使用者帶著大量資源在 collection view 上極速滑動時,快取管理器反而會拖累滑順度。為這種場景量身調整快取行為非常重要:快取窗口的大小、移動窗口的時機與頻率、allowsCachingHighQualityImages 的取值——這些都該在目標機器的真實照片庫上仔細調校並實測。更进一步,你甚至可以依使用者行為動態調整這些參數。

請求圖像資料

最後,除了取得一般的 UIImage,PHImageManager 還提供另一個方法,回傳型別為 Data 的資源原始資料,並附上通用類型識別碼與圖像方向。這個方法能給你關於該資源最完整的資訊。

滄海桑田,萬物變遷

前面談的都是如何取得資源與元資料,但還沒觸及「如何更新我們手上的資料」。照片庫本質上是一大坨可變狀態,而第一節提到的照片實體卻是不可變物件。PhotoKit 讓你能收到所有需要的變更資訊,以便正確更新快取狀態。

觀察變化

首先,透過共享的 PHPhotoLibrary 物件,用 register(_:) 註冊一個變化觀察者(該觀察者需遵循 PHPhotoLibraryChangeObserver 協議)。只要有其他 App 或使用者在照片庫中做了影響到你先前取得內容的修改,觀察者的 photoLibraryDidChange(_:) 就會被呼叫。這個方法只有一個 PHChange 型別的參數,你可以用它判斷變化是否與你感興趣的取得物件相關。

更新取得的結果

PHChange 提供了幾個方法,讓你傳入任何感興趣的 PHObject 或 PHFetchResult 來追蹤變化:changeDetailsForObject(_:) 與 changeDetailsForFetchResult(_:)。若無變化,它們回傳 nil;否則你可以透過 PHObjectChangeDetails 或 PHFetchResultChangeDetails 檢視細節。

PHObjectChangeDetails 提供對最新照片實體物件的引用,以及兩個布林值,分別告訴你該物件的圖像資料是否變過、物件是否已被刪除。

PHFetchResultChangeDetails 封裝了作用於先前 PHFetchResult 上的變化,設計目標是盡可能簡化 CollectionView / TableView 的更新。它的屬性幾乎正好對應你在實作一個典型 collection view update handler 時需要的一切。注意:要正確更新 UITableView / UICollectionView,變更必須依序處理,順序是 RICE——removedIndexes、insertedIndexes、changedIndexes、enumerateMoves(若 hasMoves 為 true)。另外,hasIncrementalChanges 可能被設為 false,代表舊的取得結果應整體被新值取代;這種情況就該呼叫 reloadData。

注意:不需要用集中式的方式處理變化。若 App 內有多個元件需要處理照片實體,它們各自實作自己的 PHPhotoLibraryChangeObserver 即可,然後每個元件自行向 PHChange 查詢,判斷是否需要、以及如何更新自己的狀態。

隨風而變

知道了如何觀察他人造成的變化,接下來試著自己动手改。

改變既存物件

用 PhotoKit 修改照片庫,本質上是先建立一個指向某資源或資源集合的變化請求物件,再設定相關屬性或呼叫合適方法來描述你要提交的變化;最後透過 performChanges(_:),在提交給共享 PHPhotoLibrary 的 block 中完成。注意:你必須在 performChanges 的 completion block 裡準備好處理失敗。由於你操作的是一份可能被多個參與者(你的 App、使用者、其他 App、照片擴展等)同時改動的狀態,這個設計換來的是安全性,而且相對易用。

要修改資源,建立一個 PHAssetChangeRequest,接著就能改動建立日期、所在位置,以及是否隱藏、是否標記為收藏等,也可以從使用者庫中刪除資源。

類似地,修改資源集合或集合清單需要 PHAssetCollectionChangeRequest 或 PHCollectionListChangeRequest,然後就能改標題、增減集合成員,或整個刪除集合。

在你的變化提交到使用者照片庫之前,系統會向使用者顯示一個明確的權限提示。

建立新物件

建立新資源的做法與修改既存資源相似:用 creationRequestForAssetFromXXX(...) 工廠方法建立變化請求,並傳入圖像資料(或一個 URL)。若你還想對新建資源做額外設定,可以用變化請求的 placeholderForCreatedAsset 屬性,它會回傳一個可用的 placeholder,代替「真正的」PHAsset 引用。

結論

以上談的是 PhotoKit 的基礎,但仍有大量內容等著我們挖掘。多讀範例程式碼、看 WWDC session 影片、動手寫一些自己的程式——這是最快的路。PhotoKit 為 iOS 開發者開啟了一整個新的可能性空間,未來幾個月到幾年裡,我們一定會看到更多建立在它之上的優秀作品。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved