如果只是偶爾選一張圖或拍一段視頻,UIImagePickerController 就夠用了。但需求一旦升級為「一次選多張」「遍歷整個相冊做備份」,UIImagePickerController 就無能為力了。這時候需要換一套接口。
動手之前先認識三個核心類:
還有一個關鍵角色是 block。從 iOS 4 開始 block 大量出現在各類 API 中,而 AssetsLibrary 的遍歷接口本身就是異步的——用 block 嵌套,就能在一個方法體內把「遍歷分組」和「遍歷分組內資產」兩層異步邏輯寫完,不必拆散到多個代理方法裡。
ALAssetsLibrary *assetsLibrary = [[ALAssetsLibrary alloc] init]; // 相冊句柄
NSMutableArray *mediaArray = [[NSMutableArray alloc] init]; // 存放媒體信息
[assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAll
usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
[group enumerateAssetsUsingBlock:^(ALAsset *result, NSUInteger index, BOOL *stop) {
NSString *assetType = [result valueForProperty:ALAssetPropertyType];
if ([assetType isEqualToString:ALAssetTypePhoto]) {
NSLog(@"Photo");
} else if ([assetType isEqualToString:ALAssetTypeVideo]) {
NSLog(@"Video");
} else if ([assetType isEqualToString:ALAssetTypeUnknown]) {
NSLog(@"Unknown AssetType");
}
NSDictionary *assetUrls = [result valueForProperty:ALAssetPropertyURLs];
NSUInteger assetCounter = 0;
for (NSString *assetURLKey in assetUrls) {
NSLog(@"Asset URL %lu = %@",
(unsigned long)assetCounter, [assetUrls objectForKey:assetURLKey]);
assetCounter++;
}
NSLog(@"Representation Size = %lld", [[result defaultRepresentation] size]);
}];
}
failureBlock:^(NSError *error) {
NSLog(@"枚舉相冊分組失敗");
}];
遍歷過程中有兩點值得留意:stop 是提前終止遍歷的開關,找到目標後把它置為 YES 即可跳出;另外整個枚舉是異步的,回調可能發生在任意隊列,涉及 UI 更新時務必切回主線程。
保存的核心思路是:先把內容落地成本地臨時文件,再通過文件路徑轉存進相冊。ALAssetsLibrary 提供了下面這組 API:
// 保存 CGImage,並顯式指定方向
- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef
orientation:(ALAssetOrientation)orientation
completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
// 保存 CGImage,同時帶上 metadata(需在 metadata 中指定 orientation 鍵才能保留方向)
- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef
metadata:(NSDictionary *)metadata
completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
// 保存 NSData,能完整保留原始圖片信息
// 若 data 自帶 metadata 與傳入的 metadata 衝突,以傳入的字典為準
- (void)writeImageDataToSavedPhotosAlbum:(NSData *)imageData
metadata:(NSDictionary *)metadata
completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
// 保存視頻,參數是本地文件的 file URL
- (void)writeVideoAtPathToSavedPhotosAlbum:(NSURL *)videoPathURL
completionBlock:(ALAssetsLibraryWriteVideoCompletionBlock)completionBlock;
選型很簡單:手上是 UIImage 實例,用前兩個更方便;手上是從臨時文件讀出的原始數據,用第三個能最大限度保留信息(包含 EXIF);視頻則只能走第四個。
- (void)saveImage:(UIImage *)image {
ALAssetsLibrary *assetsLibrary = [[ALAssetsLibrary alloc] init];
[assetsLibrary writeImageToSavedPhotosAlbum:[image CGImage]
orientation:(ALAssetOrientation)image.imageOrientation
completionBlock:^(NSURL *assetURL, NSError *error) {
if (error) {
NSLog(@"保存失敗:%@", error);
} else {
NSLog(@"保存成功");
}
}];
}
- (void)save:(NSString *)urlString {
ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init];
[library writeVideoAtPathToSavedPhotosAlbum:[NSURL fileURLWithPath:urlString]
completionBlock:^(NSURL *assetURL, NSError *error) {
if (error) {
NSLog(@"保存視頻失敗:%@", error);
} else {
NSLog(@"保存視頻成功");
}
}];
}
這個方法在調試中格外有用——把 App 工程內置的視頻寫入模擬器相冊,省去了手動拖文件的麻煩。
第一,無論讀還是寫,都要處理權限。始終把 error 分支寫完整,並在 Info.plist 中配置 NSPhotoLibraryUsageDescription(讀寫都涉及)與 NSCameraUsageDescription(拍照錄像),否則 iOS 10 之後會直接崩潰。
第二,ALAssetsLibrary 這一套已經是舊 API。iOS 9 起蘋果推出了 Photos 框架(PHAsset、PHFetchResult、PHPhotoLibrary),它支持 iCloud 相冊、更好的內存管理與異步請求調度。新項目應直接採用 Photos 框架,ALAssets 系列僅適用於維護老代碼。