介紹

每天，用 iPhone 拍攝的照片數(shù)量超過了任何相機。每年 iOS 設(shè)備上的顯示效果變得越來越好，回到 iPad 剛出現(xiàn)還沒有 Retina 顯示屏的時代，大屏幕的殺手級功能之一就是可以展示用戶照片和瀏覽器照片庫。自從相機成為 iPhone 最重要和***的功能開始，對能管理和加工用戶照片庫中寶貴的照片的應(yīng)用程序和工具就有著巨大的需求。

直到 2014 年夏天前，開發(fā)者只能用 AssetsLibrary 框架訪問日益增長的用戶的照片庫。幾年以來，相機應(yīng)用和照片應(yīng)用發(fā)生了顯著的變化，增加了許多新特性，包括按時刻來組織照片的方式。但與此同時，AssetsLibrary 框架卻沒有跟上步伐。

隨著 iOS 8 的到來，蘋果給我們提供了一個現(xiàn)代化的框架 —— PhotoKit，它比 AssetsLibrary 表現(xiàn)更好，并且擁有讓應(yīng)用和設(shè)備照片庫無縫工作的特性。

概要

我們將從框架對象模型的鳥瞰圖開始：實體和實體間的關(guān)系，獲取實體的實例，以及使用獲取的結(jié)果進行工作。

除此之外，我們的講解還會涉及到一些在使用 AssetsLibrary 時，尚未對開發(fā)者開放的資源元數(shù)據(jù)。

然后我們會討論加載資源的圖像數(shù)據(jù)：過程本身，大量可用的選項，一些陷阱和邊界案例。

***，我們會談?wù)勍ㄟ^外部參與者來觀察照片庫的變化，學(xué)習(xí)如何創(chuàng)建和提交我們自己修改的改變。

PhotoKit 對象模型

PhotoKit 定義了與系統(tǒng)的 Photos 應(yīng)用內(nèi)展現(xiàn)給用戶的模型對象相一致的實體圖表。這些照片實體都是輕量級的不可變對象。所有的 PhotoKit 對象都是繼承自 PHObject 抽象基類，其公共接口只提供了一個 localIdentifier 屬性。

PHAsset 表示用戶照片庫中一個單獨的資源，用以提供資源的元數(shù)據(jù)。

成組的資源叫做資源集合，用 PHAssetCollection 類表示。一個單獨的資源集合可以是照片庫中的一個相冊或者一個時刻，或者是一個特殊的“智能相冊”。這種智能相冊包括所有的視頻集合，最近添加的項目，用戶收藏，所有連拍照片等等。PHAssetCollection 是 PHCollection 的子類。

PHCollectionList 表示一組的 PHCollections。因為它本身就是 PHCollection，所以集合列表可以包含其他集合列表，它們允許復(fù)雜的集合繼承。實際上，我們可以在照片應(yīng)用的時刻欄目中看到它：照片 --- 時刻 --- 精選 --- 年度，就是一個例子。

獲取 (Fetch) 照片實體

獲取 vs. 枚舉

那些熟悉 AssetsLibrary 框架的開發(fā)者可能會記得 AssetsLibrary 可以用一些特定屬性來找到需要的資源，其中一個必須枚舉用戶資源庫來獲得匹配的資源。不得不承認，這個 API 雖然提供了一些縮小搜索域的方法，但還是十分低效。

而與之形成鮮明對比，PhotoKit 實體的實例是通過獲取得到的。那些熟悉 Core Data 的人，會覺得和 PhotoKit 在概念和描述都比較接近。

獲取請求

獲取操作是由上面描述的實體的類方法實現(xiàn)的。要使用哪個類/方法，取決于問題所在范圍和你展示與遍歷照片庫的方式。所有獲取方法的命名都是相似的：class func fetchXXX(..., options: PHFetchOptions) -> PHFetchResult 。options 參數(shù)給了我們一個對結(jié)果進行過濾和排序的途徑，這和 NSFetchRequest 的 predicate 與 sortDescriptors 參數(shù)類似。

獲取結(jié)果

你可能已經(jīng)注意到了這些獲取操作不是異步的。它們返回了一個 PHFetchResult 對象，可以用類似 NSArray 的接口來訪問結(jié)果內(nèi)的集合。它會按需動態(tài)加載內(nèi)容并且緩存最近請求的內(nèi)容。這個行為和設(shè)置了 batchSize 屬性的 NSFetchRequest 返回的結(jié)果數(shù)組相似。對于 PHFetchResult 來說，沒有辦法用參數(shù)來指定這個行為，但是官網(wǎng)文檔保證 “即使在處理大量的返回結(jié)果時，依然能夠有***的表現(xiàn)”。

