iOS開發(fā)之AssetsLibrary框架使用詳解

更新時(shí)間：2018年09月20日 11:13:53 作者：琿少

這篇文章主要介紹了iOS開發(fā)之AssetsLibrary框架使用詳解，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧

一、引言

AssetsLibrary框架是專門用來操作相冊(cè)相關(guān)資源的一個(gè)框架，其是iOS4到iOS9之間常使用的一個(gè)框架，在iOS9之后，系統(tǒng)系統(tǒng)了Photos框架代替了AssetsLibrary框架，但是AssetsLibrary框架依然可以使用，并且其結(jié)構(gòu)和設(shè)計(jì)思路依然值得我們進(jìn)行分析學(xué)習(xí)。

二、概述

AssetsLibrary框架會(huì)操作系統(tǒng)的相冊(cè)，因此首先需要進(jìn)行權(quán)限的申請(qǐng)，在使用之前，首先需要在Info.plist文件中添加如下鍵值：

Privacy - Photo Library Usage Description

AssetsLibrary框架中核心的類關(guān)系如下圖所示：

1.ALAssetsLibrary:代表整個(gè)設(shè)備中的照片和視頻,通過ALAssetsLibrary可以獲取和包括設(shè)備中的照片和視頻

2.ALAssetsGroup:映射照片庫中的一個(gè)相冊(cè),通過ALAssetsGroup可以獲取某個(gè)相冊(cè)的信息,相冊(cè)下的照片和視頻,同時(shí)也可以對(duì)某個(gè)相冊(cè)添加資源

3.ALAsset:映射相冊(cè)中的一個(gè)照片或者視頻,通過ALAsset可以獲取某個(gè)照片或者視頻的詳細(xì)信息,獲取保存照片和視頻

4.ALAssetRepresentation:ALAssetRepresentation是對(duì)ALAsset的封裝(但不是其子類),可以更方便地獲取ALAsset中的資源信息,每個(gè)ALAsset都有至少一個(gè)ALAssetRepresentation對(duì)象,可以通過default<Representation獲取.而例如使用系統(tǒng)相機(jī)拍攝的RAW+JPEG照片,則會(huì)有兩個(gè)ALAssetRepresentation對(duì)象,一個(gè)封裝了照片的RAW信息,另一個(gè)則封裝了照片的JPEG信息

5.ALAssetsFilter:相當(dāng)于過濾器,有三個(gè)方法,allPhotos:獲取相冊(cè)中所有的照片.allVideos:獲取相冊(cè)中所有的視頻.allAssets:獲取照片庫中的相冊(cè),通過ALAssetsGroup類中的setAssetsFilter來調(diào)用

三、ALAssetsLibrary資源庫對(duì)象

ALAssetsLibrary類用來構(gòu)建資源庫對(duì)象，這個(gè)對(duì)象用來整體操作系統(tǒng)的相冊(cè)資源，在使用它之前我們可以使用下面的方法來獲取用戶的授權(quán)情況：

+ (ALAuthorizationStatus)authorizationStatus;

ALAuthorizationStatus枚舉定義了用戶的授權(quán)情況，定義如下：

typedef NS_ENUM(NSInteger, ALAuthorizationStatus) {
  ALAuthorizationStatusNotDetermined, // 用戶尚未選擇是否授權(quán)
  ALAuthorizationStatusRestricted,  //應(yīng)用尚未授權(quán)
  ALAuthorizationStatusDenied),    // 用戶拒絕授權(quán)
  ALAuthorizationStatusAuthorized   // 用戶已經(jīng)授權(quán)
}

如果用戶尚未授權(quán)過，那么任何訪問操作都將觸發(fā)授權(quán)機(jī)制。

資源庫中的資源數(shù)據(jù)是以組的方式進(jìn)行存儲(chǔ)，下面代碼示例了獲取資源組的方式：

  _library = [[ALAssetsLibrary alloc]init];
  [_library enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
    if (group) { // 遍歷相冊(cè)還未結(jié)束
      // 設(shè)置過濾器
      [group setAssetsFilter:[ALAssetsFilter allPhotos]];
      if (group.numberOfAssets) {
        NSLog(@"%@",group);
      }
    } else { // 遍歷結(jié)束（當(dāng)group為空的時(shí)候就意味著結(jié)束）
      
        NSLog(@"沒有相冊(cè)列表了");
      
    }
    
  } failureBlock:^(NSError *error) {
    NSLog(@"失敗");
  }];

上面示例的枚舉函數(shù)用來根據(jù)參數(shù)類型獲取資源組，ALAssetsGroupType參數(shù)決定獲取組的類型，可選值枚舉如下：

enum {
  ALAssetsGroupLibrary   ,// 編輯庫
  ALAssetsGroupAlbum    ,//相冊(cè)庫
  ALAssetsGroupEvent    ,//事件庫 
  ALAssetsGroupFaces    ,// iTunes同步
  ALAssetsGroupSavedPhotos ,// 保存的相片
  ALAssetsGroupPhotoStream ,// The PhotoStream album.
  ALAssetsGroupAll     ,//所有庫
};

