一. ALAssetsLibrary 介绍
ALAssetsLibrary 提供了访问iOS设备下”照片”应用下所有照片和视频的接口;
- 从 ALAssetsLibrary 中可读取所有的相册数据,即 ALAssetsGroup 对象列表;
- 从每个 ALAssetsGroup 中可获取到其中包含的照片或视频列表,即 ALAsset 对象列表;
- 每个 ALAsset 可能有多个representations表示,即 ALAssetRepresentation 对象,使用其 defaultRepresentation 方法可获得其默认representations,使用[asset valueForProperty: ALAssetPropertyRepresentations ]可获取其所有representations的 UTI 数组。
- 从ALAsset对象可获取缩略图 thumbnail 或 aspectRatioThumbnail ;
- 从 ALAssetRepresentation 对象可获取全尺寸图片( fullResolutionImage ),全屏图片( fullScreenImage )及图片的各种属性: orientation , dimensions , scale , url , metadata 等。
其层次关系为 ALAssetsLibrary -> ALAssetsGroup -> ALAsset -> ALAssetRepresentation 。
注意:
-
The lifetimes of objects you get back from a library instance are tied to the lifetime of the library instance.
通过ALAssetsLibrary对象获取的其他对象只在该ALAssetsLibrary对象生命期内有效,若ALAssetsLibrary对象被销毁,则其他从它获取的对象将不能被访问,否则有会错误。
invalid attempt to access ALAssetPrivate past the lifetime of its owning ALAssetsLibrary
- ALAssetRepresentation的 metadata 方法很慢,我在iPhone4 iOS5.1.1中测试,此方法返回需要40-50ms,所以获取图片的个各种属性尽量直接从ALAssetRepresentation中获取,不要读取metadata。 这里 给出了一个此方法占用内存过多的解释,调用多次也确实很容易会memory warning,或许也能解析其为什么很慢吧。
The method [representation metadata] returns an autoreleased object and possibly creates more autoreleased objects when it executes. All these instances are added to the autorelease pool, waiting to be finally released (and their memory freed) when the ARP gets the chance to drain itself.
- 系统”相册”程序显示的图片是 fullScreenImage ,而不是 fullResolutionImage ,fullResolutionImage尺寸太大,在手机端显示推荐用fullScreenImage。
fullScreenImage已被调整过方向,可直接使用,即[UIImage imageWithCGImage:representation.fullScreenImage];
使用fullResolutionImage要自己调整方法和scale,即
[UIImage imageWithCGImage:representation.fullResolutionImage scale:representation.scale orientation:representation.orientation];
二.创建 ALAssetsLibrary对象
使用ALAssetsLibrary之前需导入头文件和AssetsLibrary.framework。
#import
...
ALAssetsLibrary *assetsLibrary = [[ALAssetsLibrary alloc]init];
...
三.遍历Assets Group
- 使用 enumerateGroupsWithTypes:usingBlock:failureBlock: 方法可遍历assets group;
- 此方法为异步执行,若之前未被授权过,此方法会向用户请求访问数据的权限;若用户拒绝授权或其他错误则会执行failureBlock;
- 如果用户关掉了位置服务(Location Services,在设置->通用中),返回的错误为 ALAssetsLibraryAccessGloballyDeniedError 。
- enumerationBlock和failureBlock与在调用此方法的线程内执行,若要在背景线程进行遍历,可将遍历代码放入GCD或NSOperation中。
[assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
if (!group) {
[tableView performSelectorOnMainThread:@selector(reloadData) withObject:nil waitUntilDone:NO];
}else{
[groupsArray addObject:group];
...
}
} failureBlock:^(NSError *error) {
NSLog(@"error:%@",error);
}];
四.遍历Assets Group中的Assets
- 使用 enumerateAssetsUsingBlock: 方法或者其他变体方法可遍历ALAssetsGroup中的所有ALAsset;
- 可通过 setAssetsFilter: 设置过滤器( ALssetsFilter )使enumerateAssetsUsingBlock:只返回特定类型asset,而 numberOfAssets 只返回特定类型asset的数量。
可以设置只显示Photo( allPhotos ),只显示Video( allVideos ),或显示全部( allAssets )。 - enumerateAssetsUsingBlock:为同步方法,只有所有Asset遍历完才返回。所以需要将遍历代码放入背景线程,防止阻塞UI线程。
[assetsGroup setAssetsFilter:[ALAssetsFilter allPhotos]];
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
[assetsGroup enumerateAssetsUsingBlock:^(ALAsset *result, NSUInteger index, BOOL *stop) {
if (!result) {
[tableView performSelectorOnMainThread:@selector(reloadData) withObject:nil waitUntilDone:NO];
}else{
[assetsArray addObject:result];
...
}
}];
});
五.根据url获取asset
使用ALAssetsLibrary的 assetForURL:resultBlock:failureBlock: 方法,可根据之前从ALAssetRepresentation中获取的url重新获取ALAsset对象,此方法同enumerateGroupsWithTypes:usingBlock:failureBlock:一样为异步方法。
六.获取Assets的各种属性
- 相册封面图片 [assetsGroup posterImage ];
- 照片url[[[asset defaultRepresentation] url] absoluteString];
- 照片缩略图
[asset thumbnail];
[asset aspectRatioThumbnail]; - 照片全尺寸图
[[asset defaultRepresentation] fullResolutionImage]; - 照片全屏图
[[asset defaultRepresentation] fullScreenImage]; - 照片创建时间
[asset valueForProperty:ALAssetPropertyDate]; - 照片拍摄位置(可能为nil)
[asset valueForProperty:ALAssetPropertyLocation]; - 照片尺寸
[[asset defaultRepresentation] dimensions];