就算滿足請求的照片庫內(nèi)容發(fā)生了改變，獲取方法所返回的 PHFetchResult 對象是不會自動更新。在后面的小節(jié)中，我們會介紹如何對返回的 PHFetchResult 對象的改變進行觀察并處理更新內(nèi)容。

臨時集合 (Transient Collections)

你可能會發(fā)現(xiàn)你已經(jīng)設(shè)計了一個可以操作資源集合的組件，并且你還希望它能夠處理任意一組的資源。PhotoKit 通過臨時資源集合，讓我們可以輕松做到這點。

你可以通過 PHAsset 對象數(shù)組或是包含資源的 PHFetchResult 對象來創(chuàng)建臨時資源集合。創(chuàng)建的操作在 PHAssetCollection 的 transientAssetCollectionWithAssets(...) 和 transientAssetCollectionWithFetchResult(...) 工廠方法內(nèi)完成。這些方法創(chuàng)建出來的對象可以像其它的 PHAssetCollection 對象一樣使用。盡管如此，這些集合不會被存儲到用戶照片庫，自然也不會在照片應(yīng)用中展示出來。

和資源集合相似，你可以用 PHCollectionList 中的 transientCollectionListWithXXX(...) 工廠方法來創(chuàng)建臨時集合列表。

當(dāng)你要合并兩個獲取請求時，你就會發(fā)現(xiàn)這個東西非常有用。

照片元數(shù)據(jù)

正如文章開頭提到的，PhotoKit 提供了額外的關(guān)于用戶資源的元數(shù)據(jù)，而這些數(shù)據(jù)在以前使用 ALAssetsLibrary 框架中是沒有辦法訪問，或者很難訪問到。

HDR 和全景照片

你可以使用照片資源的 mediaSubtypes 屬性驗證資源庫中的圖像在捕捉時是否開啟了 HDR，拍攝時是否使用了相機應(yīng)用的全景模式。

收藏和隱藏資源

要驗證一個資源是否被用戶標(biāo)記為收藏或被隱藏，只要檢查 PHAsset 實例的 favorite 和 hidden 屬性即可。

連拍模式照片

對于一個資源，如果其 PHAsset 的 representsBurst 屬性為 true，則表示這個資源是一系列連拍照片中的代表照片 (多張照片是在用戶按住快門時拍攝的)。它還有一個屬性是 burstIdentifier，如果想要獲取連拍照片中的剩余的其他照片，可以通過將這個值傳入 fetchAssetsWithBurstIdentifier(...) 方法來獲取。

用戶可以在連拍的照片中做標(biāo)記；此外，系統(tǒng)也會自動用各種試探來標(biāo)記用戶可能會選擇的潛在代表照片。這個元數(shù)據(jù)是可以通過 PHAsset 的 burstSelectionTypes 屬性來訪問。這個屬性是用三個常量組成的位掩碼：.UserPick 表示用戶手動標(biāo)記的資源，.AutoPick 表示用戶可能標(biāo)記的潛在資源，.None 表示沒有標(biāo)記的資源。

這個屏幕快照顯示了，照片應(yīng)用是如何在連拍的照片中自動標(biāo)記用戶可能標(biāo)記的潛在資源。

照片加載

在處理用戶照片庫的過去幾年中，開發(fā)者創(chuàng)造了上百 (如果沒有上千) 的小技巧來提高照片加載和展示的效率。這些技巧處理請求的派發(fā)和取消，圖像大小的修改和裁剪，緩存等等。PhotoKit 提供了一個可以用更加便捷和現(xiàn)代的 API 做了所有這些操作的類：PHImageManager 。

請求圖像

圖像請求是通過 requestImageForAsset(...) 方法派發(fā)的。這個方法接受一個 PHAsset，可以設(shè)置返回圖像的大小和圖像的其它可選項 (通過 PHImageRequestOptions 參數(shù)對象設(shè)置)，以及結(jié)果回調(diào) (result handler)。這個方法的返回值可以用來在所請求的數(shù)據(jù)不再被需要時取消這個請求。

圖像的尺寸和裁剪

