您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 相機與相簿:UIImagePickerController 完整解析

編輯:iOS 開發綜合

許多應用都需要呼叫裝置的相機拍照或錄影,或從相簿中挑選既有的圖片與影片。這件事在 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.");
    }
}

setSourceType 的三種取值

typedef NS_ENUM(NSInteger, UIImagePickerControllerSourceType) {
    UIImagePickerControllerSourceTypePhotoLibrary,     // 相簿列表
    UIImagePickerControllerSourceTypeCamera,           // 相機
    UIImagePickerControllerSourceTypeSavedPhotosAlbum  // 相機膠卷
};

這三個值決定了叫出來的介面長什麼樣子,也決定了後續能拿到什麼資料。

三、Delegate:接收結果

// 存檔結果回调
- (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 部分完全沿用上一節的實作,不必重寫——這正是把能力檢查與結果處理分開撰寫的價值。

五、info 字典裡有什麼

同一個 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 系列。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved