欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  移动技术

iOS开发之AssetsLibrary框架使用详解

程序员文章站 2022-07-04 20:20:42
一、引言 assetslibrary框架是专门用来操作相册相关资源的一个框架,其是ios4到ios9之间常使用的一个框架,在ios9之后,系统系统了photos框架代...

一、引言

assetslibrary框架是专门用来操作相册相关资源的一个框架,其是ios4到ios9之间常使用的一个框架,在ios9之后,系统系统了photos框架代替了assetslibrary框架,但是assetslibrary框架依然可以使用,并且其结构和设计思路依然值得我们进行分析学习。

二、概述

assetslibrary框架会操作系统的相册,因此首先需要进行权限的申请,在使用之前,首先需要在info.plist文件中添加如下键值:

privacy - photo library usage description

assetslibrary框架中核心的类关系如下图所示:

iOS开发之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类用来构建资源库对象,这个对象用来整体操作系统的相册资源,在使用它之前我们可以使用下面的方法来获取用户的授权情况:

+ (alauthorizationstatus)authorizationstatus;

alauthorizationstatus枚举定义了用户的授权情况,定义如下:

typedef ns_enum(nsinteger, alauthorizationstatus) {
  alauthorizationstatusnotdetermined, // 用户尚未选择是否授权
  alauthorizationstatusrestricted,  //应用尚未授权
  alauthorizationstatusdenied),    // 用户拒绝授权
  alauthorizationstatusauthorized   // 用户已经授权
}

如果用户尚未授权过,那么任何访问操作都将触发授权机制。

资源库中的资源数据是以组的方式进行存储,下面代码示例了获取资源组的方式:

  _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参数决定获取组的类型,可选值枚举如下:

enum {
  alassetsgrouplibrary   ,// 编辑库
  alassetsgroupalbum    ,//相册库
  alassetsgroupevent    ,//事件库 
  alassetsgroupfaces    ,// itunes同步
  alassetsgroupsavedphotos ,// 保存的相片
  alassetsgroupphotostream ,// the photostream album.
  alassetsgroupall     ,//所有库
};

枚举过程中,我们可以过去到alassetsgroup类型的对象,这个对象中封装了相片资源信息,后面会介绍。

下面列举了alassetslibrary中其他常用的方法:

//直接通过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;

当资源库改变时,系统会发出如下通知:

//资源库改变的通知
extern nsstring *const alassetslibrarychangednotification;

通知中传递的信息中包含如下字段:

//资源库更新
extern nsstring *const alassetlibraryupdatedassetskey;
//插入组
extern nsstring *const alassetlibraryinsertedassetgroupskey;
//更新组
extern nsstring *const alassetlibraryupdatedassetgroupskey;
//删除组
extern nsstring *const alassetlibrarydeletedassetgroupskey;

下面列举了操作过程中的一些异常定义:

enum {
  alassetslibraryunknownerror =         -1,   // 未知错误
  alassetslibrarywritefailederror =      -3300,   //写入错误
  alassetslibrarywritebusyerror =       -3301,   // 写入繁忙 可以重试
  alassetslibrarywriteinvaliddataerror =   -3302,   // 无效数据
  alassetslibrarywriteincompatibledataerror = -3303,   // 不兼容的数据
  alassetslibrarywritedataencodingerror =   -3304,   // 数据编码错误
  alassetslibrarywritediskspaceerror =    -3305,   // 内存不足
  alassetslibrarydataunavailableerror =    -3310,   // 数据不可用
  alassetslibraryaccessuserdeniederror =   -3311,   // 权限错误
  alassetslibraryaccessgloballydeniederror = -3312,   // 权限错误
};

四、alassetsgroup资源组对象

资源组其实就是对应与我们相册中的一组资源,我们可以通过如下的方便遍历出其中的所有资源:

  _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中相关方法解析如下:

//获取相关属性
/*
extern nsstring *const alassetsgrouppropertyname;//组名字
extern nsstring *const alassetsgrouppropertytype;//组类型
extern nsstring *const alassetsgrouppropertypersistentid; //id
extern 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个类方法可以直接获取系统提供的过滤器:

@interface alassetsfilter : nsobject {
//所有图片资源
+ (alassetsfilter *)allphotos;
// 所有视频资源
+ (alassetsfilter *)allvideos;
// 所有资源
+ (alassetsfilter *)allassets;
@end

五、alasset资源对象

alasset是封装好的资源对象类,如下方法可以获取到资源中封装的属性:

- (id)valueforproperty:(nsstring *)property;

属性名的定义如下:

//获取资源类型
/*
这个属性将返回一个字符串
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中常用方法:

//获取默认的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对象,这个对象的作用是获取资源的详细信息,解析如下:

//获取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;

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。