許多應用都需要呼叫裝置的相機拍照或錄影,或從相簿中挑選既有的圖片與影片。這件事在 iOS 上由 UIImagePickerController 負責,它同時提供了「系統原生的取景介面」與「相簿瀏覽介面」。
不要假設每台裝置都有相機,也不要在不支援的情境下硬叫出介面。以下這組公共方法幾乎每個專案都會用到。
#pragma mark - 相機相關
// 是否有相機
- (BOOL)isCameraAvailable {
return [UIImagePickerController isSourceTypeAvailable:UIImagePickerControllerSourceTypeCamera];
}
// 前置相機是否可用
- (BOOL)isFrontCameraAvailable {
return [UIImagePickerController isCameraDeviceAvailable:UIImagePickerControllerCameraDeviceFront];
}
// 後置相機是否可用
- (BOOL)isRearCameraAvailable {
return [UIImagePickerController isCameraDeviceAvailable:UIImagePickerControllerCameraDeviceRear];
}
// 是否支援指定的媒體類型(拍照或錄影)
- (BOOL)cameraSupportsMedia:(NSString *)paramMediaType
sourceType:(UIImagePickerControllerSourceType)paramSourceType {
if ([paramMediaType length] == 0) return NO;
__block BOOL result = NO;
NSArray *availableMediaTypes =
[UIImagePickerController availableMediaTypesForSourceType:paramSourceType];
[availableMediaTypes enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
if ([obj isEqualToString:paramMediaType]) {
result = YES;
*stop = YES;
}
}];
return result;
}
// 是否支援錄影 / 拍照
- (BOOL)doesCameraSupportShootingVideos {
return [self cameraSupportsMedia:(NSString *)kUTTypeMovie
sourceType:UIImagePickerControllerSourceTypeCamera];
}
- (BOOL)doesCameraSupportTakingPhotos {
return [self cameraSupportsMedia:(NSString *)kUTTypeImage
sourceType:UIImagePickerControllerSourceTypeCamera];
}
#pragma mark - 相簿相關
- (BOOL)isPhotoLibraryAvailable {
return [UIImagePickerController isSourceTypeAvailable:
UIImagePickerControllerSourceTypePhotoLibrary];
}
- (BOOL)canUserPickVideosFromPhotoLibrary {
return [self cameraSupportsMedia:(NSString *)kUTTypeMovie
sourceType:UIImagePickerControllerSourceTypePhotoLibrary];
}
- (BOOL)canUserPickPhotosFromPhotoLibrary {
return [self cameraSupportsMedia:(NSString *)kUTTypeImage
sourceType:UIImagePickerControllerSourceTypePhotoLibrary];
}
- (void)ClickControlAction:(id)sender {
if ([self isCameraAvailable] && [self doesCameraSupportTakingPhotos]) {
UIImagePickerController *controller = [[UIImagePickerController alloc] init];
[controller setSourceType:UIImagePickerControllerSourceTypeCamera];
// 同時允許拍照與錄影
NSString *requiredMediaType = (NSString *)kUTTypeImage;
NSString *requiredMediaType1 = (NSString *)kUTTypeMovie;
[controller setMediaTypes:[NSArray arrayWithObjects:requiredMediaType,
requiredMediaType1, nil]];
[controller setVideoQuality:UIImagePickerControllerQualityTypeHigh];
[controller setVideoMaximumDuration:10.f]; // 最長錄影 10 秒
[controller setAllowsEditing:YES];
[controller setDelegate:self];
[self.navigationController presentViewController:controller animated:YES completion:nil];
} else {
NSLog(@"Camera is not available.");
}
}
typedef NS_ENUM(NSInteger, UIImagePickerControllerSourceType) {
UIImagePickerControllerSourceTypePhotoLibrary, // 相簿列表
UIImagePickerControllerSourceTypeCamera, // 相機
UIImagePickerControllerSourceTypeSavedPhotosAlbum // 相機膠卷
};
這三個值決定了叫出來的介面長什麼樣子,也決定了後續能拿到什麼資料。
// 存檔結果回调
- (void)imageWasSavedSuccessfully:(UIImage *)paramImage
didFinishSavingWithError:(NSError *)paramError
contextInfo:(void *)paramContextInfo {
if (paramError == nil) {
NSLog(@"Image was saved successfully.");
} else {
NSLog(@"Error = %@", paramError);
}
}
// 使用者完成拍攝或選取
- (void)imagePickerController:(UIImagePickerController *)picker
didFinishPickingMediaWithInfo:(NSDictionary *)info {
NSString *mediaType = [info objectForKey:UIImagePickerControllerMediaType];
if ([mediaType isEqualToString:(NSString *)kUTTypeImage]) {
UIImage *theImage = nil;
if ([picker allowsEditing]) {
theImage = [info objectForKey:UIImagePickerControllerEditedImage];
} else {
theImage = [info objectForKey:UIImagePickerControllerOriginalImage];
}
SEL selectorToCall = @selector(imageWasSavedSuccessfully:didFinishSavingWithError:contextInfo:);
UIImageWriteToSavedPhotosAlbum(theImage, self, selectorToCall, NULL);
} else if ([mediaType isEqualToString:(NSString *)kUTTypeMovie]) {
NSURL *mediaURL = [info objectForKey:UIImagePickerControllerMediaURL];
// AssetsLibrary 是 App 與多媒體資料庫之間的橋梁
ALAssetsLibrary *assetsLibrary = [[ALAssetsLibrary alloc] init];
[assetsLibrary writeVideoAtPathToSavedPhotosAlbum:mediaURL
completionBlock:^(NSURL *assetURL, NSError *error) {
if (!error) {
NSLog(@"captured video saved with no error.");
} else {
NSLog(@"error occured while saving the video: %@", error);
}
}];
}
[picker dismissViewControllerAnimated:YES completion:nil];
}
// 使用者取消
- (void)imagePickerControllerDidCancel:(UIImagePickerController *)picker {
[picker dismissViewControllerAnimated:YES completion:nil];
}
這裡的關鍵是 allowsEditing。開啟時,info 字典會多一個 EditedImage 鍵,提供使用者裁剪後的版本;關閉時則只有 OriginalImage。判斷 mediaType 也是必要的,因為同一個 picker 可能同時開放拍照與錄影。
- (void)ClickShowPhotoAction:(id)sender {
if ([self isPhotoLibraryAvailable]) {
UIImagePickerController *controller = [[UIImagePickerController alloc] init];
[controller setSourceType:UIImagePickerControllerSourceTypePhotoLibrary];
NSMutableArray *mediaTypes = [NSMutableArray array];
if ([self canUserPickPhotosFromPhotoLibrary]) {
[mediaTypes addObject:(NSString *)kUTTypeImage];
}
if ([self canUserPickVideosFromPhotoLibrary]) {
[mediaTypes addObject:(NSString *)kUTTypeMovie];
}
[controller setMediaTypes:mediaTypes];
[controller setDelegate:self];
[self.navigationController presentViewController:controller animated:YES completion:nil];
}
}
Delegate 部分完全沿用上一節的實作,不必重寫——這正是把能力檢查與結果處理分開撰寫的價值。
同一個 delegate 方法,會依操作類型回傳不同的內容。
拍攝或選取圖片時,字典大致包含:
{
UIImagePickerControllerMediaType = public.image;
UIImagePickerControllerOriginalImage = <原圖>;
UIImagePickerControllerEditedImage = <裁剪後>;
UIImagePickerControllerCropRect = NSRect: {{0, 405}, {2448, 2449}};
UIImagePickerControllerMediaMetadata = {
DPIHeight = 72; DPIWidth = 72; Orientation = 6;
{Exif} = { FNumber = 2.4; ExposureTime = 0.0588; ISO = 400; ... };
{TIFF} = { Make = Apple; Model = iPhone 4S; ... };
};
}
拍攝或選取影片時:
{
UIImagePickerControllerMediaType = public.movie;
UIImagePickerControllerMediaURL = file:///private/var/.../capturedvideo.MOV;
}
MediaMetadata 這組 EXIF 資訊常被忽略,但它其實很有用:拍攝時間、方位、甚至 GPS 座標都在裡面,做相簿分類或地圖展示時可以直接取用,不必自己維護額外的資料庫。
第一,iOS 11 之後 ALAssetsLibrary 已被 Photos 框架取代,讀寫相簿請改用 PHPhotoLibrary 與 PHAssetChangeRequest。
第二,存取相簿需要 NSPhotoLibraryUsageDescription,若只存檔則需 NSPhotoLibraryAddUsageDescription,缺少對應的 key 會直接 crash。
第三,這個範例使用 MRC 的 release 寫法,在 ARC 專案下請移除;而 presentModalViewController: 與 dismissModalViewControllerAnimated: 也應改為 presentViewController 與 dismissViewControllerAnimated 系列。