AssetLibrary组成
AssetLibrary:代表整个设备中的资源库(照片库),通过AssetLibrary可以获取设备中的照片和视频,同时也可以增加相册或将照片写入相册
ALAssetsGroup:映射照片库中的相册组,通过ALAssetsGroup可以获取某个相册的信息以及相册下的资源,同时也可以对某个相册添加资源
ALAsset:映射照片库中的一个照片或者视频,通过ALAsset可以获取某个照片或者视频的详细信息,或者保存照片和视频
ALAssetRepressentation:ALAssetRepresentation 是对 ALAsset 的封装(但不是其子类),可以更方便地获取 ALAsset 中的资源信息,每个 ALAsset 都有至少有一个 ALAssetRepresentation 对象,可以通过 defaultRepresentation 获取。而例如使用系统相机应用拍摄的 RAW + JPEG 照片,则会有两个 ALAssetRepresentation,一个封装了照片的 RAW 信息,另一个则封装了照片的 JPEG 信息
AssetLibrary方法
将图片写入相册的方法:
//将图片写入相册中,图片是CGImage类型的,可以通过[UIImage CGImage]来获得
- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef orientation:(ALAssetOrientation)orientation completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock
//将图片保存到相册,同时在metadata字典中指定图片的方向
- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock
//将图片保存到相册,同时如果图像数据和元数据冲突,图像数据将被重写
//有关元数据可以看这一篇文章 http://blog.csdn.net/zhi_sheng/article/details/52595523
- (void)writeImageDataToSavedPhotosAlbum:(NSData *)imageData metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock
在上面的方法中orientation有这么几个选项:
ALAssetOrientationUp 上
ALAssetOrientationDown 下
ALAssetOrientationLeft 左
ALAssetOrientationRight 右
ALAssetOrientationUpMirrored 水平上翻转
ALAssetOrientationDownMirrored 水平下翻转
ALAssetOrientationLeftMirrored 竖直左翻转
ALAssetOrientationRightMirrored 竖直右翻转
从相册资源库读取相册的方法:
//遍历AssetLibrary得到的是ALAssetsGroup
- (void)enumerateGroupsWithTypes:(ALAssetsGroupType)types usingBlock:(ALAssetsLibraryGroupsEnumerationResultsBlock)enumerationBlock failureBlock:(ALAssetsLibraryAccessFailureBlock)failureBlock
types的类型:
ALAssetsGroupLibrary 所有的相册(包括本地和 iTunes 的)
ALAssetsGroupAlbum 同步得到iTunes的和创建的(不包括共享的)
ALAssetsGroupEvent 同步到 iTunes 的(包括相机导入的)
ALAssetsGroupFaces 同步 iTunes 的
ALAssetsGroupSavedPhotos 所有相册(包括相机导入的)
ALAssetsGroupPhotoStream itunes 同步的(包括共享的)
ALAssetsGroupAll 所有可见的相册
使用代码范例:
ALAssetsLibrary *assetsLibrary;
NSMutableArray *groupArray;
assetsLibrary = [[ALAssetsLibrary alloc] init];
groupArray=[[NSMutableArray alloc] initWithCapacity:1];
[assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
if (group) {
[groupArray addObject:group];
// 通过这个可以知道相册的名字,从而也可以知道安装的部分应用
//例如 Name:柚子相机, Type:Album, Assets count:1
NSLog(@"%@",group);
}
} failureBlock:^(NSError *error) {
NSLog(@"Group not found!\n");
}];
//该方法为异步执行的方法,会在调用此方法的线程内执行
ALAssetsGroup的方法以及属性
- (id)valueForProperty:(NSString *)property:返回相册的一些属性它有以下几个键:
extern NSString *const ALAssetsGroupPropertyName 相册的名称
extern NSString *const ALAssetsGroupPropertyType 相册的类型
extern NSString *const ALAssetsGroupPropertyPersistentID 相册的标示 id
extern NSString *const ALAssetsGroupPropertyURL 相册的 url
- (CGImageRef)posterImage 返回相册的封面,且该封面图片的方向是正确的
- (void)setAssetsFilter:(ALAssetsFilter *)filter 设置相册的筛选条件,它有以下几个键:
//所有的照片
+ (ALAssetsFilter *)allPhotos;
// 所有的视频
+ (ALAssetsFilter *)allVideos;
// 相册里的所有资源,包括照片和视频
+ (ALAssetsFilter *)allAssets;
- (NSInteger)numberOfAssets 相册里面资源的数量,这个资源数量和刚才设置的过滤器有关
//遍历相册里面的所有资源,得到的是ALAsset对象
- (void)enumerateAssetsUsingBlock:(ALAssetsGroupEnumerationResultsBlock)enumerationBlock
代码实用范例:
[_group enumerateAssetsUsingBlock:^(ALAsset *result, NSUInteger index, BOOL *stop) {
if (result) {
[imageArray addObject:result];
NSLog(@"%@",result);
iv.image=[UIImage imageWithCGImage: result.thumbnail];
NSString *type=[result valueForProperty:ALAssetPropertyType];
}
}];
//该方法为同步执行的方法,需要遍历完才能返回,所以一般需要放在后台线程
ALAsset的方法及属性
- (id)valueForProperty:(NSString *)property 获取照片相关的各种属性,这些属性的键为
ALAssetPropertyType 资源的类型(照片,视频)
ALAssetPropertyLocation 资源地理位置(无位置信息返回null)
ALAssetPropertyDuation 播放时长(照片返回ALErorInvalidProperty)
ALAssetPropertyOrientation 方向(共有8个方向,参见:ALAssetOrientation)
ALAssetPropertyDate 拍摄时间(包含了年与日时分秒)
ALAssetPropertyRepresentations 描述(打印看了下,只有带后缀的名称)
ALAssetPropertyURLs(返回一个字典,键值分别是文件名和文件的url)
ALAssetPropertyAssetURL (文件的url )
- (CGImageRef)thumbnail 照片缩略图(这个方法获得的是质量不高的缩略图,它是从图片中间进行正方形的裁剪,没有按比例缩放)
- (CGImageRef)aspectRatioThumbnail 获得照片的缩略图,相比于上一个方法,它是进行比例缩放的
保存图片到相册:
- (void)writeModifiedImageDataToSavedPhotosAlbum:(NSData *)imageData metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
保存图片到相册:
imageData:要保存的图片流,
metadata:保存图片的元数据,一般为 nil,如果和前面的 imageData 冲突的话,会覆盖掉前面的信息,
completionBlock:保存完的 block 回调,定义为:typedef void (^ALAssetsLibraryWriteImageCompletionBlock)(NSURL *assetURL, NSError *error),
assetUrl: 保存成功后映射该相片的 url
error: 保存失败信息.
- (ALAssetRepresentation *)defaultRepresentation 获取该图片的详细信息返回的是ALAssetRepresentation对象
ALAssetRepresentation方法及属性
- (NSString *)UTI 图片资源UTI 唯一标识符
- (CGSize)dimensions 获取图片的长宽
- (long long)size 图片资源容量大小
- (CGImageRef)fullResolutionImage 图片资源的高清图
- (CGImageRef)fullScreenImage 图片资源全屏图,相比于上一个方法,使用它得到的图片足够
- (NSURL *)url 资源图片url地址,该地址和ALAsset通过ALAssetPropertyAssetURL获取的url地址是一样的
- (NSDictionary *)metadata 资源图片数据
- (ALAssetOrientation)orientation 资源图片旋转方向
- (float)scale 资源图片缩放倍数
- (NSString *)filename 资源图片的名字
注意:在用ALAssetsLibrary遍历照片时,group的筛选条件一定要在遍历方法成功的block里面设定,不然有些应用自定义创建的照片文件夹扫描不出来