自 iOS 8 起,蘋果推出了全新的 Photos.framework,取代舊有的 AssetsLibrary,成為操作相簿的首選方案。本文將實作三個常見功能:建立自訂相簿、把圖片保存到自訂相簿,以及搜尋所有相簿中的圖片。
整個流程分為兩大步:先檢查權限,再把圖片存入相機膠卷並取得其資產標識,最後將該資產加入自訂相簿。這裡大量使用 performChanges: 來包裹變更操作,並透過 completionHandler 回呼處理結果。
/** 保存圖片到相簿 */
- (IBAction)saveImage {
PHAuthorizationStatus status = [PHPhotoLibrary authorizationStatus];
if (status == PHAuthorizationStatusDenied) {
NSLog(@"請到【設定-隱私-照片】打開訪問開關");
} else if (status == PHAuthorizationStatusRestricted) {
NSLog(@"無法訪問相簿");
} else {
// 保存相片的標識
__block NSString *assetId = nil;
[[PHPhotoLibrary sharedPhotoLibrary] performChanges:^{
// 保存相片到相機膠卷,並返回標識
assetId = [PHAssetCreationRequest creationRequestForAssetFromImage:
[UIImage imageNamed:@"logo"]].placeholderForCreatedAsset.localIdentifier;
} completionHandler:^(BOOL success, NSError * _Nullable error) {
if (!success) { NSLog(@"保存失敗:%@", error); return; }
// 根據標識獲得相片對象
PHAsset *asset = [PHAsset fetchAssetsWithLocalIdentifiers:@[assetId] options:nil].lastObject;
// 拿到自定義的相簿對象
PHAssetCollection *collection = [self collection];
if (collection == nil) return;
// 保存相片到自定義相簿中
[[PHPhotoLibrary sharedPhotoLibrary] performChanges:^{
[[PHAssetCollectionChangeRequest changeRequestForAssetCollection:collection]
addAssets:@[asset]];
} completionHandler:^(BOOL success, NSError * _Nullable error) {
NSLog(success ? @"保存成功" : @"保存失敗:%@", error);
}];
}];
}
}
搜尋的關鍵是理解 PHAssetCollection 的兩種型別:PHAssetCollectionTypeAlbum 對應使用者自建相簿,PHAssetCollectionTypeSmartAlbum 則對應系統智慧相簿(如相機膠卷)。我們需要分別遍歷這兩類相簿。
/** 查詢所有的圖片 */
- (IBAction)searchAllImages {
// 遍歷所有的自定義相簿
PHFetchResult<PHAssetCollection *> *collectionResult0 =
[PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum
subtype:PHAssetCollectionSubtypeAlbumRegular options:nil];
for (PHAssetCollection *collection in collectionResult0) {
[self searchAllImagesInCollection:collection];
}
// 獲得相機膠卷的圖片
PHFetchResult<PHAssetCollection *> *collectionResult1 =
[PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeSmartAlbum
subtype:PHAssetCollectionSubtypeAlbumRegular options:nil];
for (PHAssetCollection *collection in collectionResult1) {
if (![collection.localizedTitle isEqualToString:@"Camera Roll"]) continue;
[self searchAllImagesInCollection:collection];
break;
}
}
而搜尋單一相簿內部圖片的邏輯,則透過 PHImageManager 請求圖片。這裡把 synchronous 設為 YES 以同步方式取得,並過濾掉非圖片類型的資產:
/** 查詢某個相冊裡面的所有圖片 */
- (void)searchAllImagesInCollection:(PHAssetCollection *)collection {
// 採用同步獲取圖片(只獲得一次圖片)
PHImageRequestOptions *imageOptions = [[PHImageRequestOptions alloc] init];
imageOptions.synchronous = YES;
NSLog(@"相冊名字:%@", collection.localizedTitle);
// 遍歷這個相冊中的所有圖片
PHFetchResult<PHAsset *> *assetResult = [PHAsset fetchAssetsInAssetCollection:collection options:nil];
for (PHAsset *asset in assetResult) {
// 過濾非圖片
if (asset.mediaType != PHAssetMediaTypeImage) continue;
// 圖片原尺寸
CGSize targetSize = CGSizeMake(asset.pixelWidth, asset.pixelHeight);
// 請求圖片
[[PHImageManager defaultManager] requestImageForAsset:asset targetSize:targetSize
contentMode:PHImageContentModeDefault options:imageOptions
resultHandler:^(UIImage * _Nullable result, NSDictionary * _Nullable info) {
NSLog(@"圖片:%@", result);
}];
}
}
透過以上三段程式碼,你就掌握了 Photos.framework 最核心的相簿操作能力。掌握 PHAsset、PHAssetCollection 與 PHImageManager 的協作,即可應對絕大多數相冊相關的開發需求。