这篇文章主要介绍了iOS开发之AssetsLibrary框架使用详解,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
正文
iOS开发之AssetsLibrary框架使用详解
一、引言
assetslibrary框架是专门用来操作相册相关资源的一个框架,其是ios4到ios9之间常使用的一个框架,在ios9之后,系统系统了photos框架代替了assetslibrary框架,但是assetslibrary框架依然可以使用,并且其结构和设计思路依然值得我们进行分析学习。
二、概述
assetslibrary框架会操作系统的相册,因此首先需要进行权限的申请,在使用之前,首先需要在info.plist文件中添加如下键值:
privacy - photo library usage description
assetslibrary框架中核心的类关系如下图所示:

1.alassetslibrary:代表整个设备中的照片和视频,通过alassetslibrary可以获取和包括设备中的照片和视频
2.alassetsgroup:映射照片库中的一个相册,通过alassetsgroup可以获取某个相册的信息,相册下的照片和视频,同时也可以对某个相册添加资源
3.alasset:映射相册中的一个照片或者视频,通过alasset可以获取某个照片或者视频的详细信息,获取保存照片和视频
4.alassetrepresentation:alassetrepresentation是对alasset的封装(但不是其子类),可以更方便地获取alasset中的资源信息,每个alasset都有至少一个alassetrepresentation对象,可以通过default<representation获取.而例如使用系统相机拍摄的raw+jpeg照片,则会有两个alassetrepresentation对象,一个封装了照片的raw信息,另一个则封装了照片的jpeg信息
5.alassetsfilter:相当于过滤器,有三个方法,allphotos:获取相册中所有的照片.allvideos:获取相册中所有的视频.allassets:获取照片库中的相册,通过alassetsgroup类中的setassetsfilter来调用
三、alassetslibrary资源库对象
alassetslibrary类用来构建资源库对象,这个对象用来整体操作系统的相册资源,在使用它之前我们可以使用下面的方法来获取用户的授权情况:
|
1
|
+ (alauthorizationstatus)authorizationstatus; |
alauthorizationstatus枚举定义了用户的授权情况,定义如下:
|
1
2
3
4
5
6
|
typedef ns_enum(nsinteger, alauthorizationstatus) { alauthorizationstatusnotdetermined, // 用户尚未选择是否授权 alauthorizationstatusrestricted, //应用尚未授权 alauthorizationstatusdenied), // 用户拒绝授权 alauthorizationstatusauthorized // 用户已经授权} |
如果用户尚未授权过,那么任何访问操作都将触发授权机制。
资源库中的资源数据是以组的方式进行存储,下面代码示例了获取资源组的方式:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
_library = [[alassetslibrary alloc]init];[_library enumerategroupswithtypes:alassetsgroupall usingblock:^(alassetsgroup *group, bool *stop) { if (group) { // 遍历相册还未结束 // 设置过滤器 [group setassetsfilter:[alassetsfilter allphotos]]; if (group.numberofassets) { nslog(@"%@",group); } } else { // 遍历结束(当group为空的时候就意味着结束) nslog(@"没有相册列表了"); } } failureblock:^(nserror *error) { nslog(@"失败");}]; |
上面示例的枚举函数用来根据参数类型获取资源组,alassetsgrouptype参数决定获取组的类型,可选值枚举如下:
|
1
2
3
4
5
6
7
8
9
|
enum { alassetsgrouplibrary ,// 编辑库 alassetsgroupalbum ,//相册库 alassetsgroupevent ,//事件库 alassetsgroupfaces ,// itunes同步 alassetsgroupsavedphotos ,// 保存的相片 alassetsgroupphotostream ,// the photostream album. alassetsgroupall ,//所有库}; |
枚举过程中,我们可以过去到alassetsgroup类型的对象,这个对象中封装了相片资源信息,后面会介绍。
下面列举了alassetslibrary中其他常用的方法:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
//直接通过url来获取资源- (void)assetforurl:(nsurl *)asseturl resultblock:(alassetslibraryassetforurlresultblock)resultblock failureblock:(alassetslibraryaccessfailureblock)failureblock;//直接通过url来获取资源组- (void)groupforurl:(nsurl *)groupurl resultblock:(alassetslibrarygroupresultblock)resultblock failureblock:(alassetslibraryaccessfailureblock)failureblock;//向相册库中添加一个新的资源组 可以自定义名称- (void)addassetsgroupalbumwithname:(nsstring *)name resultblock:(alassetslibrarygroupresultblock)resultblock failureblock:(alassetslibraryaccessfailureblock)failureblock;//向相册中写入一张图片 orientation参数设置图片的方向/*typedef ns_enum(nsinteger, alassetorientation) { alassetorientationup , // 向上 默认的 alassetorientationdown , // 向下 alassetorientationleft , // 向左 alassetorientationright , // 向右 alassetorientationupmirrored , // alassetorientationdownmirrored , // horizontal flip alassetorientationleftmirrored , // vertical flip alassetorientationrightmirrored , // vertical flip};*/- (void)writeimagetosavedphotosalbum:(cgimageref)imageref orientation:(alassetorientation)orientation completionblock:(alassetslibrarywriteimagecompletionblock)completionblock;//向相册中写入一张图片 并可以设置图片的元数据- (void)writeimagetosavedphotosalbum:(cgimageref)imageref metadata:(nsdictionary *)metadata completionblock:(alassetslibrarywriteimagecompletionblock)completionblock;//向相册中写入图片数据 并可以设置元数据- (void)writeimagedatatosavedphotosalbum:(nsdata *)imagedata metadata:(nsdictionary *)metadata completionblock:(alassetslibrarywriteimagecompletionblock)completionblock;//将某个路径的视频写入相册中- (void)writevideoatpathtosavedphotosalbum:(nsurl *)videopathurl completionblock:(alassetslibrarywritevideocompletionblock)completionblock;//检查路径中的视频是否和相册相兼容- (bool)videoatpathiscompatiblewithsavedphotosalbum:(nsurl *)videopathurl; |
当资源库改变时,系统会发出如下通知:
|
1
2
|
//资源库改变的通知extern nsstring *const alassetslibrarychangednotification; |
通知中传递的信息中包含如下字段:
|
1
2
3
4
5
6
7
8
|
//资源库更新extern nsstring *const alassetlibraryupdatedassetskey;//插入组extern nsstring *const alassetlibraryinsertedassetgroupskey;//更新组extern nsstring *const alassetlibraryupdatedassetgroupskey;//删除组extern nsstring *const alassetlibrarydeletedassetgroupskey; |
下面列举了操作过程中的一些异常定义:
|
1
2
3
4
5
6
7
8
9
10
11
12
|
enum { alassetslibraryunknownerror = -1, // 未知错误 alassetslibrarywritefailederror = -3300, //写入错误 alassetslibrarywritebusyerror = -3301, // 写入繁忙 可以重试 alassetslibrarywriteinvaliddataerror = -3302, // 无效数据 alassetslibrarywriteincompatibledataerror = -3303, // 不兼容的数据 alassetslibrarywritedataencodingerror = -3304, // 数据编码错误 alassetslibrarywritediskspaceerror = -3305, // 内存不足 alassetslibrarydataunavailableerror = -3310, // 数据不可用 alassetslibraryaccessuserdeniederror = -3311, // 权限错误 alassetslibraryaccessgloballydeniederror = -3312, // 权限错误}; |
四、alassetsgroup资源组对象
资源组其实就是对应与我们相册中的一组资源,我们可以通过如下的方便遍历出其中的所有资源:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
_library = [[alassetslibrary alloc]init];[_library enumerategroupswithtypes:alassetsgroupall usingblock:^(alassetsgroup *group, bool *stop) { if (group) { // 遍历相册还未结束 // 设置过滤器 [group setassetsfilter:[alassetsfilter allphotos]]; if (group.numberofassets) { [group enumerateassetsusingblock:^(alasset *result, nsuinteger index, bool *stop) { nslog(@"%d:%@",index,result); }]; } } else { // 遍历结束(当group为空的时候就意味着结束) nslog(@"没有相册列表了"); }} failureblock:^(nserror *error) { nslog(@"失败");}]; |
alassetsgroup中相关方法解析如下:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
//获取相关属性/*extern nsstring *const alassetsgrouppropertyname;//组名字extern nsstring *const alassetsgrouppropertytype;//组类型extern nsstring *const alassetsgrouppropertypersistentid; //idextern nsstring *const alassetsgrouppropertyurl;//组url*/- (id)valueforproperty:(nsstring *)property;//获取当前组的缩略图海报- (cgimageref)posterimage;//设置过滤器- (void)setassetsfilter:(alassetsfilter *)filter;//获取组中资源个数- (nsinteger)numberofassets;//进行资源枚举- (void)enumerateassetsusingblock:(alassetsgroupenumerationresultsblock)enumerationblock;/*typedef ns_options(nsuinteger, nsenumerationoptions) { nsenumerationconcurrent = (1ul << 0),//顺序枚举 nsenumerationreverse = (1ul << 1), //逆序枚举};*/- (void)enumerateassetswithoptions:(nsenumerationoptions)options usingblock:(alassetsgroupenumerationresultsblock)enumerationblock;- (void)enumerateassetsatindexes:(nsindexset *)indexset options:(nsenumerationoptions)options usingblock:(alassetsgroupenumerationresultsblock)enumerationblock;//获取当前组是否允许编辑@property (nonatomic, readonly, getter=iseditable) bool editable;//向组中添加一个资源- (bool)addasset:(alasset *)asset; |
上面有提到资源过滤器,资源过滤器用来设置过滤组中的资源,有3个类方法可以直接获取系统提供的过滤器:
|
1
2
3
4
5
6
7
8
|
@interface alassetsfilter : nsobject {//所有图片资源+ (alassetsfilter *)allphotos;// 所有视频资源+ (alassetsfilter *)allvideos;// 所有资源+ (alassetsfilter *)allassets;@end |
五、alasset资源对象
alasset是封装好的资源对象类,如下方法可以获取到资源中封装的属性:
|
1
|
- (id)valueforproperty:(nsstring *)property; |
属性名的定义如下:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
//获取资源类型/*这个属性将返回一个字符串extern nsstring *const alassettypephoto//照片类型extern nsstring *const alassettypevideo//视频类型extern nsstring *const alassettypeunknown//未知类型*/extern nsstring *const alassetpropertytype;//会返回一个cllocation对象 图片的地址信息extern nsstring *const alassetpropertylocation;//视频资源的时长 nsnumber对象extern nsstring *const alassetpropertyduration;//资源方向extern nsstring *const alassetpropertyorientation;//资源日期 会返回nsdate对象extern nsstring *const alassetpropertydate; |
下面列举了alasset中常用方法:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
//获取默认的representation对象- (alassetrepresentation *)defaultrepresentation;//获取指定的representation对象- (alassetrepresentation *)representationforuti:(nsstring *)representationuti;//获取资源缩略图- (cgimageref)thumbnail;- (cgimageref)aspectratiothumbnail;//写入图片数据- (void)writemodifiedimagedatatosavedphotosalbum:(nsdata *)imagedata metadata:(nsdictionary *)metadata completionblock:(alassetslibrarywriteimagecompletionblock)completionblock;//写入视频数据- (void)writemodifiedvideoatpathtosavedphotosalbum:(nsurl *)videopathurl completionblock:(alassetslibrarywritevideocompletionblock)completionblock;//原始资源对象@property (nonatomic, readonly) alasset *originalasset;//是否允许编辑@property (nonatomic, readonly, getter=iseditable) bool editable;//替换图片数据- (void)setimagedata:(nsdata *)imagedata metadata:(nsdictionary *)metadata completionblock:(alassetslibrarywriteimagecompletionblock)completionblock;//替换视频数据- (void)setvideoatpath:(nsurl *)videopathurl completionblock:(alassetslibrarywritevideocompletionblock)completionblock; |
六、关于alassetrepresentation类
每一个alasset对象中都封装了一个alassetrepresentation对象,这个对象的作用是获取资源的详细信息,解析如下:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
//获取uti- (nsstring *)uti;//获取资源的尺寸- (cgsize)dimensions;//获取资源的大小- (long long)size;//读取数据- (nsuinteger)getbytes:(uint8_t *)buffer fromoffset:(long long)offset length:(nsuinteger)length error:(nserror **)error;//获取图片数据- (cgimageref)fullresolutionimage;- (cgimageref)cgimagewithoptions:(nsdictionary *)options;//获取全屏图片- (cgimageref)fullscreenimage;//获取资源url- (nsurl *)url;//获取资源元数据- (nsdictionary *)metadata;//获取资源方向- (alassetorientation)orientation;//缩放比- (float)scale;//获取资源名称- (nsstring *)filename; |
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持米米素材网。
原文链接:https://my.oschina.net/u/2340880/blog/2049513

发表评论