Description
It's a Facebook style Image Picker Controller by Swift. It uses DKCamera instead of UIImagePickerController since the latter cannot be Integrated into another container, and it will raise a warning Snapshotting ... or snapshot after screen updates. in iOS 8.
Features
- Supports both single and multiple selection.
- Supports filtering albums and sorting by type.
- Supports landscape and iPad and orientation switching.
- Supports iCloud.
- Supports UIAppearance.
- Supports custom camera.
- Supports custom UICollectionViewLayout.
- Supports footer view.
Requirements
- iOS 8.0+
- ARC
Installation
iOS 8 and newer
DKImagePickerController is available on CocoaPods. Simply add the following line to your podfile:
# For latest release in cocoapods pod 'DKImagePickerController'
iOS 7.x
The 3.x aren't supported before iOS 8. If you want to support iOS 7, you can look at the 2.4.3 branch that uses
ALAssetsLibraryinstead of usingPhotos.
To use Swift libraries on apps that support iOS 7, you must manually copy the files into your application project. CocoaPods only supports Swift on OS X 10.9 and newer, and iOS 8 and newer.
Getting Started
Initialization and presentation
let pickerController = DKImagePickerController() pickerController.didSelectAssets = { (assets: [DKAsset]) in print("didSelectAssets") print(assets) } self.presentViewController(pickerController, animated: true) {}
Customizing
/// Forces selection of tapped image immediatly. public var singleSelect = false /// The maximum count of assets which the user will be able to select. public var maxSelectableCount = 999 /// Set the defaultAssetGroup to specify which album is the default asset group. public var defaultAssetGroup: PHAssetCollectionSubtype? /// The types of PHAssetCollection to display in the picker. public var assetGroupTypes: [PHAssetCollectionSubtype] = [ .SmartAlbumUserLibrary, .SmartAlbumFavorites, .AlbumRegular ] /// Set the showsEmptyAlbums to specify whether or not the empty albums is shown in the picker. public var showsEmptyAlbums = true /// The type of picker interface to be displayed by the controller. public var assetType: DKImagePickerControllerAssetType = .AllAssets /// The predicate applies to images only. public var imageFetchPredicate: NSPredicate? /// The predicate applies to videos only. public var videoFetchPredicate: NSPredicate? /// If sourceType is Camera will cause the assetType & maxSelectableCount & allowMultipleTypes & defaultSelectedAssets to be ignored. public var sourceType: DKImagePickerControllerSourceType = .Both /// Whether allows to select photos and videos at the same time. public var allowMultipleTypes = true /// If YES, and the requested image is not stored on the local device, the Picker downloads the image from iCloud. public var autoDownloadWhenAssetIsInCloud = true /// Determines whether or not the rotation is enabled. public var allowsLandscape = false /// The callback block is executed when user pressed the cancel button. public var didCancel: (() -> Void)? public var showsCancelButton = false /// The callback block is executed when user pressed the select button. public var didSelectAssets: ((assets: [DKAsset]) -> Void)? /// It will have selected the specific assets. public var defaultSelectedAssets: [DKAsset]?
Exporting to file
/**
Writes the image in the receiver to the file specified by a given path.
*/
public func writeImageToFile(path: String, completeBlock: (success: Bool) -> Void)
/**
Writes the AV in the receiver to the file specified by a given path.
- parameter presetName: An NSString specifying the name of the preset template for the export. See AVAssetExportPresetXXX.
*/
public func writeAVToFile(path: String, presetName: String, completeBlock: (success: Bool) -> Void)Customize Navigation Bar
You can easily customize the appearance of navigation bar using the appearance proxy.
UINavigationBar.appearance().titleTextAttributes = [ NSFontAttributeName : UIFont(name: "Optima-BoldItalic", size: 21)!, NSForegroundColorAttributeName : UIColor.redColor() ]
Hides camera
pickerController.sourceType = .Photo
Quickly take a picture
pickerController.sourceType = .Camera
Customize footer view
Create a custom camera
You can give a class that implements the DKImagePickerControllerUIDelegate protocol to customize camera.
The following code uses a UIImagePickerController:
public class CustomUIDelegate: DKImagePickerControllerDefaultUIDelegate, UIImagePickerControllerDelegate, UINavigationControllerDelegate { var didCancel: (() -> Void)? var didFinishCapturingImage: ((image: UIImage) -> Void)? var didFinishCapturingVideo: ((videoURL: NSURL) -> Void)? public override func imagePickerControllerCreateCamera(imagePickerController: DKImagePickerController, didCancel: (() -> Void), didFinishCapturingImage: ((image: UIImage) -> Void), didFinishCapturingVideo: ((videoURL: NSURL) -> Void) ) -> UIViewController { self.didCancel = didCancel self.didFinishCapturingImage = didFinishCapturingImage self.didFinishCapturingVideo = didFinishCapturingVideo let picker = UIImagePickerController() picker.delegate = self picker.sourceType = .Camera picker.mediaTypes = [kUTTypeImage as String, kUTTypeMovie as String] return picker } // MARK: - UIImagePickerControllerDelegate methods public func imagePickerController(picker: UIImagePickerController, didFinishPickingMediaWithInfo info: [String : AnyObject]) { let mediaType = info[UIImagePickerControllerMediaType] as! String if mediaType == kUTTypeImage as String { let image = info[UIImagePickerControllerOriginalImage] as! UIImage self.didFinishCapturingImage?(image: image) } else if mediaType == kUTTypeMovie as String { let videoURL = info[UIImagePickerControllerMediaURL] as! NSURL self.didFinishCapturingVideo?(videoURL: videoURL) } } public func imagePickerControllerDidCancel(picker: UIImagePickerController) { self.didCancel?() } }
How to use in Objective-C
If you use CocoaPods
-
Adding the following two lines into your
Podfile:pod 'DKImagePickerController' use_frameworks!
-
Importing it into your Objective-C file:
#import <DKImagePickerController/DKImagePickerController-Swift.h>
If you use it directly in your project
-
Drag and drop the DKCamera and
DKImageManagerandDKImagePickerControllerto your project -
Importing it into your Objective-C file:
#import "YourProductModuleName-Swift.h"
then you can:
DKImagePickerController *pickerController = [DKImagePickerController new]; pickerController.assetType = DKImagePickerControllerAssetTypeAllAssets; pickerController.showsCancelButton = NO; pickerController.showsEmptyAlbums = YES; pickerController.allowMultipleTypes = YES; pickerController.defaultSelectedAssets = @[]; pickerController.sourceType = DKImagePickerControllerSourceTypeBoth; // pickerController.assetGroupTypes // unavailable // pickerController.defaultAssetGroup // unavailable [pickerController setDidSelectAssets:^(NSArray * __nonnull assets) { NSLog(@"didSelectAssets"); }]; [self presentViewController:pickerController animated:YES completion:nil];
Localization
It has been supported languages so far:
- en.lproj
- zh-Hans.lproj
- hu.lproj
- ru.lproj
- es.lproj
If you want to add new language, pull request or issue!
You can merge your branch into the develop branch. Any Pull Requests to be welcome!!!
Change Log
In
3.2.1, I've replaced allAVURLAssettoAVAssetin order to support Slow Motion.
In
3.2.0
- I changed the
sourceTypetype toenumin order to access the property in Objective-C. You can use.Bothinstead of[.Camera, .Photo].- I've also updated the
fetchAVAsset...interface:
thecompleteBlock: (avAsset: AVURLAsset?was changed tocompleteBlock: (avAsset: AVURLAsset?, info: [NSObject : AnyObject]?.
3.3.0 (2016-06-17)
Merged pull requests:
-
Fix the thumbnails have low quality.
-
Added Turkish localization support.
-
Added footer view.
-
Removed picker singleton.
-
Updated DKImagePickerControllerDefaultUIDelegate.
3.2.1 (2016-05-23)
Merged pull requests:
-
Add Russian translation.
-
Fixed an issue may cause popoverView show in incorrect position.
-
Optimized memory usage with large files.
-
Added support for Slow Motion.
Special Thanks
Thanks for scottdelly's contribution and performance improvement!
Thanks for LucidityDesign's contribution!
Thanks for AnthonyMDev's contribution!
License
DKImagePickerController is released under the MIT license. See LICENSE for details.



