如果只是「一次挑一張圖或拍一段影片」,UIImagePickerController 就足夠了。但需求經常是一次批次取出相簿裡的多個素材,這時就得換用 AssetsLibrary 這套 API。
先認識三個核心類別:
ALAssetsLibrary:代表整個照片庫,建立一個實例就等於拿到相簿的句柄。
ALAssetsGroup:相簿的分組,可透過 ALAssetsLibrary 的實例逐一取得。
ALAsset:代表一筆資產,也就是一張照片或一段影片,可從它取得縮圖、原圖等表示形式。
另一個關鍵是 block。枚舉分組與枚舉資產本質上都是非同步的,而 block 讓我們能把巢狀的結果收在同一個方法裡處理,不必拆成一串 delegate 回呼。
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(@"Unknow AssetType");
}
// 取得資產的 URL 字典並逐一輸出
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(@"Enumerate the asset groups failed.");
}];
實務上有兩點要留意:一是枚舉 block 可能在背景執行緒回呼,更新 UI 前請切回主執行緒;二是若 `result` 為 nil(枚舉結束時會再呼叫一次),使用前應先判空。
寫入相簿的 API 分為圖片與影片兩大類:
// 以 CGImageRef 加上方向寫入,方向需自行指定
- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef
orientation:(ALAssetOrientation)orientation
completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
// 以 CGImageRef 搭配 metadata 寫入,可保留拍攝資訊
- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef
metadata:(NSDictionary *)metadata
completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
// 直接寫入原始 image data,能完整保留圖片本身的資訊
// 若 metadata 與圖片內嵌資料衝突,會以 metadata 為準
- (void)writeImageDataToSavedPhotosAlbum:(NSData *)imageData
metadata:(NSDictionary *)metadata
completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
// 寫入影片,參數是本地檔案的 URL
- (void)writeVideoAtPathToSavedPhotosAlbum:(NSURL *)videoPathURL
completionBlock:(ALAssetsLibraryWriteVideoCompletionBlock)completionBlock;
選擇建議:手上是 UIImage 實例時,前兩個方法最方便;已經有從檔案讀出的 NSData 時,用第三個可以保留最完整的資訊;影片則一律走第四個,且必須先落地成本地檔案。
儲存圖片:
- (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(@"Save image fail:%@", error);
} else {
NSLog(@"Save image succeed.");
}
}];
}
儲存影片(把專案內的影片寫入相簿,方便在模擬器中測試):
- (void)save:(NSString *)urlString {
ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init];
[library writeVideoAtPathToSavedPhotosAlbum:[NSURL fileURLWithPath:urlString]
completionBlock:^(NSURL *assetURL, NSError *error) {
if (error) {
NSLog(@"Save video fail:%@", error);
} else {
NSLog(@"Save video succeed.");
}
}];
}
最後提醒:ALAssetsLibrary 這套 API 自 iOS 9 起已被標記為不建議使用,新專案請改用 Photos 框架(PHPhotoLibrary 與 PHAssetCollection),除了能批次讀寫,也支援更細緻的權限與資源管理;同時別忘了在 Info.plist 中補上相簿存取用途說明字串。