UIImagePikerController 浅析
原文鏈接:http://www.jianshu.com/p/2ac85aca4468
?
UIImagePickerController是iOS系統提供的和系統的相冊和相機交互的一個類,可以用來獲取相冊的照片,也可以調用系統的相機拍攝照片或者視頻。該類的繼承結構是:
UIImagePickerController-->UINavigationController-->UIViewController-->UIResponder-->NSObject
官方文檔中對于該類的說明是:
該類只支持豎屏模式,為了保證該類被原樣使用,它不支持子類,并且它的視圖層次是私有的不能被修改,只支持自定義cameraOverlayView屬性來展示更多信息以及和用戶的交互。
由于該類繼承自UINavgationController,所以在使用過程中一般實現UIImagePickerControllerDelegate和UINavigationControllerDelegate這兩個代理,可以利用navgation的push 和pop操作自定義界面實現更復雜的交互效果。下面具體分析該類的一些方法和屬性.
-
屬性
@property(nullable,nonatomic,weak) id <UINavigationControllerDelegate, UIImagePickerControllerDelegate> delegate;
該對象的代理需要實現UINavigationControllerDelegate和UIImagePickerControllerDelegate協議,nullable是xcode6.3之后引入的nullability annotations特性,主要用于在OC和swift之間的轉換。這一特性主要包含兩個新的類型注釋nullable和nonnull,用于表示對象是否可以是NULL或nil(具體內容請參考Xcode特性之nullability annotayions)
@property(nonatomic) UIImagePickerControllerSourceType sourceType; // default value is UIImagePickerControllerSourceTypePhotoLibrary.sourceType用于指定要訪問的系統的媒體類型。UIImagePickerControllerSourceType支持以下3種枚舉類型,默認值是圖片庫
typedef NS_ENUM(NSInteger, UIImagePickerControllerSourceType) {UIImagePickerControllerSourceTypePhotoLibrary, UIImagePickerControllerSourceTypeCamera, UIImagePickerControllerSourceTypeSavedPhotosAlbum };PhotoLibrary代表系統照片應用對應的相薄,包含照片流和其它自定義的相冊,PhotosAlbum則對應系統照片應用的照片,包含用設備拍攝的所有照片流。Camera則代表相機的攝像頭。
@property(nonatomic,copy) NSArray<NSString *> *mediaTypes;mediaTypes用于設置相機支持的功能,拍照或者是視頻,返回值類型可以是kUTTypeMovie,kUTTypeImage
@property(nonatomic) BOOL showsCameraControls NS_AVAILABLE_IOS(3_1); @property(nonatomic) BOOL allowsEditing NS_AVAILABLE_IOS(3_1); // replacement for -allowsImageEditing; default value is NO. @property(nonatomic) BOOL allowsImageEditing NS_DEPRECATED_IOS(2_0, 3_1);showsCameraControls用于指定拍照時下方的工具欄是否顯示,allowImageEditing在iOS3.1就已廢棄,取而代之的是allowEditing,表示拍完照片或者從相冊選完照片后,是否跳轉到編輯模式對圖片裁剪,只有在showsCameraControls為YES時才有效果。
@property(nonatomic) UIImagePickerControllerCameraCaptureMode cameraCaptureMode NS_AVAILABLE_IOS(4_0); // default is UIImagePickerControllerCameraCaptureModePhoto @property(nonatomic) UIImagePickerControllerCameraDevice cameraDevice NS_AVAILABLE_IOS(4_0); // default is UIImagePickerControllerCameraDeviceRear @property(nonatomic) UIImagePickerControllerCameraFlashMode cameraFlashMode @property(nullable, nonatomic,strong) __kindof UIView *cameraOverlayView NS_AVAILABLE_IOS(3_1); // set a view to overlay the preview view. @property(nonatomic) CGAffineTransform cameraViewTransform NS_AVAILABLE_IOS(3_1); // set the transform of the preview view.當sourceType是camera的時候,這幾個屬性有限,否則拋出異常。cameraCaptureMode捕捉模式指定的是相機是拍攝照片還是視頻,它的枚舉類型如下:
NS_ENUM(NSInteger, UIImagePickerControllerCameraCaptureMode) { UIImagePickerControllerCameraCaptureModePhoto,//photo UIImagePickerControllerCameraCaptureModeVideo//video };cameraDevice指定拍攝的攝像頭位置,是使用前置攝像頭還是后置攝像頭,它的枚舉類型有:
typedef NS_ENUM(NSInteger, UIImagePickerControllerCameraDevice) {UIImagePickerControllerCameraDeviceRear, UIImagePickerControllerCameraDeviceFront };cameraFlashMode用于指定閃光燈模式,它的枚舉類型如下:
typedef NS_ENUM(NSInteger, UIImagePickerControllerCameraFlashMode) {UIImagePickerControllerCameraFlashModeOff = -1, UIImagePickerControllerCameraFlashModeAuto = 0, UIImagePickerControllerCameraFlashModeOn = 1 };cameraViewTransform該結構體可以用于指定拍攝時View的一些形變屬性,如旋轉縮放等。
當showsCameraControls為NO,系統的工具欄隱藏時,我們可以自定義背景View賦值給cameraOverlayView添加到拍攝時的預覽視圖之上。
videoMaximumDuration用于設置視頻拍攝模式下最大拍攝時長,默認值是10分鐘。 videoQuality表示拍攝的視頻質量設置,默認是Medium即表示中等質量。 videoQuality支持的枚舉類型如下:
typedef NS_ENUM(NSInteger, UIImagePickerControllerQualityType) { UIImagePickerControllerQualityTypeHigh = 0, // 高清模式 UIImagePickerControllerQualityTypeMedium = 1, //中等質量,適于WIFI傳播 UIImagePickerControllerQualityTypeLow = 2, //低等質量,適于蜂窩網絡傳輸 UIImagePickerControllerQualityType640x480 NS_ENUM_AVAILABLE_IOS(4_0) = 3, // VGA 質量 UIImagePickerControllerQualityTypeIFrame1280x720 NS_ENUM_AVAILABLE_IOS(5_0) = 4,//1280*720的分辨率 UIImagePickerControllerQualityTypeIFrame960x540 NS_ENUM_AVAILABLE_IOS(5_0) = 5,//960*540分辨率 };-
類方法
@interface UIImagePickerController : UINavigationController <NSCoding> + (BOOL)isSourceTypeAvailable:(UIImagePickerControllerSourceType)sourceType; // returns YES if source is available (i.e. camera present) + (nullable NSArray<NSString *> *)availableMediaTypesForSourceType:(UIImagePickerControllerSourceType)sourceType; // returns array of available media types (i.e. kUTTypeImage) + (BOOL)isCameraDeviceAvailable:(UIImagePickerControllerCameraDevice)cameraDevice NS_AVAILABLE_IOS(4_0); // returns YES if camera device is available + (BOOL)isFlashAvailableForCameraDevice:(UIImagePickerControllerCameraDevice)cameraDevice NS_AVAILABLE_IOS(4_0); // returns YES if camera device supports flash and torch. + (nullable NSArray<NSNumber *> *)availableCaptureModesForCameraDevice:(UIImagePickerControllerCameraDevice)cameraDevice NS_AVAILABLE_IOS(4_0);
isSourceTypeAvailable用于判斷當前設備是否支持指定的sourceType,可以是照片庫/相冊/相機.
isCameraDeviceAvailable判斷當前設備是否支持前置攝像頭或者后置攝像頭
isFlashAvailableForCameraDevice是否支持前置攝像頭閃光燈或者后置攝像頭閃光燈
availableMediaTypesForSourceType方法返回所特定的媒體如相冊/圖片庫/相機所支持的媒體類型數組,元素值可以是kUTTypeImage類型或者kUTTypeMovie類型的靜態字符串,所以是NSString類型的數組
availableCaptureModesForCameraDevice返回特定的攝像頭(前置攝像頭/后置攝像頭)所支持的拍攝模式數值數組,元素值可以是UIImagePickerControllerCameraCaptureMode枚舉里面的video或者photo,所以是NSNumber類型的數組
-
對象方法
- (void)takePicture NS_AVAILABLE_IOS(3_1); - (BOOL)startVideoCapture NS_AVAILABLE_IOS(4_0); - (void)stopVideoCapture NS_AVAILABLE_IOS(4_0);
takePicture可以用來實現照片的連續拍攝,需要自己自定義拍攝的背景視圖來賦值給cameraOverlayView ,結合自定義overlayView實現多張照片的采集,在收到代理的didFinishPickingMediaWithInfo方法之后可以啟動額外的捕捉。
startVideoCapture用來判斷當前是否可以開始錄制視頻,當視頻正在拍攝中,設備不支持視頻拍攝,磁盤空間不足等情況,該方法會返回NO.該方法結合自定義overlayView可以拍攝多部視頻
stopVideoCapture當你調用此方法停止視頻拍攝時,它會調用代理的imagePickerController:didFinishPickingMediaWithInfo:方法
-
代理方法
@protocol UIImagePickerControllerDelegate<NSObject> @optional - (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingImage:(UIImage *)image editingInfo:(nullable NSDictionary<NSString *,id> *)editingInfo NS_DEPRECATED_IOS(2_0, 3_0); - (void)imagePickerController:(UIImagePickerController *)picker didFinishPickingMediaWithInfo:(NSDictionary<NSString *,id> *)info; - (void)imagePickerControllerDidCancel:(UIImagePickerController *)picker; @end imagePickerController:didFinishPickingImage:editingInfo:在iOS3.0中已廢棄,不再使用。當用戶取消選取的內容時會調用DidCancel方法,默認實現銷毀彈出的視圖。當完成內容的選取時會調用didFinishPickingMediaWithInfo方法,默認info字典的key值可以是以下類型: UIKIT_EXTERN NSString *const UIImagePickerControllerMediaType; //指定用戶選擇的媒體類型 UIKIT_EXTERN NSString *const UIImagePickerControllerOriginalImage; // 原始圖片 UIKIT_EXTERN NSString *const UIImagePickerControllerEditedImage; // 修改后的圖片 UIKIT_EXTERN NSString *const UIImagePickerControllerCropRect; // 裁剪尺寸 UIKIT_EXTERN NSString *const UIImagePickerControllerMediaURL; // 媒體的URL UIKIT_EXTERN NSString *const UIImagePickerControllerReferenceURL NS_AVAILABLE_IOS(4_1); // 原件的URL UIKIT_EXTERN NSString *const UIImagePickerControllerMediaMetadata //當數據來源是相機的時候獲取到的靜態圖像元數據,可以使用phtoho框架進行處理
-
C函數(保存照片或視頻)
UIKIT_EXTERN void UIImageWriteToSavedPhotosAlbum(UIImage *image, __nullable id completionTarget, __nullable SEL completionSelector, void * __nullable contextInfo); UIKIT_EXTERN BOOL UIVideoAtPathIsCompatibleWithSavedPhotosAlbum(NSString *videoPath) NS_AVAILABLE_IOS(3_1); UIKIT_EXTERN void UISaveVideoAtPathToSavedPhotosAlbum(NSString *videoPath, __nullable id completionTarget, __nullable SEL completionSelector, void * __nullable contextInfo) NS_AVAILABLE_IOS(3_1); UIImageWriteToSavedPhotosAlbum用來保存照片到相冊,seletor應該設置為- (void)image:(UIImage )image didFinishSavingWithError:(NSError )error contextInfo:(void )contextInfo;當照片保存到相冊完成時,會調用該方法通知你。
UIVideoAtPathIsCompatibleWithSavedPhotosAlbum會返回布爾類型的值判斷該路徑下的視頻能否保存到相冊,視頻需要先存儲到沙盒文件再保存到相冊,而照片是可以直接從代理完成的回調info字典里面獲取到。
UISaveVideoAtPathToSavedPhotosAlbum用來保存視頻到相冊,seletor應該設置為- (void)video:(NSString )videoPath didFinishSavingWithError:(NSError )error contextInfo:(void )contextInfo;當視頻保存到相冊或出錯時會調用該方法通知你。
這三個方法一般是在代理的完成方法didFinishPickingMediaWithInfo里面配合使用。
關于編輯照片界面的英文,可以在info.plist設置Localized resources can be mixed 的值為YES就可以轉換為你當前系統的語言。更多關于info.plist的詳解請參考iOS系統配置info.plist下面是關于使用UIImagePickerConreoller來上傳頭像,照片多選以及拍攝視頻的一個Demo
總結
以上是生活随笔為你收集整理的UIImagePikerController 浅析的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 风险管理、收尾管理、知识产权管理
- 下一篇: Hadoop2.6.0的FileInpu