iOS開發tips-PhotoKit_ZenDei技術網路在線

概述PhotoKit應該是iOS 8 開始引入為了替代之前ALAssetsLibrary的相冊資源訪問的標準庫，後者在iOS 9開始被棄用。當然相對於ALAssetsLibrary其擴展性更高，api使用起來也更加的強大，但這並非今天討論的重點，這裡主要討論PhotoKit使用的一些技巧和容易踩的坑... ...

概述

PhotoKit應該是iOS 8 開始引入為了替代之前ALAssetsLibrary的相冊資源訪問的標準庫，後者在iOS 9開始被棄用。當然相對於ALAssetsLibrary其擴展性更高，api使用起來也更加的強大，但這並非今天討論的重點，這裡主要討論PhotoKit使用的一些技巧和容易踩的坑。

PHImageManager or Custom

訪問相冊資源常用的操作還是獲取資源，比如獲取一張相冊的圖片，可以通過PHImageManager.default().requestImage(xxx)一個回調就可以了，其實除了簡單的圖片拉取蘋果建議大家使用一個自己維護的PHCachingImageManager（PHImageManager子類）單例，因為從名字可以看出它可以進行資源緩存（具體用法參見：PHCachingImageManager），這個在列表滑動過程中比較有用，因為可以使用startCachingImages(for:targetSize:contentMode:options:)預載入還未顯示的資源，在不需要使用的時候調用stopCachingImages(for:targetSize:contentMode:options:)移除緩存，除此之外其實它更多的是使用父類的功能。

關於requestImage(for:targetSize:contentMode:options:resultHandler:)方法其實它的options是更容易讓大家使用的時候經常迷糊的地方，因為iOS相冊的照片很可能並不在本地而是在iCloud上面存儲，本地只有縮略圖:

isNetworkAccessAllowed:是不是打開網路載入，對於iCloud優化的圖片本地只有縮略圖，需要了開啟網路載入，預設是false，但是建議非特殊情況下不要關閉網路載入設為true
isSynchronous:獲取圖片時是否同步獲取，否則非同步獲取，非特殊情況下不建議使用同步獲取會阻塞線程，預設為false
version:使用資源的版本，例如說一個視頻獲取過程中是要獲取編輯過的還是獲取原始視頻（因為iOS的相冊編輯時可以恢復的，所以其實裡面包含了編輯信息），預設current對於未編輯的則獲取原始資源，編輯過則獲取編輯過的資源。
deliveryMode:字面意思資源交付模式，就是當發起一個請求後系統如何提供請求的資源（不過很可能這個資源並不在本地），預設是opportunistic同步調用只返回一種資源非同步調用返回多種資源（例如不同尺寸的圖片，這也就是說和上面的isSynchronous相關）；highQualityFormat任何情況下只返回高質量的一種資源；fastFormat任何情況下只返回一種結果，它可能是低清圖片（是不是低清晰度可以通過resultHandler結果中的info欄位PHImageResultIsDegradedKey來判斷是不是低清晰度）。
resizeMode:重設尺寸模式，這個其實關係到方法中targetSize參數，預設是fast代表當本地是原圖則返回原圖，本地是縮略圖則使用targetSize來獲取一個最優圖片，但是尺寸可能比targetSize要略大（註意如果targetSize是PHImageManagerMaximumSize則會拉取原圖此屬性此時沒有意義直接忽略）；none則返回原圖大小；exact同fast但是返回的高清圖。但是在非同步情況下因為可能存在兩種圖片會稍有不同，下麵分兩種情況介紹。

isSynchronous和deliveryMode、resizeMode之間的關係（前提是開啟網路載入isNetworkAccessAllowed = true）：

isSynchronous = true同步載入：此時deliveryMode會被忽略掉，所以只要看resizeMode

none:返回原圖尺寸
fast:原圖為縮略圖時使用targetSize優化，返回一個可能比targetSize稍大的圖片
exact:返回指定targetSize的高清圖片

isSynchronous = false非同步載入：此時要看deliveryMode和resizeMode兩者的變化情況

deliveryMode = opportunistic
- none:先返回低清圖片，再返回原圖
- fast:先返回低清圖片，再返回使用targetSize優化，可能比targetSize稍大的圖片
- exact:先返回低清圖片，再返回指定targetSize的高清圖片
deliveryMode = highQualityFormat
- none:返回原圖
- fast:返回使用targetSize優化，可能比targetSize稍大的圖片
- exact:返回指定targetSize的高清圖片
deliveryMode = fastFormat
- none:返回低清圖片
- fast:返回低清圖片
- exact:返回低清圖片

對於是否返回兩次結果總結起來對於返回結果只有非同步請求在不設置deliveryMode或者deliveryMode = opportunistic 時會發送兩次請求。

沒錯上面的情況如果瞭解不清楚很容易掉進坑裡，一般的情況下只要打開網路，使用預設值即可。但是話說沒有網路的情況下是什麼情況呢？

無網路情況

上面說了那麼多配置那麼對於沒有網路的情況呢？因為PHImageRequestOptions預設其實就是沒有網路的。先看一下下麵的請求：