枚舉過程中，我們可以過去到ALAssetsGroup類型的對(duì)象，這個(gè)對(duì)象中封裝了相片資源信息，后面會(huì)介紹。

下面列舉了ALAssetsLibrary中其他常用的方法：

//直接通過URL來獲取資源
- (void)assetForURL:(NSURL *)assetURL resultBlock:(ALAssetsLibraryAssetForURLResultBlock)resultBlock failureBlock:(ALAssetsLibraryAccessFailureBlock)failureBlock;
//直接通過URL來獲取資源組
- (void)groupForURL:(NSURL *)groupURL resultBlock:(ALAssetsLibraryGroupResultBlock)resultBlock failureBlock:(ALAssetsLibraryAccessFailureBlock)failureBlock;
//向相冊(cè)庫中添加一個(gè)新的資源組 可以自定義名稱
- (void)addAssetsGroupAlbumWithName:(NSString *)name resultBlock:(ALAssetsLibraryGroupResultBlock)resultBlock failureBlock:(ALAssetsLibraryAccessFailureBlock)failureBlock;
//向相冊(cè)中寫入一張圖片 orientation參數(shù)設(shè)置圖片的方向
/*
typedef NS_ENUM(NSInteger, ALAssetOrientation) {
  ALAssetOrientationUp ,      // 向上 默認(rèn)的
  ALAssetOrientationDown ,     // 向下
  ALAssetOrientationLeft ,     // 向左
  ALAssetOrientationRight ,     // 向右
  ALAssetOrientationUpMirrored ,  //
  ALAssetOrientationDownMirrored , // horizontal flip
  ALAssetOrientationLeftMirrored , // vertical flip
  ALAssetOrientationRightMirrored , // vertical flip
};
*/
- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef orientation:(ALAssetOrientation)orientation completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
//向相冊(cè)中寫入一張圖片 并可以設(shè)置圖片的元數(shù)據(jù)
- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
//向相冊(cè)中寫入圖片數(shù)據(jù) 并可以設(shè)置元數(shù)據(jù)
- (void)writeImageDataToSavedPhotosAlbum:(NSData *)imageData metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
//將某個(gè)路徑的視頻寫入相冊(cè)中
- (void)writeVideoAtPathToSavedPhotosAlbum:(NSURL *)videoPathURL completionBlock:(ALAssetsLibraryWriteVideoCompletionBlock)completionBlock;
//檢查路徑中的視頻是否和相冊(cè)相兼容
- (BOOL)videoAtPathIsCompatibleWithSavedPhotosAlbum:(NSURL *)videoPathURL;

當(dāng)資源庫改變時(shí)，系統(tǒng)會(huì)發(fā)出如下通知：

//資源庫改變的通知
extern NSString *const ALAssetsLibraryChangedNotification;

通知中傳遞的信息中包含如下字段：

//資源庫更新
extern NSString *const ALAssetLibraryUpdatedAssetsKey;
//插入組
extern NSString *const ALAssetLibraryInsertedAssetGroupsKey;
//更新組
extern NSString *const ALAssetLibraryUpdatedAssetGroupsKey;
//刪除組
extern NSString *const ALAssetLibraryDeletedAssetGroupsKey;

下面列舉了操作過程中的一些異常定義：

enum {
  ALAssetsLibraryUnknownError =         -1,   // 未知錯(cuò)誤
  ALAssetsLibraryWriteFailedError =      -3300,   //寫入錯(cuò)誤
  ALAssetsLibraryWriteBusyError =       -3301,   // 寫入繁忙 可以重試
  ALAssetsLibraryWriteInvalidDataError =   -3302,   // 無效數(shù)據(jù)
  ALAssetsLibraryWriteIncompatibleDataError = -3303,   // 不兼容的數(shù)據(jù)
  ALAssetsLibraryWriteDataEncodingError =   -3304,   // 數(shù)據(jù)編碼錯(cuò)誤
  ALAssetsLibraryWriteDiskSpaceError =    -3305,   // 內(nèi)存不足
  ALAssetsLibraryDataUnavailableError =    -3310,   // 數(shù)據(jù)不可用
  ALAssetsLibraryAccessUserDeniedError =   -3311,   // 權(quán)限錯(cuò)誤
  ALAssetsLibraryAccessGloballyDeniedError = -3312,   // 權(quán)限錯(cuò)誤
};

四、ALAssetsGroup資源組對(duì)象

資源組其實(shí)就是對(duì)應(yīng)與我們相冊(cè)中的一組資源，我們可以通過如下的方便遍歷出其中的所有資源：

  _library = [[ALAssetsLibrary alloc]init];
  [_library enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
    if (group) { // 遍歷相冊(cè)還未結(jié)束
      // 設(shè)置過濾器
      [group setAssetsFilter:[ALAssetsFilter allPhotos]];
      if (group.numberOfAssets) {
        [group enumerateAssetsUsingBlock:^(ALAsset *result, NSUInteger index, BOOL *stop) {
          NSLog(@"%d:%@",index,result);
        }];
      }
    } else { // 遍歷結(jié)束（當(dāng)group為空的時(shí)候就意味著結(jié)束）

        NSLog(@"沒有相冊(cè)列表了");
    }

  } failureBlock:^(NSError *error) {
    NSLog(@"失敗");
  }];

