好些天沒寫點東西了象缀,最近公司要做新項目摩疑,有點小忙粤铭。不想我的堅持就此中斷吴侦,我把我前些天研究的東西拿出來給大家看看屋休。
這次整理的是AssetsLibrary和PhotoKit的使用。本人處女座备韧,有點強迫癥劫樟,之前寫的項目里用的是AssetsLibrary寫的調(diào)取相冊內(nèi)的媒體文件,但是Xcode總是報警告錯誤,雖然能夠編譯并展示效果叠艳,但是十幾個警告錯誤掛在那奶陈,心里總不是滋味,所以我就研究了一下AssetLibrary和PhotoKit附较。
在 iOS 8 出現(xiàn)之前尿瞭,開發(fā)者只能使用 AssetsLibrary 框架來訪問設(shè)備的照片庫,這是一個有點跟不上 iOS 應(yīng)用發(fā)展步伐以及代碼設(shè)計原則但確實強大的框架翅睛,考慮到 iOS7 仍占有不少的滲透率声搁,因此 AssetsLibrary 也是本文重點介紹的部分。而在 iOS8 出現(xiàn)之后捕发,蘋果提供了一個名為 PhotoKit 的框架疏旨,一個可以讓應(yīng)用更好地與設(shè)備照片庫對接的框架。
一扎酷、AssetsLibrary 組成##
AssetsLibrary 的組成比較符合照片庫本身的組成檐涝,照片庫中的完整照片庫對象、相冊法挨、相片都能在 AssetsLibrary 中找到一一對應(yīng)的組成谁榜,這使到 AssetsLibrary 的使用變得直觀而方便。想要了解AssetsLibrary得從它的類開始凡纳。
AssetsLibrary: 代表整個設(shè)備中的資源庫(照片庫)窃植,通過 AssetsLibrary 可以獲取和包括設(shè)備中的照片和視頻
- ALAssetsGroup: 映射照片庫中的一個相冊,通過 ALAssetsGroup 可以獲取某個相冊的信息荐糜,相 冊下的資源巷怜,同時也可以對某個相冊添加資源。
- ALAsset: 映射照片庫中的一個照片或視頻暴氏,通過 ALAsset 可以獲取某個照片或視頻的詳細(xì)信息延塑, 或者保存照片和視頻。
- ALAssetRepresentation: ALAssetRepresentation 是對 ALAsset 的封裝(但不是其子類)答渔,可以更方便地獲取 ALAsset 中的資源信息关带,每個 ALAsset 都有至少有一個 ALAssetRepresentation 對象,可以通過 defaultRepresentation 獲取沼撕。而例如使用系統(tǒng)相機應(yīng)用拍攝的 RAW + JPEG 照片宋雏,則會有兩個 ALAssetRepresentation,一個封裝了照片的 RAW 信息端朵,另一個則封裝了照片的 JPEG 信息好芭。
二、AssetsLibrary 的基本使用##
AssetsLibrary 的功能很多冲呢,基本可以分為對資源的獲取/保存兩個部分,保存的部分相對簡單招狸,API 也比較少敬拓,因此這里不作詳細(xì)介紹邻薯。獲取資源的 API 則比較豐富了,一個常見的使用大量 AssetsLibrary API 的例子就是圖片選擇器(ALAsset Picker)乘凸。要制作一個圖片選擇器厕诡,思路應(yīng)該是獲取照片庫-列出所有相冊-展示相冊中的所有圖片-預(yù)覽圖片大圖。
首先是App 照片操作授權(quán):
NSString *tipTextWhenNoPhotosAuthorization; // 提示語
// 獲取當(dāng)前應(yīng)用對照片的訪問授權(quán)狀態(tài)
ALAuthorizationStatus authorizationStatus = [ALAssetsLibrary authorizationStatus];
// 如果沒有獲取訪問授權(quán)营勤,或者訪問授權(quán)狀態(tài)已經(jīng)被明確禁止灵嫌,則顯示提示語,引導(dǎo)用戶開啟授權(quán)
if (authorizationStatus == ALAuthorizationStatusRestricted || authorizationStatus == ALAuthorizationStatusDenied) {
NSDictionary *mainInfoDictionary = [[NSBundle mainBundle] infoDictionary];
NSString *appName = [mainInfoDictionary objectForKey:@"CFBundleDisplayName"];
tipTextWhenNoPhotosAuthorization = [NSString stringWithFormat:@"請在設(shè)備的\"設(shè)置-隱私-照片\"選項中葛作,允許%@訪問你的手機相冊", appName];
// 展示提示語
}
如果已經(jīng)獲取授權(quán)寿羞,則可以獲取相冊列表:
_assetsLibrary = [[ALAssetsLibrary alloc] init];
_albumsArray = [[NSMutableArray alloc] init];
[_assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
if (group) {
[group setAssetsFilter:[ALAssetsFilter allPhotos]];
if (group.numberOfAssets > 0) {
// 把相冊儲存到數(shù)組中,方便后面展示相冊時使用
[_albumsArray addObject:group];
}
} else {
if ([_albumsArray count] > 0) {
// 把所有的相冊儲存完畢赂蠢,可以展示相冊列表
} else {
// 沒有任何有資源的相冊绪穆,輸出提示
}
}
} failureBlock:^(NSError *error) {
NSLog(@"Asset group not found!\n");
}];
上面的代碼中,遍歷出所有的相冊列表虱岂,并把相冊中資源數(shù)不為空的相冊 ALAssetGroup 對象的引用儲存到一個數(shù)組中玖院。這里需要強調(diào)幾點:
- iOS 中允許相冊為空,即相冊中沒有任何資源第岖,如果不希望獲取空相冊难菌,則需要像上面的代碼中那樣手動過濾。
- ALAssetsGroup 有一個 setAssetsFilter 的方法蔑滓,可以傳入一個過濾器扔傅,控制只獲取相冊中的照片或只獲取視頻。一旦設(shè)置過濾烫饼,ALAssetsGroup 中資源列表和資源數(shù)量的獲取也會被自動更新猎塞。
- 整個 AssetsLibrary 中對相冊、資源的獲取和保存都是使用異步處理(Asynchronous)杠纵,這是考慮到資源文件體積相當(dāng)比較大(還可能很大)荠耽。例如上面的遍歷相冊操作,相冊的結(jié)果使用 block 輸出比藻,如果相冊遍歷完畢铝量,則最后一次輸出的 block 中的 group 參數(shù)值為 nil。而 stop 參數(shù)則是用于手工停止遍歷银亲,只要把 *stop 置 YES慢叨,則會停止下一次的遍歷。關(guān)于這一點常常會引起誤會务蝠,所以需要注意拍谐。
現(xiàn)在,已經(jīng)可以獲取相冊了,接下來是獲取相冊中的資源:
_imagesAssetArray = [[NSMutableArray alloc] init];
[assetsGroup enumerateAssetsWithOptions:NSEnumerationReverse usingBlock:^(ALAsset *result, NSUInteger index, BOOL *stop) {
if (result) {
[_imagesAssetArray addObject:result];
} else {
// result 為 nil轩拨,即遍歷相片或視頻完畢践瓷,可以展示資源列表
}
}];
跟遍歷相冊的過程類似,遍歷相片也是使用一系列的異步方法亡蓉,其中上面的方法所輸出的 block 中晕翠,除了 result 參數(shù)表示資源信息,stop 用于手工停止遍歷外砍濒,還提供了一個 index 參數(shù)淋肾,這個參數(shù)表示資源的索引。一般來說爸邢,展示資源列表都會使用縮略圖(result.thumbnail)樊卓,因此即使資源很多,遍歷資源的速度也會相當(dāng)快甲棍。但如果確實需要加載資源的高清圖或者其他耗時的處理简识,則可以利用上面的 index 參數(shù)和 stop 參數(shù)做一個分段拉取資源。例如:
NSUInteger _targetIndex; // index 目標(biāo)值感猛,拉取資源直到這個值就手工停止拉取
NSUInteger _currentIndex; // 當(dāng)前 index七扰,每次拉取資源時從這個值開始
_targetIndex = 50;
_currentIndex = 0;
- (void)loadAssetWithAssetsGroup:(assetsGroup *)assetsGroup {
[assetsGroup enumerateAssetsAtIndexes:[NSIndexSet indexSetWithIndex:_currentIndex] options:NSEnumerationReverse usingBlock:^(ALAsset *result, NSUInteger index, BOOL *stop) {
_currentIndex = index;
if (index > _targetIndex) {
// 拉取資源的索引如果比目標(biāo)值大,則停止拉取
*stop = YES;
} else {
if (result) {
[_imagesAssetArray addObject:result];
} else {
// result 為 nil陪白,即遍歷相片或視頻完畢
}
}
}];
}// 之前拉取的數(shù)據(jù)已經(jīng)顯示完畢颈走,需要展示新數(shù)據(jù),重新調(diào)用 loadAssetWithAssetsGroup 方法咱士,并根據(jù)需要更新 _targetIndex 的值
最后一步是獲取圖片詳細(xì)信息立由,例如:
// 獲取資源圖片的詳細(xì)資源信息,其中 imageAsset 是某個資源的 ALAsset 對象
ALAssetRepresentation *representation = [imageAsset defaultRepresentation];
// 獲取資源圖片的 fullScreenImage
UIImage *contentImage = [UIImage imageWithCGImage:[representation fullScreenImage]];
對于一個 ALAssetRepresentation序厉,里面包含了圖片的多個版本锐膜。最常用的是 fullResolutionImage 和 fullScreenImage。fullResolutionImage 是圖片的原圖弛房,通過 fullResolutionImage 獲取的圖片沒有任何處理道盏,包括通過系統(tǒng)相冊中“編輯”功能處理后的信息也沒有被包含其中,因此需要展示“編輯”功能處理后的信息文捶,使用 fullResolutionImage 就比較不方便荷逞,另外 fullResolutionImage 的拉取也會比較慢,在多張 fullResolutionImage 中切換時能明顯感覺到圖片的加載過程粹排。因此這里建議獲取圖片的 fullScreenImage种远,它是圖片的全屏圖版本,這個版本包含了通過系統(tǒng)相冊中“編輯”功能處理后的信息顽耳,同時也是一張縮略圖坠敷,但圖片的失真很少妙同,缺點是圖片的尺寸是一個適應(yīng)屏幕大小的版本,因此展示圖片時需要作出額外處理常拓,但考慮到加載速度非辰ト埽快的原因(在多張圖片之間切換感受不到圖片加載耗時)辉浦,仍建議使用 fullScreenImage弄抬。
系統(tǒng)相冊的處理過程大概也是如上,可以看出宪郊,在整個過程中并沒有使用到圖片的 fullResolutionImage掂恕,從相冊列表展示到最終查看資源,都是使用縮略圖弛槐,這也是 iOS 相冊加載快的一個重要原因懊亡。
這里我整理一個demo,歡迎大家給予指正乎串。demo鏈接如下:https://github.com/Snoopy008/ChooseAlbumFile
結(jié)語##
由于時間有限店枣,我還是將PhotoKit的內(nèi)容放在下一篇。敬請期待叹誉。鸯两。。长豁。