let requestOption = PHImageRequestOptions()
requestOption.resizeMode = .exact
let scale:CGFloat = UIScreen.main.scale
let newSize = CGSize(width: 200.0, height: 200)
PHImageManager.default().requestImage(for: asset, targetSize: newSize, contentMode: .aspectFill, options: requestOption,resultHandler: completeHandler)

首先沒有設置isNetworkAccessAllowed屬性，那麼預設值就是false，這個時候也就是沒有任何網路請求，其次resizeMode = .exact也就是請求比較高清的圖片。但是一個重要的問題是這個圖片可能會是一個低清圖片，甚至達不到一個200200的縮略圖的預期，有可能特別模糊。
按照前面說的，deliveryMode 沒有設置預設是opportunistic，isSynchronous*沒有設置預設是false，在非同步情況下是首先這種情況下也會返回兩個結果，列印info信息：
第一次：
[AnyHashable("PHImageResultIsDegradedKey"): 1, AnyHashable("PHImageResultRequestIDKey"): 1100]
第二次：
[AnyHashable("PHImageResultIsDegradedKey"): 0, AnyHashable("PHImageErrorKey"): Error Domain=NSCocoaErrorDomain Code=-1 "(null)", AnyHashable("PHImageResultIsInCloudKey"): 1, AnyHashable("PHImageResultRequestIDKey"): 1100]

可以看出第一次是低清圖片，第二次是高清，但是此時出錯了PHImageResultIsInCloudKey = 1，本地並沒有高清圖，但是因為無法訪問網路去獲取就報錯了，拋出PHImageErrorKey信息，同時此時返回的image = nil，這樣的結果就是只能看到低清圖片。因此是否返回清晰照片除了上面說的，還和是否允許網路請求有直接關係。

綜上來看除非特殊情況下，請打開網路請求使用非同步請求，並且在合適的時機判斷是否請求返回兩次。

視頻獲取

對於視頻資源的獲取和圖片還有些不同，因為使用PhotoKit上傳視頻的過程並不是直接獲取到視頻路徑來做的，當然如果不熟悉這個過程很可能使用下麵的方式：

let option = PHVideoRequestOptions()
option.isNetworkAccessAllowed = true
option.version = .current
option.deliveryMode = .highQualityFormat
PHImageManager.default().requestAVAsset(forVideo: phAsset, options: option) { (avAsset, _, _) in
    if let avAsset = avAsset as? AVURLAsset {
        let fileURL = avAsset.url
        // upload by fileURL
    }
}

這套代碼遇到的問題很可能是iOS 10之前的系統上傳失敗，之後的基本還是可以傳成功的，主要是因為這個url路徑在低版本系統訪問受限。

正確的姿勢應該是先把視頻導出到沙盒然後從本地上傳，那麼如何copy到本地呢？答案是使用PHAssetResourceManager，這個類出現的比較晚在iOS 9才引入的，就是為了方便資源管理，可以通過他將本地相冊的資源寫入沙盒然後上傳沙盒的資源。

let resources = PHAssetResource.assetResources(for: phAsset)
let options = PHAssetResourceRequestOptions()
options.isNetworkAccessAllowed = true
PHAssetResourceManager.default().writeData(for: assetResource, toFile: videoURL, options: options, completionHandler: { (error) in
    // upload by videoURL
    
})

但是這並非就萬事大吉了，接下來的一個bug就是，通過這種方式如果上傳用戶已經編輯過的資源會發現它上傳的是編輯之前的（比如說用戶將60s的視頻通過系統相冊剪輯到50s，它上傳的還是60s的），因為它相比較於PHImageManager請求可以設置PHVideoRequestOptions.version它缺少了這個信息，查找api也沒有發現可以用的設置，所以這種方式還是不可取（如果有朋友知道怎麼使用這種方式獲取不同的version可以留言告訴我）。所以這時可以採用PHImageManager的另一個方法requestExportSession（xxx）將視頻導出到沙盒然後上傳，但是這麼做的另一個小問題就是如果想要導出原始視頻就不太可能了，只能儘可能拿到一個更高清晰度的視頻。

let videoOption = PHVideoRequestOptions()
videoOption.version = PHVideoRequestOptionsVersion.current
videoOption.isNetworkAccessAllowed = true
PHImageManager.default().requestExportSession(forVideo: phAsset, options: videoOption, exportPreset: AVAssetExportPresetHighestQuality) { (exportSession, info) in
    if let exportSession = exportSession {
        exportSession.outputURL = videoURL
        exportSession.outputFileType = AVFileType.mp4
        exportSession.exportAsynchronously {
        if exportSession.status == AVAssetExportSession.Status.completed {
            // upload by videoURL
        }
    }
}

話說到了這裡是不是就真的沒事了？試著用下麵的視頻上傳試試：
TestVideo.zip
exportSession.status應該會失敗，當然如果你是iOS 13應該是可以的，但是如果是iOS 13以下在當前環境測試都是通不過的，這個視頻查看meta信息也沒有什麼特殊的，但是這個是Android導出的一個視頻，失敗信息是：無法完成此操作。除此之外並沒有有用的信息，初步猜測導出時應該是編解碼出錯了。

其實到了這裡，用上面的方式應該就無法解決這個問題了，至少目前沒有找到有效的辦法，兜底策略就是失敗後採用上面的第二種方式。