ALAssetsGroup中相關(guān)方法解析如下：

//獲取相關(guān)屬性
/*
extern NSString *const ALAssetsGroupPropertyName;//組名字
extern NSString *const ALAssetsGroupPropertyType;//組類型
extern NSString *const ALAssetsGroupPropertyPersistentID; //ID
extern NSString *const ALAssetsGroupPropertyURL;//組URL
*/
- (id)valueForProperty:(NSString *)property;
//獲取當(dāng)前組的縮略圖海報(bào)
- (CGImageRef)posterImage;
//設(shè)置過濾器
- (void)setAssetsFilter:(ALAssetsFilter *)filter;
//獲取組中資源個(gè)數(shù)
- (NSInteger)numberOfAssets;
//進(jìn)行資源枚舉
- (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;
//獲取當(dāng)前組是否允許編輯
@property (nonatomic, readonly, getter=isEditable) BOOL editable;
//向組中添加一個(gè)資源
- (BOOL)addAsset:(ALAsset *)asset;

上面有提到資源過濾器，資源過濾器用來設(shè)置過濾組中的資源，有3個(gè)類方法可以直接獲取系統(tǒng)提供的過濾器：

@interface ALAssetsFilter : NSObject {
//所有圖片資源
+ (ALAssetsFilter *)allPhotos;
// 所有視頻資源
+ (ALAssetsFilter *)allVideos;
// 所有資源
+ (ALAssetsFilter *)allAssets;
@end

五、ALAsset資源對(duì)象

ALAsset是封裝好的資源對(duì)象類，如下方法可以獲取到資源中封裝的屬性：

- (id)valueForProperty:(NSString *)property;

屬性名的定義如下：

//獲取資源類型
/*
這個(gè)屬性將返回一個(gè)字符串
extern NSString *const ALAssetTypePhoto//照片類型
extern NSString *const ALAssetTypeVideo//視頻類型
extern NSString *const ALAssetTypeUnknown//未知類型
*/
extern NSString *const ALAssetPropertyType;
//會(huì)返回一個(gè)CLLocation對(duì)象 圖片的地址信息
extern NSString *const ALAssetPropertyLocation;
//視頻資源的時(shí)長 NSNumber對(duì)象
extern NSString *const ALAssetPropertyDuration;
//資源方向
extern NSString *const ALAssetPropertyOrientation;
//資源日期 會(huì)返回NSDate對(duì)象
extern NSString *const ALAssetPropertyDate;

下面列舉了ALAsset中常用方法：

//獲取默認(rèn)的Representation對(duì)象
- (ALAssetRepresentation *)defaultRepresentation;
//獲取指定的Representation對(duì)象
- (ALAssetRepresentation *)representationForUTI:(NSString *)representationUTI;
//獲取資源縮略圖
- (CGImageRef)thumbnail;
- (CGImageRef)aspectRatioThumbnail;
//寫入圖片數(shù)據(jù)
- (void)writeModifiedImageDataToSavedPhotosAlbum:(NSData *)imageData metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
//寫入視頻數(shù)據(jù)
- (void)writeModifiedVideoAtPathToSavedPhotosAlbum:(NSURL *)videoPathURL completionBlock:(ALAssetsLibraryWriteVideoCompletionBlock)completionBlock;
//原始資源對(duì)象
@property (nonatomic, readonly) ALAsset *originalAsset;
//是否允許編輯
@property (nonatomic, readonly, getter=isEditable) BOOL editable;
//替換圖片數(shù)據(jù)
- (void)setImageData:(NSData *)imageData metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
//替換視頻數(shù)據(jù)
- (void)setVideoAtPath:(NSURL *)videoPathURL completionBlock:(ALAssetsLibraryWriteVideoCompletionBlock)completionBlock;

六、關(guān)于ALAssetRepresentation類

每一個(gè)ALAsset對(duì)象中都封裝了一個(gè)ALAssetRepresentation對(duì)象，這個(gè)對(duì)象的作用是獲取資源的詳細(xì)信息，解析如下：

//獲取UTI
- (NSString *)UTI;
//獲取資源的尺寸
- (CGSize)dimensions;
//獲取資源的大小
- (long long)size;
//讀取數(shù)據(jù)
- (NSUInteger)getBytes:(uint8_t *)buffer fromOffset:(long long)offset length:(NSUInteger)length error:(NSError **)error;
//獲取圖片數(shù)據(jù)
- (CGImageRef)fullResolutionImage;
- (CGImageRef)CGImageWithOptions:(NSDictionary *)options;
//獲取全屏圖片
- (CGImageRef)fullScreenImage;
//獲取資源URL
- (NSURL *)url;
//獲取資源元數(shù)據(jù)
- (NSDictionary *)metadata;
//獲取資源方向
- (ALAssetOrientation)orientation;
//縮放比
- (float)scale;
//獲取資源名稱
- (NSString *)filename;

以上就是本文的全部內(nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: