一、引言
AssetsLibrary框架是專門用來操作相冊相關(guān)資源的一個框架，其是iOS4到iOS9之間常使用的一個框架，在iOS9之后，系統(tǒng)系統(tǒng)了Photos框架代替了AssetsLibrary框架，但是AssetsLibrary框架依然可以使用，并且其結(jié)構(gòu)和設(shè)計思路依然值得我們進(jìn)行分析學(xué)習(xí)。
二、概述
AssetsLibrary框架會操作系統(tǒng)的相冊，因此首先需要進(jìn)行權(quán)限的申請，在使用之前，首先需要在Info.plist文件中添加如下鍵值：
Privacy - Photo Library Usage Description
AssetsLibrary框架中核心的類關(guān)系如下圖所示：
1.ALAssetsLibrary:代表整個設(shè)備中的照片和視頻,通過ALAssetsLibrary可以獲取和包括設(shè)備中的照片和視頻
2.ALAssetsGroup:映射照片庫中的一個相冊,通過ALAssetsGroup可以獲取某個相冊的信息,相冊下的照片和視頻,同時也可以對某個相冊添加資源
3.ALAsset:映射相冊中的一個照片或者視頻,通過ALAsset可以獲取某個照片或者視頻的詳細(xì)信息,獲取保存照片和視頻
4.ALAssetRepresentation:ALAssetRepresentation是對ALAsset的封裝(但不是其子類),可以更方便地獲取ALAsset中的資源信息,每個ALAsset都有至少一個ALAssetRepresentation對象,可以通過default<Representation獲取.而例如使用系統(tǒng)相機(jī)拍攝的RAW+JPEG照片,則會有兩個ALAssetRepresentation對象,一個封裝了照片的RAW信息,另一個則封裝了照片的JPEG信息
5.ALAssetsFilter:相當(dāng)于過濾器,有三個方法,allPhotos:獲取相冊中所有的照片.allVideos:獲取相冊中所有的視頻.allAssets:獲取照片庫中的相冊,通過ALAssetsGroup類中的setAssetsFilter來調(diào)用
三、ALAssetsLibrary資源庫對象
ALAssetsLibrary類用來構(gòu)建資源庫對象，這個對象用來整體操作系統(tǒng)的相冊資源，在使用它之前我們可以使用下面的方法來獲取用戶的授權(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)行存儲，下面代碼示例了獲取資源組的方式：
_library = [[ALAssetsLibrary alloc]init]; [_library enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) { if (group) { // 遍歷相冊還未結(jié)束 // 設(shè)置過濾器 [group setAssetsFilter:[ALAssetsFilter allPhotos]]; if (group.numberOfAssets) { NSLog(@"%@",group); } } else { // 遍歷結(jié)束（當(dāng)group為空的時候就意味著結(jié)束） NSLog(@"沒有相冊列表了"); } } failureBlock:^(NSError *error) { NSLog(@"失敗"); }];上面示例的枚舉函數(shù)用來根據(jù)參數(shù)類型獲取資源組，ALAssetsGroupType參數(shù)決定獲取組的類型，可選值枚舉如下：
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參數(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;//向相冊中寫入一張圖片 并可以設(shè)置圖片的元數(shù)據(jù)- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;//向相冊中寫入圖片數(shù)據(jù) 并可以設(shè)置元數(shù)據(jù)- (void)writeImageDataToSavedPhotosAlbum:(NSData *)imageData metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;//將某個路徑的視頻寫入相冊中- (void)writeVideoAtPathToSavedPhotosAlbum:(NSURL *)videoPathURL completionBlock:(ALAssetsLibraryWriteVideoCompletionBlock)completionBlock;//檢查路徑中的視頻是否和相冊相兼容- (BOOL)videoAtPathIsCompatibleWithSavedPhotosAlbum:(NSURL *)videoPathURL;當(dāng)資源庫改變時，系統(tǒng)會發(fā)出如下通知：
//資源庫改變的通知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, // 無效數(shù)據(jù) ALAssetsLibraryWriteIncompatibleDataError = -3303, // 不兼容的數(shù)據(jù) ALAssetsLibraryWriteDataEncodingError = -3304, // 數(shù)據(jù)編碼錯誤 ALAssetsLibraryWriteDiskSpaceError = -3305, // 內(nèi)存不足 ALAssetsLibraryDataUnavailableError = -3310, // 數(shù)據(jù)不可用 ALAssetsLibraryAccessUserDeniedError = -3311, // 權(quán)限錯誤 ALAssetsLibraryAccessGloballyDeniedError = -3312, // 權(quán)限錯誤};四、ALAssetsGroup資源組對象
資源組其實就是對應(yīng)與我們相冊中的一組資源，我們可以通過如下的方便遍歷出其中的所有資源：
_library = [[ALAssetsLibrary alloc]init]; [_library enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) { if (group) { // 遍歷相冊還未結(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為空的時候就意味著結(jié)束） NSLog(@"沒有相冊列表了"); } } failureBlock:^(NSError *error) { NSLog(@"失敗"); }];ALAssetsGroup中相關(guān)方法解析如下：
//獲取相關(guān)屬性/*extern NSString *const ALAssetsGroupPropertyName;//組名字extern NSString *const ALAssetsGroupPropertyType;//組類型extern NSString *const ALAssetsGroupPropertyPersistentID; //IDextern NSString *const ALAssetsGroupPropertyURL;//組URL*/- (id)valueForProperty:(NSString *)property;//獲取當(dāng)前組的縮略圖海報- (CGImageRef)posterImage;//設(shè)置過濾器- (void)setAssetsFilter:(ALAssetsFilter *)filter;//獲取組中資源個數(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;//向組中添加一個資源- (BOOL)addAsset:(ALAsset *)asset;上面有提到資源過濾器，資源過濾器用來設(shè)置過濾組中的資源，有3個類方法可以直接獲取系統(tǒng)提供的過濾器：
@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中常用方法：
//獲取默認(rèn)的Representation對象- (ALAssetRepresentation *)defaultRepresentation;//獲取指定的Representation對象- (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;//原始資源對象@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類
每一個ALAsset對象中都封裝了一個ALAssetRepresentation對象，這個對象的作用是獲取資源的詳細(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)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持VEVB武林網(wǎng)。
新聞熱點
疑難解答
圖片精選
