一、引言

       UIImagePickerController是系统封装好的一个导航视图控制器，使用其开发者可以十分方便的进行相机相册相关功能的调用。UIImagePickerController继承于UINavigationController，其通过代理的方式将用户获取的图片或者视频文件传入给开发者。

二、UIImagePickerController中属性与方法的应用

       在使用UIImagePickerController之前，应该先判断设备做支持的媒体文件获取类型，使用如下方法进行判断：

//判断是否支持某个数据提供类型

/*

UIImagePickerControllerSourceType枚举定义如下:

typedef NS_ENUM(NSInteger, UIImagePickerControllerSourceType) {

   //系统图库

   UIImagePickerControllerSourceTypePhotoLibrary,

   //相机

   UIImagePickerControllerSourceTypeCamera,

   //系统相册

   UIImagePickerControllerSourceTypeSavedPhotosAlbum

} __TVOS_PROHIBITED;

*/

+ (BOOL)isSourceTypeAvailable:(UIImagePickerControllerSourceType)sourceType;

//判断某个数据提供者所支持的文件格式

/*

文件格式定义在<MobileCoreServices/MobileCoreServices.h>框架中

*/

+ (nullable NSArray<NSString *> *)availableMediaTypesForSourceType:(UIImagePickerControllerSourceType)sourceType;

//判断所支持的相机设备

/*

typedef NS_ENUM(NSInteger, UIImagePickerControllerCameraDevice) {

   //前置摄像头

   UIImagePickerControllerCameraDeviceRear,

   //后置摄像头

   UIImagePickerControllerCameraDeviceFront

} __TVOS_PROHIBITED;

*/

+ (BOOL)isCameraDeviceAvailable:(UIImagePickerControllerCameraDevice)cameraDevice                   NS_AVAILABLE_IOS(4_0);

//判断对闪光灯的支持

+ (BOOL)isFlashAvailableForCameraDevice:(UIImagePickerControllerCameraDevice)cameraDevice           NS_AVAILABLE_IOS(4_0);

//判断相机设备支持的媒体模式

/*

返回值为如下枚举：

typedef NS_ENUM(NSInteger, UIImagePickerControllerCameraCaptureMode) {

   //照片模式

   UIImagePickerControllerCameraCaptureModePhoto,

   //视频模式

   UIImagePickerControllerCameraCaptureModeVideo

} __TVOS_PROHIBITED;

*/

+ (nullable NSArray<NSNumber *> *)availableCaptureModesForCameraDevice:(UIImagePickerControllerCameraDevice)cameraDevice NS_AVAILABLE_IOS(4_0);

上面提到的定义于<MobileCoreServices/MobileCoreServices.h>框架中的文件类型，列举如下：

//图片类型

extern const CFStringRef kUTTypeImage                                __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

//JPEG格式

extern const CFStringRef kUTTypeJPEG                                 __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

//JPEG2000格式

extern const CFStringRef kUTTypeJPEG2000                             __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeTIFF                                 __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypePICT                                 __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeGIF                                  __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypePNG                                  __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeQuickTimeImage                       __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeAppleICNS                            __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeBMP                                  __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeICO                                  __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeRawImage                             __OSX_AVAILABLE_STARTING(__MAC_10_10,__IPHONE_8_0);

extern const CFStringRef kUTTypeScalableVectorGraphics               __OSX_AVAILABLE_STARTING(__MAC_10_10,__IPHONE_8_0);

extern const CFStringRef kUTTypeLivePhoto                            __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_9_1);

//视频格式

extern const CFStringRef kUTTypeAudiovisualContent                   __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeMovie                                __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeVideo                                __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeAudio                                __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeQuickTimeMovie                       __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeMPEG                                 __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeMPEG2Video                           __OSX_AVAILABLE_STARTING(__MAC_10_10,__IPHONE_8_0);

extern const CFStringRef kUTTypeMPEG2TransportStream                 __OSX_AVAILABLE_STARTING(__MAC_10_10,__IPHONE_8_0);

extern const CFStringRef kUTTypeMP3                                  __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeMPEG4                                __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeMPEG4Audio                           __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeAppleProtectedMPEG4Audio             __OSX_AVAILABLE_STARTING(__MAC_10_4,__IPHONE_3_0);

extern const CFStringRef kUTTypeAppleProtectedMPEG4Video             __OSX_AVAILABLE_STARTING(__MAC_10_10,__IPHONE_8_0);

extern const CFStringRef kUTTypeAVIMovie                             __OSX_AVAILABLE_STARTING(__MAC_10_10,__IPHONE_8_0);

extern const CFStringRef kUTTypeAudioInterchangeFileFormat           __OSX_AVAILABLE_STARTING(__MAC_10_10,__IPHONE_8_0);

extern const CFStringRef kUTTypeWaveformAudio                        __OSX_AVAILABLE_STARTING(__MAC_10_10,__IPHONE_8_0);

extern const CFStringRef kUTTypeMIDIAudio                            __OSX_AVAILABLE_STARTING(__MAC_10_10,__IPHONE_8_0);

CFStringRef与NSString类型的转换，可以使用如下方法：

NSString * str = (__bridge NSString*)kUTTypeMovie;

UIImagePickerController中更多属性与方法解析如下：

//设置代理

@property(nullable,nonatomic,weak)      id <UINavigationControllerDelegate, UIImagePickerControllerDelegate> delegate;

//设置书体提供者类型 默认为图库

