CTAssetsPickerController 2.0.0 released! It has newly re-design delegate methods, fixed serveral issues and improved usability. Please see What's new for the details.
CTAssetsPickerController is an iOS controller that allows picking multiple photos and videos from user's photo library. The usage and look-and-feel just similar to UIImagePickerController. It uses ARC and requires AssetsLibrary framework.
- Picks multiple photos and videos across albums from user's library.
- Filters assets for picking only photos or videos.
- Provides delegate methods for customization.
- Achieves average 5x fps.
- Conforms UIAccessibility Protocol.
- Rename the delegate methods to more sensible one
- Replace certain properties with delegate methods in order to provide more flexibility
- Selected assets are preserved across albums
- Move title of selected assets to toolbar
- Show "no assets" view on empty albums
- Make "no assets" message to be more graceful, reflecting the device's model and camera feature
- Update padlock image to iOS 7 style
- Monitor ALAssetsLibraryChangedNotification and reload corresponding view controllers
- Use KVO to monitor the change of selected assets
- Add: Empty assets placeholder image
- Add: Selected assets property
- Add: Selected assets changed notification
- Add: Selection methods
- Add: iPad demo
- Add: Appledoc documentation
- Fix: Footer is not centre aligned after rotation
- Fix: Collection view layout issue on iPad landscape mode
- Fix: Collection view not scrolling to bottom on load
- Refactor certain methods
CTAssetsPickerController has dropped support for iOS 6. To use this control with iOS 6, you might consider to checkout the obsolete branch 1.x.x, which developement has been ceased.
Xcode 5 and iOS 7.
via CocoaPods
$ edit Podfile
platform :ios, '7.0'
pod 'CTAssetsPickerController', '~> 2.0.0'
$ pod install- Use the Xcode workspace instead of the project.
$ git submodule add http://github.com/chiunam/CTAssetsPickerController- Drag
CTAssetsPickerControllerfolder in your project and add to your targets. - Add
AssetsLibrary.framework.
See the demo project and documentation for the details.
#import <CTAssetsPickerController.h>CTAssetsPickerController *picker = [[CTAssetsPickerController alloc] init];
picker.delegate = self;
[self presentViewController:picker animated:YES completion:nil];The delegate methods are responsible for dismissing the picker when the operation completes. To dismiss the picker, call the dismissViewControllerAnimated:completion: method of the presenting controller responsible for displaying CTAssetsPickerController object. Please refer to the demo app.
- (void)assetsPickerController:(CTAssetsPickerController *)picker didFinishPickingAssets:(NSArray *)assets;
// assets contains ALAsset objects.Customization can be done by setting properties or implementating delegate methods. This section describes common customizations. Please refer to the documentation or header file for the complete list of properties and delegate methods.
Pick only photos or videos by creating an ALAssetsFilter and assigning it to assetsFilter.
picker.assetsFilter = [ALAssetsFilter allPhotos]; // Only pick photos.Hide cancel button if you present the picker in UIPopoverController.
picker.showsCancelButton = NO;Override picker's title.
picker.title = @"Pick photos";Set initially selected assets by assigning an NSMutableArray to selectedAssets.
picker.selectedAssets = [NSMutableArray arrayWithArray:@[asset1, asset2, asset3, ...]];Limit the number of assets to be picked.
- (BOOL)assetsPickerController:(CTAssetsPickerController *)picker shouldSelectAsset:(ALAsset *)asset
{
// Allow 10 assets to be picked
return (picker.selectedAssets.count < 10);
}Enable only certain assets to be selected.
- (BOOL)assetsPickerController:(CTAssetsPickerController *)picker shouldEnableAssetForSelection:(ALAsset *)asset
{
// Enable video clips if they are at least 5s
if ([[asset valueForProperty:ALAssetPropertyType] isEqual:ALAssetTypeVideo])
{
NSTimeInterval duration = [[asset valueForProperty:ALAssetPropertyDuration] doubleValue];
return lround(duration) >= 5;
}
// Photos are always enabled
else
{
return YES;
}
}Show only certain albums.
Assets stored on iCloud (photo stream) may not be displayed and picked properly if they have not downloaded to the device. You may hide iCloud albums by implementing the following delegate.
- (BOOL)assetsPickerController:(CTAssetsPickerController *)picker shouldShowAssetsGroup:(ALAssetsGroup *)group
{
// Do not show photo stream
NSInteger type = [[group valueForProperty:ALAssetsGroupPropertyType] integerValue];
return (type != ALAssetsGroupPhotoStream);
}Show alert on selection.
Or show an alert when user try to select empty assets
- (BOOL)assetsPickerController:(CTAssetsPickerController *)picker shouldSelectAsset:(ALAsset *)asset
{
// Show alert when user try to select assets that have not been downloaded
if (!asset.defaultRepresentation)
{
UIAlertView *alertView =
[[UIAlertView alloc] initWithTitle:@"Attention"
message:@"Your asset has not yet been downloaded to your device"
delegate:nil
cancelButtonTitle:nil
otherButtonTitles:@"OK", nil];
[alertView show];
}
return (asset.defaultRepresentation != nil);
}An NSNotification object named CTAssetsPickerSelectedAssetsChangedNotification will be sent when user select or deselect assets. You may add your observer to monitor the change of selection.
If you have Appledoc installed, you can install the documentation by running the Documentation target of the demo project.
CTAssetsPickerController does not compress the picked photos and videos. You can process the picked assets via the defaultRepresentation property.
For example, you can create UIImage from picked assets like this:-
ALAssetRepresentation *representation = alAsset.defaultRepresentation;
UIImage *fullResolutionImage =
[UIImage imageWithCGImage:representation.fullResolutionImage
scale:1.0f
orientation:(UIImageOrientation)representation.orientation];and create NSData of picked vidoes:-
ALAssetRepresentation *representation = alAsset.defaultRepresentation;
NSURL *url = representation.url;
AVAsset *asset = [AVURLAsset URLAssetWithURL:url options:nil];
AVAssetExportSession *session =
[AVAssetExportSession exportSessionWithAsset:asset presetName:AVAssetExportPresetLowQuality];
session.outputFileType = AVFileTypeQuickTimeMovie;
session.outputURL = VIDEO_EXPORTING_URL;
[session exportAsynchronouslyWithCompletionHandler:^{
if (session.status == AVAssetExportSessionStatusCompleted)
{
NSData *data = [NSData dataWithContentsOfURL:session.outputURL];
}
}];
Please refer the documentation of ALAssetRepresentation and AVAssetExportSession.
The MIT License (MIT)
Copyright (c) 2013 Clement CN Tsang
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.