奇怪的是，對返回圖像的尺寸定義和裁剪的參數(shù)是分布在兩個地方的。targetSize 和 contentMode 這倆參數(shù)會被直接傳入 requestImageForAsset(...) 方法內(nèi)。這個 content Mode 和 UIView 的 contentMode 參數(shù)類似，決定了照片應(yīng)該以按比例縮放還是按比例填充的方式放到目標(biāo)大小內(nèi)。注意：如果不對照片大小進行修改或裁剪，那么方法參數(shù)是 PHImageManagerMaximumSize 和 PHImageContentMode.Default 。

此外，PHImageRequestOptions 還提供了一些方式來確定圖像管理器該以怎樣的方式來重新設(shè)置圖像大小。resizeMode 屬性可以設(shè)置為 .Exact (返回圖像必須和目標(biāo)大小相匹配)，.Fast (比 .Exact 效率更高，但返回圖像可能和目標(biāo)大小不一樣) 或者 .None。還有個值得一提的是，normalizedCroppingMode 屬性讓我們確定圖像管理器應(yīng)該如何裁剪圖像。注意：如果設(shè)置了 normalizedcroppingMode 的值，那么 resizeMode 需要設(shè)置為 .Exact。

請求遞送和進度

默認情況下，如果圖像管理器決定要用***策略，那么它會在將圖像的高質(zhì)量版本遞送給你之前，先傳遞一個較低質(zhì)量的版本。你可以通過 deliveryMode 屬性來控制這個行為；上面所描述的默認行為的值為 .Opportunistic。如果你只想要高質(zhì)量的圖像，并且可以接受更長的加載時間，那么將屬性設(shè)置為 .HighQualityFormat。如果你想要更快的加載速度，且可以犧牲一點圖像質(zhì)量，那么將屬性設(shè)置為 .FastFormat。

你可以使用 PHImageRequestOptions 的 synchronous 屬性，讓 requestImage... 系列的方法變成同步操作。注意：當(dāng) synchronous 設(shè)為 true 時，deliveryMode 屬性就會被忽略，并被當(dāng)作 .HighQualityFormat 來處理。

在設(shè)置這些參數(shù)時，一定要考慮到你的一些用戶有可能開啟了 iCloud 照片庫，這點非常重要。PhotoKit 的 API 不一定會對設(shè)備的照片和 iCloud 上照片進行區(qū)分 —— 它們都用同一個 requestImage 方法來加載。這意味著任意一個圖像請求都有可能是一個通過蜂窩網(wǎng)絡(luò)來進行的非常緩慢的網(wǎng)絡(luò)請求。當(dāng)你要用 .HighQualityFormat 或者做一個同步請求的時候，要牢記這個。注意：如果你想要確保請求不經(jīng)過網(wǎng)絡(luò)，可以將 networkAccessAllowed 設(shè)為 false 。

另一個和 iCloud 相關(guān)的屬性是 progressHandler。你可以將它設(shè)為一個 PHAssetImageProgressHandler 的 block，當(dāng)從 iCloud 下載照片時，它就會被圖像管理器自動調(diào)用。

資源版本

PhotoKit 允許應(yīng)用對照片進行無損的修改。對編輯過的照片，系統(tǒng)會對單獨保存一份原始照片的拷貝和針對應(yīng)用的調(diào)整數(shù)據(jù)。當(dāng)用圖像管理器獲取資源時，你可以指定哪個版本的圖像資源應(yīng)該通過 result handler 被遞送。這可以通過設(shè)置 version 屬性來做到：.Current 會遞送包含所有調(diào)整和修改的圖像；.Unadjusted 會遞送未被施加任何修改的圖像；.Original 會遞送原始的、***質(zhì)量的格式的圖像 (例如 RAW 格式的數(shù)據(jù)。而當(dāng)將屬性設(shè)置為 .Unadjusted 時，會遞送一個 JPEG)。

你可以在 Sam Davies 的文章《照片擴展》中，閱讀框架中更多關(guān)于這方面的內(nèi)容。

結(jié)果回調(diào) (result handler)

結(jié)果回調(diào)是一個包含了一個 UIImage 變量和一個 info 字典作為參數(shù)的 block。根據(jù)參數(shù)和請求的選項，在請求的整個生命周期，它可以被圖像管理器多次調(diào)用。

info 字典提供了關(guān)于當(dāng)前請求狀態(tài)的信息，比如：