@property(nonatomic)           UIImagePickerControllerSourceType     sourceType;

//设置所需要的数据类型，需要设置为系统定义的文件类型字符串数组 默认为kUTTypeImage

@property(nonatomic,copy)      NSArray<NSString *>                   *mediaTypes;

//设置是否允许编辑图片 设置为YES，则用户选择图片时可以编辑裁剪图片

@property(nonatomic)           BOOL                                  allowsEditing;

//设置媒体文件的最大时长 默认为10分钟

@property(nonatomic)           NSTimeInterval                        videoMaximumDuration;

//设置媒体文件的质量 枚举如下：

/*

typedef NS_ENUM(NSInteger, UIImagePickerControllerQualityType) {

   UIImagePickerControllerQualityTypeHigh = 0,       // 高质量

   UIImagePickerControllerQualityTypeMedium = 1,     // 中等质量

   UIImagePickerControllerQualityTypeLow = 2,         // 低质量

   UIImagePickerControllerQualityType640x480 NS_ENUM_AVAILABLE_IOS(4_0) = 3,    

   UIImagePickerControllerQualityTypeIFrame1280x720 NS_ENUM_AVAILABLE_IOS(5_0) = 4,

   UIImagePickerControllerQualityTypeIFrame960x540 NS_ENUM_AVAILABLE_IOS(5_0) = 5,

} __TVOS_PROHIBITED;

*/

@property(nonatomic)           UIImagePickerControllerQualityType    videoQuality;

//设置是否显示相机控制界面

@property(nonatomic)           BOOL                                  showsCameraControls;

//自定义的拍照界面 其会覆盖在原拍照界面上

@property(nullable, nonatomic,strong) __kindof UIView                *cameraOverlayView  NS_AVAILABLE_IOS(3_1);  

//设置拍照界面的transform

@property(nonatomic)           CGAffineTransform                     cameraViewTransform ;

//拍照

- (void)takePicture NS_AVAILABLE_IOS(3_1);  

//进行视频捕获

- (BOOL)startVideoCapture NS_AVAILABLE_IOS(4_0);

//停止视频捕获

- (void)stopVideoCapture  NS_AVAILABLE_IOS(4_0);

//设置相机捕获模式 照片或视频

@property(nonatomic) UIImagePickerControllerCameraCaptureMode cameraCaptureMode;

//设置相机设备 前置或后置摄像头

@property(nonatomic) UIImagePickerControllerCameraDevice      cameraDevice;

//设置闪光灯模式

/*

typedef NS_ENUM(NSInteger, UIImagePickerControllerCameraFlashMode) {

   UIImagePickerControllerCameraFlashModeOff  = -1, //关闭

   UIImagePickerControllerCameraFlashModeAuto = 0,  //自动

   UIImagePickerControllerCameraFlashModeOn   = 1   //开启

} __TVOS_PROHIBITED;

*/

@property(nonatomic) UIImagePickerControllerCameraFlashMode   cameraFlashMode;

三、UIImagePickerControllerDelegate中方法解析

//相机拍照完成或者从图库相册选择相片完成后触发的回调方法 editingInfo字典中将传入编辑信息

- (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingImage:(UIImage *)image editingInfo:(nullable NSDictionary<NSString *,id> *)editingInfo NS_DEPRECATED_IOS(2_0, 3_0);

//相机录像或者从图库相册选择视频完成后触发的回调方法 info字典中是具体信息

- (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary<NSString *,id> *)info;

//ImagePickerController取消选择是回调的方法

- (void)imagePickerControllerDidCancel:(UIImagePickerController *)picker;

上面方法中的编辑字典与信息字典中，约定好了一些键值对，开发者可以通过相应的键获取需要的信息，规则如下：

//这个键对应NSString类型的值 意义为媒体文件的格式

UIKIT_EXTERN NSString *const UIImagePickerControllerMediaType;

//这个键对应UIImage类型的值 意义为获取的原始图片

UIKIT_EXTERN NSString *const UIImagePickerControllerOriginalImage;

//这个件对应UIIImage类型的值 意义为获取编辑后的图片

UIKIT_EXTERN NSString *const UIImagePickerControllerEditedImage;

//这个键对应一个NSValue值 可以转为CGRect类型 意义为编辑的图片范围

UIKIT_EXTERN NSString *const UIImagePickerControllerCropRect;

//这个键对应媒体文件的URL

UIKIT_EXTERN NSString *const UIImagePickerControllerMediaURL;

//这个键对应图库中的URL

UIKIT_EXTERN NSString *const UIImagePickerControllerReferenceURL;

//这个键对应一个NSDictionary 里面存放媒体数据

UIKIT_EXTERN NSString *const UIImagePickerControllerMediaMetadata;

//现场图片数据 相机捕捉图片时会记录声音

UIKIT_EXTERN NSString *const UIImagePickerControllerLivePhoto;

四、对捕获的图片与视频进行持久化

       系统也提供了对相机照片和视频进行存储的方式，列举如下：

//将图片数据存储到相册

void UIImageWriteToSavedPhotosAlbum(UIImage *image, __nullable id completionTarget, __nullable SEL completionSelector, void * __nullable contextInfo);

//将视频保存到相册

BOOL UIVideoAtPathIsCompatibleWithSavedPhotosAlbum(NSString *videoPath);

void UISaveVideoAtPathToSavedPhotosAlbum(NSString *videoPath, __nullable id completionTarget, __nullable SEL completionSelector, void * __nullable contextInfo);