一、引言
AssetsLibrary框架是专门用来操作相册相关资源的一个框架，其是iOS4到iOS9之间常使用的一个框架，在iOS9之后，系统系统了Photos框架代替了AssetsLibrary框架，但是AssetsLibrary框架依然可以使用，并且其结构和设计思路依然值得我们进行分析学习。
二、概述
AssetsLibrary框架会操作系统的相册，因此首先需要进行权限的申请，在使用之前，首先需要在Info.plist文件中添加如下键值：
Privacy - Photo Library Usage Description
AssetsLibrary框架中核心的类关系如下图所示：
三、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, // 权限错误
};
