一. 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 。
注意:
1.通过ALAssetsLibrary对象获取的其他对象只在该ALAssetsLibrary对象生命期内有效,若ALAssetsLibrary对象被销毁,则其他从它获取的对象将不能被访问,否则有会错误。
2.ALAssetRepresentation的 metadata 方法很慢,所以获取图片的个各种属性尽量直接从ALAssetRepresentation中获取,不要读取metadata。 这里 给出了一个此方法占用内存过多的解释,调用多次也确实很容易会memory warning,或许也能解析其为什么很慢吧。
3.系统”相册”程序显示的图片是 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。
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];