圖像是否必須從 iCloud 請求 (如果你初始化時將 networkAccessAllowed 設(shè)置成 false，那么就必須重新請求圖像) —— PHImageResultIsInCloudKey 。

當(dāng)前遞送的 UIImage 是否是最終結(jié)果的低質(zhì)量格式。當(dāng)高質(zhì)量圖像正在下載時，這個可以讓你給用戶先展示一個預(yù)覽圖像 —— PHImageResultIsDegradedKey。

請求 ID (可以便捷的取消請求)，以及請求是否已經(jīng)被取消 —— PHImageResultRequestIDKey 和 PHImageCancelledKey。

如果沒有圖像提供給 result handler，字典內(nèi)還會有一個錯誤信息 —— PHImageErrorKey。

這些值可以讓你更新你的 UI 來告知用戶，和上面討論到的 progressHandler 一起，來表示出它們的加載狀態(tài)。

緩存

當(dāng)圖像即將要展示在屏幕上時，比如當(dāng)要在一組滾動的 collection 視圖上展示大量的資源圖像的縮略圖時，預(yù)先將一些圖像加載到內(nèi)存中有時是非常有用的。PhotoKit 提供了一個 PHImageManager 的子類來處理這種特定的使用場景 —— PHImageCachingManager。

PHImageCachingManager 提供了一個關(guān)鍵方法 —— startCachingImagesForAssets(...)。你傳入一個 PHAssets 類型的數(shù)組，一些請求參數(shù)，以及一些請求單個圖像時即將用到的可選項。此外，還有一些方法可以讓你通知緩存管理器來停止緩存特定資源列表，以及停止緩存所有圖像。

allowsCachingHighQualityImages 屬性可以讓你指定圖像管理器是否應(yīng)該準(zhǔn)備高質(zhì)量圖像。當(dāng)緩存一個較短和不變的資源列表時，默認 true 的屬性表現(xiàn)很好。但當(dāng)要在 collection 視圖上快速滑動時做緩存操作的話，***將它設(shè)置成 false 。

注意：以我的經(jīng)驗，當(dāng)用戶正在有大量資源的 collection 視圖上極其快速的滑動時，使用緩存管理器會損害滑動的表現(xiàn)效果。為這種特定的使用場景定制一個緩存行為是極其重要的。緩存窗口的大小，移動緩存窗口的時機和頻率，allowsCachingHighQualityImages 的屬性值 —— 這些參數(shù)都要在目標(biāo)硬件上的真實照片庫中仔細地調(diào)節(jié)，并測試表現(xiàn)效果。更進一步，你可以考慮在用戶行為的基礎(chǔ)上，動態(tài)的設(shè)置這些參數(shù)。

請求圖像數(shù)據(jù)

***，除了請求普通的 UIImage 之外，PHImageManager 提供了另一個方法可以返回 NSData 對象類型的資源數(shù)據(jù)，包括它的通用類型標(biāo)識符，圖像的展示方向。這個方法返回了這個資源的最多的信息。

滄海桑田，萬物變遷

我們已經(jīng)討論了在用戶照片庫中請求資源的元數(shù)據(jù)，但是到目前為止，我們沒提及如何更新我們獲取的數(shù)據(jù)。照片庫本質(zhì)上是一大堆可變的狀態(tài)，而***節(jié)中提到的照片實體是不可變的對象。PhotoKit 可以讓你接收你需要的、關(guān)于照片庫變動的所有信息，以正確更新你的緩存狀態(tài)。

觀察變化

首先，你需要通過共享的 PHPhotoLibrary 對象，用 registerChangeObserver(...) 方法注冊一個變化觀察者 (這個觀察者要遵從 PHPhotoLibraryChangeObserver 協(xié)議)。只要另一個應(yīng)用或者用戶在照片庫中做的修改影響了你在變化前獲取的任何資源或資源集合的話，變化觀察者的 photoLibraryDidChange(...) 方法都會被調(diào)用。這個方法只有一個 PHChange 類型的參數(shù)，你可以用它來驗證這些變化是否和你所感興趣的獲取對象有關(guān)聯(lián)。

更新獲取的結(jié)果

