「儲存到相簿」是社群、相機類 App 幾乎都有的功能。實作上可以分成兩個層次:最簡單的是用系統 API 存進「相機膠卷」,進階一點則是自建相簿,把圖片歸類到指定名稱的相簿裡。本文把兩種方式都走一遍。
我們要存的是 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(@"save success");
} else {
NSLog(@"save failed");
}
}
用 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];
[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];
[alert show];
}];
思路是:先確認相簿存在,不存在就建立;再把圖片寫入相機膠卷取得 assetURL;最後用該 URL 找到 asset 並加入目標相簿。
#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 haveHDRGroup = NO;
for (ALAssetsGroup *gp in groups) {
NSString *name = [gp valueForProperty:ALAssetsGroupPropertyName];
if ([name isEqualToString:@"iOSDevTip"]) {
haveHDRGroup = YES;
}
}
if (!haveHDRGroup) {
[assetsLibrary addAssetsGroupAlbumWithName:@"iOSDevTip"
resultBlock:^(ALAssetsGroup *group) {
[groups addObject:group];
} failureBlock:nil];
haveHDRGroup = YES;
}
}
};
[assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAlbum usingBlock:listGroupBlock failureBlock:nil];
[self saveToAlbumWithMetadata:nil
imageData:UIImagePNGRepresentation(self.image)
customAlbumName:@"iOSDevTip"
completionBlock:^{
// 新增成功的處理
}
failureBlock:^(NSError *error) {
// 彈窗要在主線程執行,否則不會顯示
dispatch_async(dispatch_get_main_queue(), ^{
// 常見原因是使用者拒絕權限
if ([error.localizedDescription rangeOfString:@"User denied access"].location != NSNotFound ||
[error.localizedDescription rangeOfString:@"用戶拒絕訪問"].location != NSNotFound) {
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:error.localizedDescription
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(); }
}
}];
}
最後提醒:新專案請優先使用 Photos.framework(PHPhotoLibrary)取代 ALAssetsLibrary,後者已被蘋果標記為 deprecated;同時别忘了在 Info.plist 補上 NSPhotoLibraryAddUsageDescription 或 NSPhotoLibraryUsageDescription,否則會直接 crash。