IOS-AssetsLibrary(相册)框架介绍

时间:2022-06-17 12:14:02

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(@"获取图片失败");
}];



转载地址:

http://www.mobile-open.com/2014/2867.html

http://blog.csdn.net/u011439689/article/details/38454987