PHChange 提供了幾個方法，讓你可以通過傳入任何你感興趣的 PHObject 對象或 PHFetchResult 對象來追蹤它們的變化。這幾個方法是 changeDetailsForObject(...) 和 changeDetailsForFetchResult(...) 。如果沒有任何變化，這些方法會返回 nil，否則你可以借助 PHObjectChangeDetails 或 PHFetchResultChangeDetails 對象來觀察這些變化。

PHObjectChangeDetails 提供了一個對***的照片實體對象的引用，以及告訴你對象的圖像數(shù)據(jù)是否曾變化過、對象是否曾被刪除過的布爾值。

PHFetchResultChangeDetails 封裝了施加在你之前通過獲取所得到的 PHFetchResult 上的變化的信息。PHFetchResultChangeDetails 是為了盡可能簡化 CollectionView 或 TableView 的更新操作而設(shè)計的。它的屬性恰好映射到你在使用一個典型的 CollectionView 的 update handler 時所需要的信息。注意，若要正確的更新 UITableView/UICollectionView，你必須以正確順序來處理變化，那就是：RICE —— removedIndexes，insertedIndexes，changedIndexes，enumerateMovesWithBlock (如果 hasMoves 為 true 的話)。另外，PHFetchResultChangeDetails 的 hasIncrementalChanges 屬性可以被設(shè)置成 false，這意味著舊的獲取結(jié)果應(yīng)該全部被新的值代替。這種情況下，你應(yīng)該調(diào)用 UITableView/UICollectionView 的 reloadData。

注意：沒有必要以集中的方式處理變化。如果你應(yīng)用中的多個組件需要處理照片實體，那么它們每個都要有自己的 PHPhotoLibraryChangeObserver 。接著組件就能靠自己查詢 PHChange 對象，檢測是否需要 (以及如何) 更新它們自己的狀態(tài)。

隨風(fēng)而變

現(xiàn)在我們已經(jīng)知道了如何觀察用戶和其他應(yīng)用造成的變化，我們來嘗試一下自己進行改變。

改變存在的對象

用 PhotoKit 在照片庫做改變，說到底其實是先創(chuàng)建了一個鏈接到某個資源或者資源集合的變化請求對象，再設(shè)置請求對象的相關(guān)屬性或調(diào)用合適的方法來描述你想要提交的變化。這個必須通過 performChanges(...) 方法，在提交到共享的 PHPhotoLibrary 的 block 內(nèi)完成。注意：你需要準(zhǔn)備好在 performChanges 方法的 completion block 里處理失敗的情況。雖然處理的是能被多個參與者 (如你的應(yīng)用，用戶，其他應(yīng)用，照片擴展等) 改變的狀態(tài)，但這個方式能提供安全性，也相對易用。

想要修改資源，需要創(chuàng)建一個 PHAssetChangeRequest 。然后你就可以修改創(chuàng)建創(chuàng)建日期，資源位置，以及是否將隱藏資源，是否將資源看做用戶收藏等。此外，你還可以從用戶的庫里刪除資源。

類似地，若要修改資源集合或集合列表，需要創(chuàng)建一個 PHAssetCollectionChangeRequest 或 PHCollectionListChangeRequest 對象。然后你就可以修改集合標(biāo)題，添加或刪除集合成員，或者完全刪除集合。

在你的變化提交到用戶照片庫前，系統(tǒng)會向用戶展示一個明確的獲取權(quán)限的警告框。

創(chuàng)建新對象

創(chuàng)建一個新資源的做法和修改已存在的資源類似。只要用 creationRequestForAssetFromXXX(...) 工廠方法，來創(chuàng)建變化請求，并傳入資源圖像數(shù)據(jù) (或一個 URL)。如果你需要對新建的資源做額外的修改，你可以用創(chuàng)建變化請求的 placeholderForCreatedAsset 屬性。它會返回一個可用的 placeholder 來代替“真實的” PHAsset 引用。

結(jié)論

我已經(jīng)討論了 PhotoKit 的基礎(chǔ)知識，但仍然還有非常多的東西等著我們?nèi)グl(fā)掘。你可以通過查看示例的各處的代碼，觀看 WWDC session 視頻學(xué)習(xí)更多內(nèi)容，發(fā)掘更深的知識，然后寫一些自己的代碼！PhotoKit 為 iOS 開發(fā)者開啟了通往新世界可能性，在未來的數(shù)月或者數(shù)年里，我們肯定會看到更多基于這個基礎(chǔ)構(gòu)建的富有創(chuàng)造性的優(yōu)秀產(chǎn)品。