幾乎每個 App 都會有「選一張照片」的需求。本文先完整說明系統提供的 UIImagePickerController,再示範如何實作一個類似微信的小功能:抓取相簿裡最新那張照片。
iOS 取得影像有三種途徑:
對應的 sourceType 列舉值如下:
enum {
UIImagePickerControllerSourceTypePhotoLibrary, // 圖庫
UIImagePickerControllerSourceTypeCamera, // 相機
UIImagePickerControllerSourceTypeSavedPhotosAlbum // 相簿
};
使用之前最好先確認裝置是否支援該來源——模擬器沒有相機,這是最常踩的坑:
if ([UIImagePickerController isSourceTypeAvailable:UIImagePickerControllerSourceTypeCamera]) {
NSLog(@"支援相機");
}
if ([UIImagePickerController isSourceTypeAvailable:UIImagePickerControllerSourceTypePhotoLibrary]) {
NSLog(@"支援圖庫");
}
if ([UIImagePickerController isSourceTypeAvailable:UIImagePickerControllerSourceTypeSavedPhotosAlbum]) {
NSLog(@"支援相簿");
}
使用 UIImagePickerController 大致四個步驟:初始化 → 設定來源 → 設定代理 →(需要裁剪時)開啟 allowsEditing。
- (void)viewDidLoad {
[super viewDidLoad];
picker = [[UIImagePickerController alloc] init];
picker.view.backgroundColor = [UIColor orangeColor];
picker.sourceType = UIImagePickerControllerSourceTypeCamera;
picker.delegate = self;
picker.allowsEditing = YES;
}
初始化只是準備好物件,真正要用的時候才把它 present 出來:
[self presentViewController:picker animated:YES completion:nil];
UIImagePickerControllerDelegate 裡有三個方法,其中一個在 iOS 3.0 已被棄用,實際會用到的是這兩個:
// 使用者完成選取 - (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary *)info; // 使用者取消選取 - (void)imagePickerControllerDidCancel:(UIImagePickerController *)picker;
選取的內容全在 info 這個字典裡,常見的鍵有:
UIImagePickerControllerMediaType — 使用者選的是照片還是影片UIImagePickerControllerOriginalImage — 原始影像UIImagePickerControllerEditedImage — 裁剪後的影像(需 allowsEditing)UIImagePickerControllerCropRect — 裁剪區域UIImagePickerControllerMediaURL — 媒體的 URLUIImagePickerControllerReferenceURL — 原始素材的 URLUIImagePickerControllerMediaMetadata — 拍攝資訊,僅在來源為相機時有效提醒一個實務細節:取出結果後記得呼叫 dismissViewControllerAnimated:completion:,否則 picker 會一直蓋在畫面上。
需求是這樣的:使用者點擊「+」時,若最近拍過照,就在入口處顯示縮圖。
思路:取得相簿列表 → 取出最新儲存的那一張 → 用它的建立時間與當前時間比對 → 若落在自訂的時間窗內(例如 5 分鐘),就顯示提示。判斷式很單純:當前時間 - 照片時間 ≤ 時間間隔。
由於這屬於 ALAssetsLibrary 的讀取能力,就用它寫一個分類。要注意的是這個 API 在 iOS 9 之後已被標記為過時,這裡先封裝起來,日後只要換一個實作就能平滑遷移。
// ALAssetsLibrary+WJ.h #import <AssetsLibrary/AssetsLibrary.h> @interface ALAssetsLibrary (WJ) /** * 取得最新一張圖片 */ - (void)latestAsset:(void (^_Nullable)(ALAsset * _Nullable asset, NSError *_Nullable error))block; @end
// ALAssetsLibrary+WJ.m
#import "ALAssetsLibrary+WJ.h"
@implementation ALAssetsLibrary (WJ)
- (void)latestAsset:(void (^)(ALAsset * _Nullable, NSError *_Nullable))block {
[self enumerateGroupsWithTypes:ALAssetsGroupSavedPhotos usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
if (group) {
[group setAssetsFilter:[ALAssetsFilter allPhotos]];
// 關鍵是 NSEnumerationReverse:反序遍歷,第一個就是最新的
[group enumerateAssetsWithOptions:NSEnumerationReverse usingBlock:^(ALAsset *result, NSUInteger index, BOOL *stop) {
if (result) {
if (block) {
block(result, nil);
}
*stop = YES; // 拿到一張就停
}
}];
*stop = YES;
}
} failureBlock:^(NSError *error) {
if (error) {
if (block) {
block(nil, error);
}
}
}];
}
@end
PhotoKit 從 iOS 8 就開始提供,也是目前的正確選擇。寫法比 AssetsLibrary 簡潔許多:
// PHAsset+WJ.h #import <Photos/Photos.h> @interface PHAsset (WJ) /** 取得最新一張圖片 */ + (PHAsset *)latestAsset; @end
// PHAsset+WJ.m
#import "PHAsset+WJ.h"
@implementation PHAsset (WJ)
+ (PHAsset *)latestAsset {
// 建立排序條件:以建立時間遞減
PHFetchOptions *options = [[PHFetchOptions alloc] init];
options.sortDescriptors = @[[NSSortDescriptor sortDescriptorWithKey:@"creationDate" ascending:NO]];
PHFetchResult *assetsFetchResults = [PHAsset fetchAssetsWithOptions:options];
return [assetsFetchResults firstObject];
}
@end
取得 PHAsset 之後,照片的拍攝時間可從 asset.creationDate 讀到(ALAsset 則是 asset.date),拿來和 [NSDate date] 相減即可判斷是否在時間窗內。
另外要提醒的是,不論走哪條路,存取相簿都必須在 Info.plist 中宣告 NSPhotoLibraryUsageDescription,否則 App 會直接 crash;而 PhotoKit 還需要使用者授權,記得處理 PHAuthorizationStatus 被拒絕的情況。