「儲存到相簿」幾乎是每個社交類 App 的標配功能。聽起來簡單,但實作時會遇到幾個關卡:怎麼存、怎麼知道存成功了、使用者關閉權限時該怎麼辦、能不能存到自己的相簿裡。本文依序處理這四件事。
我們要保存的是 UIImage,所以先準備一張圖並展示:
#define SCREEN [UIScreen mainScreen].bounds.size self.image = [UIImage imageNamed:@"iOSDevTip"]; UIImageView *imageView = [[UIImageView alloc] initWithFrame:CGRectMake((SCREEN.width - 300) / 2, 70, 300, 150)]; imageView.image = self.image; [self.view addSubview:imageView];
UIButton *button = [[UIButton alloc] init];
button.frame = CGRectMake(100, 300, SCREEN.width - 200, 40);
[button addTarget:self action:@selector(actionClick:) forControlEvents:UIControlEventTouchUpInside];
[button setTitleColor:[UIColor blueColor] forState:UIControlStateNormal];
[button setBackgroundColor:[UIColor orangeColor]];
[button setTitle:@"SavePhoto" forState:UIControlStateNormal];
[self.view addSubview:button];
- (void)actionClick:(UIButton *)button {
// 在這裡觸發儲存
}
UIImageWriteToSavedPhotosAlbum(self.image, self, @selector(image:didFinishSavingWithError:contextInfo:), NULL);
這個函式是非同步的,成功或失敗都會透過你指定的回呼方法回報:
// 指定回呼方法
- (void)image:(UIImage *)image didFinishSavingWithError:(NSError *)error contextInfo:(void *)contextInfo {
if (!error) {
NSLog(@"儲存成功");
} else {
NSLog(@"儲存失敗");
}
}
方法簽名必須與此完全一致,拼錯或參數有異都不會被呼叫——這是新手最常卡住的地方。
系統相冊往往被使用者塞滿幾千張照片,把 App 的產出歸到自己專屬的相簿裡,對使用者友善得多。以下使用 ALAssetsLibrary 來實作。
ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init];
[library addAssetsGroupAlbumWithName:@"test" resultBlock:^(ALAssetsGroup *group) {
// 建立相簿成功
} failureBlock:^(NSError *error) {
// 失敗
}];
注意這個方法寫入的是系統相冊,不是自建相簿:
ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init];
[library writeImageToSavedPhotosAlbum:image.CGImage orientation:(ALAssetOrientation)image.imageOrientation completionBlock:^(NSURL *assetURL, NSError *error) {
if (error) {
// 失敗
} else {
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"儲存成功" message:nil delegate:nil cancelButtonTitle:@"確定" otherButtonTitles:nil, nil];
[alert show];
}
}];
如果使用者在設定裡關掉了相冊權限,儲存必然失敗。若你不做任何處理,使用者只會覺得「這 App 壞了」,不會知道是權限問題。因此務必在失敗時給出明確指引。
取得權限狀態有兩個自然時機:建立相簿失敗與儲存照片失敗。以建立相簿為例:
ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init];
[library addAssetsGroupAlbumWithName:@"test" resultBlock:^(ALAssetsGroup *group) {
// 建立相簿成功
} failureBlock:^(NSError *error) {
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"儲存失敗"
message:@"請開啟 設定 - 隱私 - 照片 進行設定"
delegate:nil
cancelButtonTitle:@"確定"
otherButtonTitles:nil, nil];
[alert show];
}];
更進一步的做法是主動跳到系統設定頁,讓使用者不必自己找路徑,轉換率會明顯提高。
下面這段把整個流程串起來:先確認相簿存在(不存在就建立),再把圖片寫入系統相冊,接著取得該資產並加入自建相簿。這段程式碼在網路上流傳甚廣,實測可用:
#pragma mark - 建立相冊
- (void)createAlbum {
ALAssetsLibrary *assetsLibrary = [[ALAssetsLibrary alloc] init];
NSMutableArray *groups = [[NSMutableArray alloc] init];
ALAssetsLibraryGroupsEnumerationResultsBlock listGroupBlock = ^(ALAssetsGroup *group, BOOL *stop) {
if (group) {
[groups addObject:group];
} else {
BOOL haveAlbum = NO;
for (ALAssetsGroup *gp in groups) {
NSString *name = [gp valueForProperty:ALAssetsGroupPropertyName];
if ([name isEqualToString:@"iOSDevTip"]) {
haveAlbum = YES;
}
}
if (!haveAlbum) {
[assetsLibrary addAssetsGroupAlbumWithName:@"iOSDevTip"
resultBlock:^(ALAssetsGroup *group) {
[groups addObject:group];
} failureBlock:nil];
}
}
};
[assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAlbum usingBlock:listGroupBlock failureBlock:nil];
[self saveToAlbumWithMetadata:nil
imageData:UIImagePNGRepresentation(self.image)
customAlbumName:@"iOSDevTip"
completionBlock:^{
// 加入成功
}
failureBlock:^(NSError *error) {
// 回到主線程彈出提示,否則在背景佇列上 alert 不會顯示
dispatch_async(dispatch_get_main_queue(), ^{
// 加入失敗多半是使用者拒絕權限,這裡針對這種情況判斷
NSString *desc = error.localizedDescription;
if ([desc rangeOfString:@"User denied access"].location != NSNotFound
|| [desc rangeOfString:@"用戶拒絕訪問"].location != NSNotFound) {
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:desc
message:error.localizedFailureReason
delegate:nil
cancelButtonTitle:NSLocalizedString(@"ok", nil)
otherButtonTitles:nil];
[alert show];
}
});
}];
}
- (void)saveToAlbumWithMetadata:(NSDictionary *)metadata
imageData:(NSData *)imageData
customAlbumName:(NSString *)customAlbumName
completionBlock:(void (^)(void))completionBlock
failureBlock:(void (^)(NSError *error))failureBlock {
ALAssetsLibrary *assetsLibrary = [[ALAssetsLibrary alloc] init];
__weak ALAssetsLibrary *weakSelf = assetsLibrary;
// 把已存在的資產加入指定相簿
void (^AddAsset)(ALAssetsLibrary *, NSURL *) = ^(ALAssetsLibrary *assetsLibrary, NSURL *assetURL) {
[assetsLibrary assetForURL:assetURL resultBlock:^(ALAsset *asset) {
[assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
if ([[group valueForProperty:ALAssetsGroupPropertyName] isEqualToString:customAlbumName]) {
[group addAsset:asset];
if (completionBlock) { completionBlock(); }
}
} failureBlock:^(NSError *error) {
if (failureBlock) { failureBlock(error); }
}];
} failureBlock:^(NSError *error) {
if (failureBlock) { failureBlock(error); }
}];
};
[assetsLibrary writeImageDataToSavedPhotosAlbum:imageData metadata:metadata completionBlock:^(NSURL *assetURL, NSError *error) {
if (customAlbumName) {
[assetsLibrary addAssetsGroupAlbumWithName:customAlbumName resultBlock:^(ALAssetsGroup *group) {
if (group) {
[weakSelf assetForURL:assetURL resultBlock:^(ALAsset *asset) {
[group addAsset:asset];
if (completionBlock) { completionBlock(); }
} failureBlock:^(NSError *error) {
if (failureBlock) { failureBlock(error); }
}];
} else {
AddAsset(weakSelf, assetURL);
}
} failureBlock:^(NSError *error) {
AddAsset(weakSelf, assetURL);
}];
} else {
if (completionBlock) { completionBlock(); }
}
}];
}
這裡有兩個值得學的細節:一是用 __weak 避免 block 造成循環參照;二是把 UI 操作明確丟回主線程,因為 ALAssetsLibrary 的回呼可能在背景佇列執行。
ALAssetsLibrary 在 iOS 9 之後已被標記為棄用,取而代之的是 Photos 框架(PHPhotoLibrary、PHAssetCollection、PHAssetChangeRequest)。若你在撰寫新專案,請直接採用 Photos 框架:它支援更細緻的權限層級、iCloud 同步處理,也提供 PHPhotoLibraryChangeObserver 來監聽相冊變化。ALAssets 的寫法在維護舊專案時仍然用得到,理解它背後「先寫入、再歸類」的思路,遷移到新框架時會輕鬆許多。