IOS-AssetsLibrary(相册)框架介绍
AssetsLibrary框架介绍：
AssetsLibrary框架包含了ALAssetsLibrary，ALAssetsGroup，ALAsset，ALAssetsFilter，ALAssetRepresentation 五个类，提供从相册中读取相片、将相片保存到相册，获取相册信息，增加相册等功能。
注意：在一个类中多处使用到ALAssetsLibrary框架，最好定义ALAssetsLibrary类属性，因为，如果ALAssetsLibrary类的实例释放掉了，这个ALAssetsLibrary类对应的ALAssetsGroup也会不存在.
ALAssetsLibrary
ALAssetsLibrary类介绍
可以说，是一个桥梁把。连接了我们应用程序和相册之间的访问。
ALAssetsLibrary提供了我们对iOS设备中的相片、视频的访问。
ALAssetsLibrary被封装在 框架中。所以，我们在使用时，需要引入该框架。
需添加AssetsLibrary.framework
然后引入头文件
#import<AssetsLibrary/AssetsLibrary.h>或者
{
#import <AssetsLibrary/ALAsset.h>
#import <AssetsLibrary/ALAssetsLibrary.h>
#import <AssetsLibrary/ALAssetsGroup.h>
#import <AssetsLibrary/ALAssetRepresentation.h>
}ALAssetsLibrary类方法介绍
//添加一个group，成功后查看一些信息
addAssetsGroupAlbumWithName:(NSString *) resultBlock: failureBlock:
//通过url地址在相册资源中获取该地址的资源文件ALAsset，有可能是相片或视频
assetForURL: resultBlock: failureBlock:
//通过url地址获取相册资源中的一个相册
photolibrary groupForURL: resultBlock: failureBlock:
//根据选择的类型遍历相册资源中的相对应类型的所有相册，其中stop行参是指针，表示是否停止迭代，当赋值为false则停止
enumerateGroupsWithTypes: usingBlock: failureBlock:
//保存图片到系统默认的相册中，使用nsdata的形式，并返回照片的url地址
[_library writeImageDataToSavedPhotosAlbum:nil metadata:nil completionBlock:^(NSURL *assetURL, NSError *error) {
}];
//保存图片到系统默认的相册中，使用cgimageref的形式，并返回照片的url地址
[_library writeImageToSavedPhotosAlbum:nil metadata:nil completionBlock:^(NSURL *assetURL, NSError *error) {
}];
//保存图片到系统默认的相册中，使用cgimageref的形式，并且选择图片以什么旋转方向的形式保存，并返回照片的url地址
// typedef enum {
// ALAssetOrientationUp, // default orientation
// ALAssetOrientationDown, // 180 deg rotation
// ALAssetOrientationLeft, // 90 deg CCW
// ALAssetOrientationRight, // 90 deg CW
// ALAssetOrientationUpMirrored, // as above but image mirrored along other axis. horizontal flip
// ALAssetOrientationDownMirrored, // horizontal flip
// ALAssetOrientationLeftMirrored, // vertical flip
// ALAssetOrientationRightMirrored, // vertical flip
// } ALAssetOrientation;
UIImage* image = [UIImage imageNamed:@"test.png"];
[_library writeImageToSavedPhotosAlbum:[image CGImage] orientation:ALAssetOrientationLeft completionBlock:^(NSURL *assetURL, NSError *error) {
NSLog(@"save image:%@",assetURL);
}]; ALAssetsgroup
ALAssetsgroup 类介绍
ALAssetsgroup 就是相册的类
ALAssetsgroup 方法介绍
Enumerating Assets（遍历资源）
– enumerateAssetsUsingBlock:（用一个block来遍历组里的资源）
– enumerateAssetsWithOptions:usingBlock:（在枚举选项的条件下，用一个block来遍历组里的资源）
– enumerateAssetsAtIndexes:options:usingBlock:（在枚举选项的条件下，用一个block来遍历组里特定index的资源）
Adding Assets（添加资源）
– addAsset:（添加一个已存在的asset到接收者。返回yes成功；反之，失败。）
editable property（指示程序是否可以编辑组，只读属性，打印看了一下，系统自带的是不能编辑的，其它可以编辑）
Filtering（过滤）
– numberOfAssets（返回组过滤器条件下的资源个数，若没有设置过滤器，则返回组里的资源个数）
– setAssetsFilter:（设置组的过滤器）
Accessing Properties（访问属性）
– valueForProperty:（通过组属性名称，获取组属性：组名称，组类型，组永久性ID,组URL）
– posterImage（组的封面）ALAsset
ALAsset 类介绍
ALAsset可以看成是一个你选择的文件的包装类，从中可以取到一个叫做ALAssetPresentation的对象（defaultRepresentation），然后如果是图片的话里面可以得到全屏图、全尺寸图、metadata、size等等有用的信息。
ALAsset类中方法介绍
Asset Properties
– valueForProperty:
(1.ALAssetPropertyType 资源的类型（照片，视频）
2.ALAssetPropertyLocation 资源地理位置（无位置信息返回null）
3.ALAssetPropertyDuation 播放时长（照片返回ALErorInvalidProperty)
4.ALAssetPropertyOrientation 方向（共有8个方向，参见：ALAssetOrientation)
5.ALAssetPropertyDate 拍摄时间（包含了年与日时分秒）
6.ALAssetPropertyRepresentations 描述（打印看了下，只有带后缀的名称）
7.ALAssetPropertyURLs（返回一个字典，键值分别是文件名和文件的url）
8.ALAssetPropertyAssetURL 文件的url )
editable property（指示资源是否可以编辑，只读属性)
originalAsset property（原始资源。若没有保存修改后资源，则原始资源为nil）
Accessing Representations
– defaultRepresentation
– representationForUTI:
– thumbnail（小正方形的缩略图）
– aspectRatioThumbnail（按原始资源长宽比例的缩略图）
Setting New Image and Video Data
– setImageData:metadata:completionBlock:
用给定的image data 替换接收者的image data。
– setVideoAtPath:completionBlock:
用给定的URL的video 替换接收者的video data。
Saving to the Saved Photos Album
– writeModifiedImageDataToSavedPhotosAlbum:metadata:completionBlock:
保存image data到Saved Photos album
– writeModifiedVideoAtPathToSavedPhotosAlbum:completionBlock:
保存video到Saved Photos album的指定路径ALAssetRepresentation
ALAssetRepresentation类介绍
ALAssetRepresentation对象封装了一个给定ALAsset对象的陈述。一个在资源库中给定的asset可能有不止一个陈述。比如，如果一个相机提供RAW和JPEG格式的图像版本，asset将有两个陈述版本，一个是RAW的,一个是JPEG的。
ALAssetRepresentation方法介绍
Getting Image Representations
– CGImageWithOptions:
– fullResolutionImage（完全分辨率的图片）
– fullScreenImage（满屏的图片）
Getting Image Attributes
– orientation（文件方向）
– scale（长宽比例）
– filename（文件名字）
Getting Raw Data
– size（文件尺寸，以byte为单位）
– getBytes:fromOffset:length:error:
Getting Metadata
– UTI
– metadata
Getting an URL
– url使用
ALAssetsLibrary *photolibrary = [[ALAssetsLibrary alloc] init];
[photolibrary enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
//提取group中的数据信息
if (group) {
[group enumerateAssetsUsingBlock:^(ALAsset *result, NSUInteger index, BOOL *stop) {
if (result) {
//获取缩略图
UIImage *image = [UIImage imageWithCGImage:[result thumbnail]];
[self.thumbnailArray addObject:[image copy]];
//获取原图
image = [UIImage imageWithCGImage:[[result defaultRepresentation] fullScreenImage]];
[self.orignalArray addObject:[image copy]];
}
}];
}
} failureBlock:^(NSError *error) {
NSLog(@"获取图片失败");
}];
