iOS開發(fā)之AssetsLibrary框架使用詳解
一、引言
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í)長(zhǎng) 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;
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
- Android加載Assets目錄中Xml布局文件
- Android復(fù)制assets文件到SD卡
- Android實(shí)現(xiàn)復(fù)制Assets文件到SD卡
- 詳解vue2.0 資源文件assets和static的區(qū)別
- Android studio 添加assets文件夾的方法
- 詳解Vue-cli中的靜態(tài)資源管理(src/assets和static/的區(qū)別)
- vue2.0 資源文件assets和static的區(qū)別詳解
- Android開發(fā)實(shí)現(xiàn)讀取Assets下文件及文件寫入存儲(chǔ)卡的方法
- android讀取assets中Excel表格并顯示
- Android獲取其他應(yīng)用中的assets資源
相關(guān)文章
iOS實(shí)現(xiàn)搭建聊天頁面的實(shí)例代碼
本篇文章主要介紹了iOS實(shí)現(xiàn)搭建聊天頁面的實(shí)例代碼,小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2017-07-07iOS開發(fā)之路--微博OAuth授權(quán)_取得用戶授權(quán)的accessToken
本文是IOS開發(fā)之路系列文章的第二篇,講訴的內(nèi)容是如何使用微博OAuth授權(quán),并付源碼,然后詳細(xì)講解了取得用戶授權(quán)的accessToken,希望對(duì)大家有所幫助2014-08-08iOS 9 更新之Safari廣告攔截器(Content Blocker)開發(fā)教程
這篇文章主要介紹了iOS 9 更新之Safari廣告攔截器(Content Blocker)開發(fā)教程的相關(guān)資料,需要的朋友可以參考下2015-08-08iOS中滑動(dòng)控制屏幕亮度和系統(tǒng)音量(附加AVAudioPlayer基本用法和Masonry簡(jiǎn)單使用)
這篇文章主要介紹了iOS中滑動(dòng)控制屏幕亮度和系統(tǒng)音量(附加AVAudioPlayer基本用法和Masonry簡(jiǎn)單使用)的相關(guān)資料,需要的朋友可以參考下2016-12-12iOS開發(fā)之1行代碼實(shí)現(xiàn)緩存計(jì)算及清除緩存
這篇文章主要給大家介紹了關(guān)于iOS開發(fā)之1行代碼實(shí)現(xiàn)緩存計(jì)算及清除緩存的相關(guān)資料,文中通過示例代碼介紹的非常詳細(xì),對(duì)各位iOS開發(fā)者們具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面來一起學(xué)習(xí)學(xué)習(xí)吧2020-05-05iOS開發(fā)之topLayoutGuide和bottomLayoutGuide的使用小技巧分享
這篇文章主要給大家介紹了關(guān)于iOS開發(fā)之topLayoutGuide和bottomLayoutGuide使用的一些小技巧,需要的朋友可以參考下2017-11-11