AssetLibrary組成
AssetLibrary:代表整個設備中的資源庫(照片庫),通過AssetLibrary可以獲取設備中的照片和視頻,同時也可以增加相冊或將照片寫入相冊
ALAssetsGroup:映射照片庫中的相冊組,通過ALAssetsGroup可以獲取某個相冊的信息以及相冊下的資源素跺,同時也可以對某個相冊添加資源
ALAsset:映射照片庫中的一個照片或者視頻,通過ALAsset可以獲取某個照片或者視頻的詳細信息,或者保存照片和視頻
ALAssetRepressentation:ALAssetRepresentation 是對 ALAsset 的封裝(但不是其子類),可以更方便地獲取 ALAsset 中的資源信息埠居,每個 ALAsset 都有至少有一個 ALAssetRepresentation 對象,可以通過 defaultRepresentation 獲取事期。而例如使用系統(tǒng)相機應用拍攝的 RAW + JPEG 照片滥壕,則會有兩個 ALAssetRepresentation,一個封裝了照片的 RAW 信息兽泣,另一個則封裝了照片的 JPEG 信息
AssetLibrary方法
將圖片寫入相冊的方法:
//將圖片寫入相冊中绎橘,圖片是CGImage類型的,可以通過[UIImage CGImage]來獲得
- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef orientation:(ALAssetOrientation)orientation completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock
//將圖片保存到相冊唠倦,同時在metadata字典中指定圖片的方向
- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock
//將圖片保存到相冊金踪,同時如果圖像數(shù)據(jù)和元數(shù)據(jù)沖突,圖像數(shù)據(jù)將被重寫
//有關元數(shù)據(jù)可以看這一篇文章 http://blog.csdn.net/zhi_sheng/article/details/52595523
- (void)writeImageDataToSavedPhotosAlbum:(NSData *)imageData metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock
在上面的方法中orientation有這么幾個選項:
ALAssetOrientationUp 上
ALAssetOrientationDown 下
ALAssetOrientationLeft 左
ALAssetOrientationRight 右
ALAssetOrientationUpMirrored 水平上翻轉
ALAssetOrientationDownMirrored 水平下翻轉
ALAssetOrientationLeftMirrored 豎直左翻轉
ALAssetOrientationRightMirrored 豎直右翻轉
從相冊資源庫讀取相冊的方法:
//遍歷AssetLibrary得到的是ALAssetsGroup
- (void)enumerateGroupsWithTypes:(ALAssetsGroupType)types usingBlock:(ALAssetsLibraryGroupsEnumerationResultsBlock)enumerationBlock failureBlock:(ALAssetsLibraryAccessFailureBlock)failureBlock
types的類型:
ALAssetsGroupLibrary 所有的相冊(包括本地和 iTunes 的)
ALAssetsGroupAlbum 同步得到iTunes的和創(chuàng)建的(不包括共享的)
ALAssetsGroupEvent 同步到 iTunes 的(包括相機導入的)
ALAssetsGroupFaces 同步 iTunes 的
ALAssetsGroupSavedPhotos 所有相冊(包括相機導入的)
ALAssetsGroupPhotoStream itunes 同步的(包括共享的)
ALAssetsGroupAll 所有可見的相冊
使用代碼范例:
ALAssetsLibrary *assetsLibrary;
NSMutableArray *groupArray;
assetsLibrary = [[ALAssetsLibrary alloc] init];
groupArray=[[NSMutableArray alloc] initWithCapacity:1];
[assetsLibrary enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
if (group) {
[groupArray addObject:group];
// 通過這個可以知道相冊的名字牵敷,從而也可以知道安裝的部分應用
//例如 Name:柚子相機, Type:Album, Assets count:1
NSLog(@"%@",group);
}
} failureBlock:^(NSError *error) {
NSLog(@"Group not found!\n");
}];
//該方法為異步執(zhí)行的方法,會在調用此方法的線程內(nèi)執(zhí)行
ALAssetsGroup的方法以及屬性
- (id)valueForProperty:(NSString *)property:返回相冊的一些屬性它有以下幾個鍵:
extern NSString *const ALAssetsGroupPropertyName 相冊的名稱
extern NSString *const ALAssetsGroupPropertyType 相冊的類型
extern NSString *const ALAssetsGroupPropertyPersistentID 相冊的標示 id
extern NSString *const ALAssetsGroupPropertyURL 相冊的 url
- (CGImageRef)posterImage 返回相冊的封面法希,且該封面圖片的方向是正確的
- (void)setAssetsFilter:(ALAssetsFilter *)filter 設置相冊的篩選條件枷餐,它有以下幾個鍵:
//所有的照片
+ (ALAssetsFilter *)allPhotos;
// 所有的視頻
+ (ALAssetsFilter *)allVideos;
// 相冊里的所有資源,包括照片和視頻
+ (ALAssetsFilter *)allAssets;
- (NSInteger)numberOfAssets 相冊里面資源的數(shù)量苫亦,這個資源數(shù)量和剛才設置的過濾器有關
//遍歷相冊里面的所有資源毛肋,得到的是ALAsset對象
- (void)enumerateAssetsUsingBlock:(ALAssetsGroupEnumerationResultsBlock)enumerationBlock
代碼實用范例:
[_group enumerateAssetsUsingBlock:^(ALAsset *result, NSUInteger index, BOOL *stop) {
if (result) {
[imageArray addObject:result];
NSLog(@"%@",result);
iv.image=[UIImage imageWithCGImage: result.thumbnail];
NSString *type=[result valueForProperty:ALAssetPropertyType];
}
}];
//該方法為同步執(zhí)行的方法,需要遍歷完才能返回屋剑,所以一般需要放在后臺線程
ALAsset的方法及屬性
- (id)valueForProperty:(NSString *)property 獲取照片相關的各種屬性润匙,這些屬性的鍵為
ALAssetPropertyType 資源的類型(照片,視頻)
ALAssetPropertyLocation 資源地理位置(無位置信息返回null)
ALAssetPropertyDuation 播放時長(照片返回ALErorInvalidProperty)
ALAssetPropertyOrientation 方向(共有8個方向唉匾,參見:ALAssetOrientation)
ALAssetPropertyDate 拍攝時間(包含了年與日時分秒)
ALAssetPropertyRepresentations 描述(打印看了下孕讳,只有帶后綴的名稱)
ALAssetPropertyURLs(返回一個字典匠楚,鍵值分別是文件名和文件的url)
ALAssetPropertyAssetURL (文件的url )
- (CGImageRef)thumbnail 照片縮略圖(這個方法獲得的是質量不高的縮略圖,它是從圖片中間進行正方形的裁剪厂财,沒有按比例縮放)
- (CGImageRef)aspectRatioThumbnail 獲得照片的縮略圖芋簿,相比于上一個方法,它是進行比例縮放的
保存圖片到相冊:
- (void)writeModifiedImageDataToSavedPhotosAlbum:(NSData *)imageData metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
保存圖片到相冊:
imageData:要保存的圖片流,
metadata:保存圖片的元數(shù)據(jù),一般為 nil,如果和前面的 imageData 沖突的話,會覆蓋掉前面的信息,
completionBlock:保存完的 block 回調,定義為:typedef void (^ALAssetsLibraryWriteImageCompletionBlock)(NSURL *assetURL, NSError *error),
assetUrl: 保存成功后映射該相片的 url
error: 保存失敗信息.
- (ALAssetRepresentation *)defaultRepresentation 獲取該圖片的詳細信息返回的是ALAssetRepresentation對象
ALAssetRepresentation方法及屬性
- (NSString *)UTI 圖片資源UTI 唯一標識符
- (CGSize)dimensions 獲取圖片的長寬
- (long long)size 圖片資源容量大小
- (CGImageRef)fullResolutionImage 圖片資源的高清圖
- (CGImageRef)fullScreenImage 圖片資源全屏圖高氮,相比于上一個方法躬它,使用它得到的圖片足夠
- (NSURL *)url 資源圖片url地址画切,該地址和ALAsset通過ALAssetPropertyAssetURL獲取的url地址是一樣的
- (NSDictionary *)metadata 資源圖片數(shù)據(jù)
- (ALAssetOrientation)orientation 資源圖片旋轉方向
- (float)scale 資源圖片縮放倍數(shù)
- (NSString *)filename 資源圖片的名字
注意:在用ALAssetsLibrary遍歷照片時,group的篩選條件一定要在遍歷方法成功的block里面設定撩穿,不然有些應用自定義創(chuàng)建的照片文件夾掃描不出來