文章目錄

前言

由於在iOS8及以後蘋果將原有的操作相冊的ALAssetsLibrary framework替換爲Photos framework，所以，如果在應用中使用到的相冊需要支持iOS8以下的系統版本的話，就需要了解Photos framework以做不同的版本適配。

一、iOS8以下

1. 幾個重要的實體概念

ALAsset（iOS8及以後使用PHAsset）
一個ALAsset實例對象代表一個資源實體，比如一張圖片、一個視頻。共有三種類型：
```
ALAssetTypePhoto // 圖片
ALAssetTypeVideo // 視頻
ALAssetTypeUnknown // 未知
```

通過這個實例，你可以獲取到這個資源的創建時間、資源類型、縮略圖、二進制數據等信息。

ALAssetsGroup（iOS8及以後使用PHAssetCollection）
一個ALAssetsGroup實例對象代表一組資源的集合，也就是一個相冊，可以是系統默認存在的相冊（相機膠捲），也可以是開發者給用戶創建的自定義相冊（QQ）。
通過它，你可以獲取到這個相冊的名稱、封面縮略圖等。
ALAssetsLibrary（iOS8及以後使用PHPhotoLibrary）
一個ALAssetsLibrary實例對象對所有的相冊資源進行索引。
使用它，你可以獲取指定類型的相冊、單張圖片等對象，也可以添加新的自定義相冊或者圖片到相薄。如果你想要知道有沒有獲取到系統相薄的訪問權限，同樣需要用到它。

2. 實體相關API

ALAssetsLibrary

在iOS7及以下系統中，如果你想要獲取相冊中的資源，或者對相冊進行操作，那麼你先要創建一個ALAssetsLibrary實例對象。

獲取指定類型的相冊

 - (void)enumerateGroupsWithTypes:(ALAssetsGroupType)types usingBlock:(ALAssetsLibraryGroupsEnumerationResultsBlock)enumerationBlock failureBlock:(ALAssetsLibraryAccessFailureBlock)failureBlock

注意：
由於這裏的遍歷都是異步的操作，所以ALAssetsLibrary的實例對象需要被一個靜態變量或者成員變量引用來保證不被銷燬，回調的Block才能保證被成功調用。下面同此處。

根據一個相冊URL獲取這個相冊

 - (void)groupForURL:(NSURL *)groupURL resultBlock:(ALAssetsLibraryGroupResultBlock)resultBlock failureBlock:(ALAssetsLibraryAccessFailureBlock)failureBlock

創建一個相冊

 - (void)addAssetsGroupAlbumWithName:(NSString *)name resultBlock:(ALAssetsLibraryGroupResultBlock)resultBlock failureBlock:(ALAssetsLibraryAccessFailureBlock)failureBlock

相冊授權狀態

 + (ALAuthorizationStatus)authorizationStatus

ALAssetsGroup

iOS7及以下系統的中每個相冊都是一個ALAssetsGroup實例，你可以使用這個實例獲取這個相冊的相關信息。

獲取相冊信息

 - (id)valueForProperty:(NSString *)property

參數property包含以下類型：
ALAssetsGroupPropertyName
ALAssetsGroupPropertyType
ALAssetsGroupPropertyPersistentID
ALAssetsGroupPropertyURL

封面圖
```
 - (CGImageRef)posterImage
```
相冊包含實體（照片、視頻）的數量
```
 - (NSInteger)numberOfAssets
```

過濾規則

 - (void)setAssetsFilter:(ALAssetsFilter *)filter

注意：
參數中的filter是一個ALAssetsFilter實例，這個實例只有三種類型：

	+ (ALAssetsFilter *)allPhotos; // 所有圖片

	+ (ALAssetsFilter *)allVideos; // 所有視頻

	+ (ALAssetsFilter *)allAssets; // 所有視頻及圖片

在使用- (NSInteger)numberOfAssets獲取相冊實體數量時，會依賴該過濾規則。比如一個相薄中存在5個視頻和5張圖片，如果指定allPhotos，則numberOfAssets返回值爲5。同樣使用- (void)enumerateAssetsUsingBlock:(ALAssetsGroupEnumerationResultsBlock)enumerationBlock獲取相冊中的所有資源時，也只能獲取到指定過濾規則下的資源。

使用相應遍歷規則獲取相冊中的所有ALAsset資源

 - (void)enumerateAssetsWithOptions:(NSEnumerationOptions)options usingBlock:(ALAssetsGroupEnumerationResultsBlock)enumerationBlock

3. 使用示例

獲取所有相冊，並過濾相冊中的視頻

	+ (void)getAssetsGroupsForIos8BelowSuccess:(void (^)(NSMutableArray *))success failure:(void (^)(NSError *error))failure {
    NSMutableArray *assetsGroups = [NSMutableArray array];
    [[self library] enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
        if (group != nil) {
            [group setAssetsFilter:[ALAssetsFilter allPhotos]];
            if (group.numberOfAssets > 0) {
                [assetsGroups addObject:group];
            }
        } else {
            if (success) {
                success(assetsGroups);
            }
        }
    } failureBlock:^(NSError *error) {
        if (failure) {
            failure(error);
        }
    }];
}
+ (ALAssetsLibrary *)library {
    static ALAssetsLibrary *library;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        library = [[ALAssetsLibrary alloc] init];
    });
    return library;
}

獲取一個相冊中的所有資源

	+ (void)getTimeLineSectionModelsForIos8BelowWithGroup:(MRAlbumGroupModel *)group success:(void (^)(NSMutableArray *))success failure:(void (^)(NSError *))failure {
    NSMutableArray *sectionModels = [NSMutableArray array];
    [group.assetGroup enumerateAssetsWithOptions:NSEnumerationReverse usingBlock:^(ALAsset *result, NSUInteger index, BOOL *stop) {
        if(result) {
            [sectionModels addObject:result];
        }
    }];
    if (success != nil && sectionModels.count > 0) {
        success(sectionModels);
    }
    if (failure != nil && sectionModels.count == 0) {
        failure(nil);
    }
}

二、iOS8及以上

1. 幾個重要的實體概念

與ALAssetsLibrary framework對應的幾個實體

PHAsset
一個PHAsset實例對象與ALAsset類似，代表一個資源實體，比如一張圖片、一個視頻。與ALAsset不同之處在於，多了一種實體類型，共四種類型：
```
PHAssetMediaTypeUnknown = 0,
PHAssetMediaTypeImage   = 1,
PHAssetMediaTypeVideo   = 2,
PHAssetMediaTypeAudio   = 3,
```

同時，還多了更具體的子類型PHAssetMediaSubtype：

	PHAssetMediaSubtypeNone               = 0,
	
	// Photo subtypes
    PHAssetMediaSubtypePhotoPanorama      = (1UL << 0),
    PHAssetMediaSubtypePhotoHDR           = (1UL << 1),
    PHAssetMediaSubtypePhotoScreenshot PHOTOS_AVAILABLE_IOS_TVOS(9_0, 10_0) = (1UL << 2),
    PHAssetMediaSubtypePhotoLive PHOTOS_AVAILABLE_IOS_TVOS(9_1, 10_0) = (1UL << 3),
	
    // Video subtypes
    PHAssetMediaSubtypeVideoStreamed      = (1UL << 16),
    PHAssetMediaSubtypeVideoHighFrameRate = (1UL << 17),
    PHAssetMediaSubtypeVideoTimelapse     = (1UL << 18),

通過這個實例，除了可以獲取到這個資源的創建時間、資源類型、縮略圖、二進制數據等信息，還可以獲取到location等位置信息。

PHCollection
PHCollection是個基類，它有兩個子類。分別是PHAssetCollection和PHCollectionList，PHAssetCollection代表 Photos 中的相冊，PHCollectionList代表 Photos 中的文件夾。PHCollectionList裏可嵌套PHAssetCollection，也可以嵌套自身類型，同時支持多重嵌套。
一個PHAssetCollection實例對象與ALAssetsGroup類似，代表一組資源的集合，也就是一個相冊。
通過它，你可以獲取到這個相冊的名稱、封面縮略圖。
以及相冊類型PHAssetCollectionType：

PHAssetCollectionTypeAlbum      = 1, // 自定義相冊，如QQ
PHAssetCollectionTypeSmartAlbum = 2, // 相機膠捲、我的照片流、屏幕截圖、全景照片等
PHAssetCollectionTypeMoment     = 3, // 時刻

相冊子類型PHAssetCollectionSubtype：

// PHAssetCollectionTypeAlbum regular subtypes
PHAssetCollectionSubtypeAlbumRegular         = 2,
PHAssetCollectionSubtypeAlbumSyncedEvent     = 3,
PHAssetCollectionSubtypeAlbumSyncedFaces     = 4,
PHAssetCollectionSubtypeAlbumSyncedAlbum     = 5,
PHAssetCollectionSubtypeAlbumImported        = 6,
    
// PHAssetCollectionTypeAlbum shared subtypes
PHAssetCollectionSubtypeAlbumMyPhotoStream   = 100,
PHAssetCollectionSubtypeAlbumCloudShared     = 101,
    
// PHAssetCollectionTypeSmartAlbum subtypes
PHAssetCollectionSubtypeSmartAlbumGeneric    = 200,
PHAssetCollectionSubtypeSmartAlbumPanoramas  = 201,
PHAssetCollectionSubtypeSmartAlbumVideos     = 202,
PHAssetCollectionSubtypeSmartAlbumFavorites  = 203,
PHAssetCollectionSubtypeSmartAlbumTimelapses = 204,
PHAssetCollectionSubtypeSmartAlbumAllHidden  = 205,
PHAssetCollectionSubtypeSmartAlbumRecentlyAdded = 206,
PHAssetCollectionSubtypeSmartAlbumBursts     = 207,
PHAssetCollectionSubtypeSmartAlbumSlomoVideos = 208,
PHAssetCollectionSubtypeSmartAlbumUserLibrary = 209,
PHAssetCollectionSubtypeSmartAlbumSelfPortraits PHOTOS_AVAILABLE_IOS_TVOS(9_0, 10_0) = 210,
PHAssetCollectionSubtypeSmartAlbumScreenshots PHOTOS_AVAILABLE_IOS_TVOS(9_0, 10_0) = 211,
    
// Used for fetching, if you don't care about the exact subtype
PHAssetCollectionSubtypeAny = NSIntegerMax

PHPhotoLibrary
PHPhotoLibrary是個單例對象，與ALAssetsLibrary相比發生了較大變化，只能申請獲取PHOtos權限以及授權狀態獲取等。
使用這個單例你也可以註冊相冊改動的監聽者，在相冊發生變化（比如添加或導入了新圖片）時，做一些刷新或其他處理。

新的實體

在iOS8及以上的相冊資源獲取中，都是使用fetch相關API的形式，過程類似Core Data。匹配資源的過程自然需要匹配規則，最終匹配結果也需要一個集合來記錄。

PHFetchOptions
PHFetchOptions的實例對象代表獲取資源時的匹配規則。
可以指定資源排序規則(NSArray<NSSortDescriptor *> *sortDescriptors;)、資源類型規則（NSPredicate *predicate）、最大數量(NSUInteger fetchLimit)等。
PHFetchResult
PHFetchResult的實例對象代表相冊資源的匹配結果集合。它包含零個或多個符合匹配規則的資源，這些資源可以是PHAssetCollection對象，也可以是PHAsset對象。
PHImageManager
PHImageManager是一個單例對象，不需要你手動創建，這個單例對象可以讓你獲取到一個PHAsset資源的實際二進制數據——如一張圖片數據。

2. 實體相關API

PHAssetCollection

在iOS8及以上系統中，獲取相冊不需要創建實例，直接使用PHAssetCollection的類方法進行操作即可。

獲取指定類型的相冊

 // Fetch asset collections of a single type and subtype provided (use PHAssetCollectionSubtypeAny to match all subtypes)
 + (PHFetchResult<PHAssetCollection *> *)fetchAssetCollectionsWithType:(PHAssetCollectionType)type subtype:(PHAssetCollectionSubtype)subtype options:(nullable PHFetchOptions *)options;

基本屬性

@property (nonatomic, strong, readonly, nullable) NSString *localizedTitle; // 相冊標題
@property (nonatomic, assign, readonly) PHAssetCollectionType assetCollectionType; // 相冊類型
@property (nonatomic, assign, readonly) PHAssetCollectionSubtype assetCollectionSubtype; // 子類型
@property (nonatomic, assign, readonly) NSUInteger estimatedAssetCount; // 預估資源數量
@property (nonatomic, strong, readonly, nullable) NSDate *startDate; // 開始日期
@property (nonatomic, strong, readonly, nullable) NSDate *endDate; // 結束日期
@property (nonatomic, strong, readonly, nullable) CLLocation *approximateLocation; // 位置信息
@property (nonatomic, strong, readonly) NSArray<NSString *> *localizedLocationNames; // 位置名稱

注意：
estimatedAssetCount並不是一個準確的值，當PHAssetCollection對象不能馬上計算出當前相冊中的資源數量時，會返回NSNotFound，如果想要獲取資源的具體數量，需要使用PHAsset來fetch所有資源，計算資源數量。

PHAsset

獲取某相冊中的PHAsset資源

 + (PHFetchResult<PHAsset *> *)fetchAssetsInAssetCollection:(PHAssetCollection *)assetCollection options:(nullable PHFetchOptions *)options;

獲取某相冊的封面資源

 + (nullable PHFetchResult<PHAsset *> *)fetchKeyAssetsInAssetCollection:(PHAssetCollection *)assetCollection options:(nullable PHFetchOptions *)options;

注意：
這個API可以獲取到系統默認的一些封面圖資源，這個結果由零個或多個PHAsset組成，在相冊是smartAlbum類型的情況下，可能會有零個結果的情況。

獲取中Photos中的所有PHAsset資源

 + (PHFetchResult<PHAsset *> *)fetchAssetsWithOptions:(nullable PHFetchOptions *)options;

注意：
這裏並不是獲取某個相冊中的PHAsset資源，而是手機中所有的PHAsset資源。
比如手機中有10個相冊，每個相冊中10個PHAsset資源，如果不指定PHFetchOptions，使用該方法會獲取到所有的100個PHAsset資源。

獲取Photos中指定資源類型的所有PHAsset資源

 + (PHFetchResult<PHAsset *> *)fetchAssetsWithMediaType:(PHAssetMediaType)mediaType options:(nullable PHFetchOptions *)options;

參數中的mediaType可選：

```
PHAssetMediaTypeUnknown = 0,
PHAssetMediaTypeImage   = 1,
PHAssetMediaTypeVideo   = 2,
PHAssetMediaTypeAudio   = 3,
```

PHImageManager

獲取PHAsset圖片資源的圖片數據

 - (PHImageRequestID)requestImageForAsset:(PHAsset *)asset targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(nullable PHImageRequestOptions *)options resultHandler:(void (^)(UIImage *__nullable result, NSDictionary *__nullable info))resultHandler;

注意：
參數中的PHImageRequestOptions對象可以設置目標圖片的一些屬性，其中synchronous表示是否同步獲取，默認是NO，也就是異步獲取。

3. 使用示例

獲取指定類型的相冊

	+ (NSMutableArray *)getCollecionsWithSmartAlbumSubtype:(PHAssetCollectionSubtype)subtype {
    PHFetchOptions *userAlbumsOptions = [PHFetchOptions new];
    PHFetchResult *userAlbumsResult = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum
                                                                               subtype:PHAssetCollectionSubtypeAny
                                                                               options:userAlbumsOptions];
    PHFetchResult *userSmartAlbumsResult = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeSmartAlbum
                                                                                    subtype:subtype
                                                                                    options:userAlbumsOptions];
    NSMutableArray *collections = [NSMutableArray array];
    void (^AlbumEnumerateObjectsUsingBlock)(PHAssetCollection *, NSUInteger idx, BOOL *) = ^(PHAssetCollection * _Nonnull collection, NSUInteger idx, BOOL * _Nonnull stop) {
        if (collection.estimatedAssetCount == 0) {
            return ;
        }
        NSUInteger numberOfAssets = 0;
        PHFetchResult *assetsResult = [PHAsset fetchAssetsInAssetCollection:collection options:nil];
        numberOfAssets = [assetsResult countOfAssetsWithMediaType:PHAssetMediaTypeImage];
        if (numberOfAssets == 0) {
            return;
        }
        [collections addObject:collection];
    };
    [userSmartAlbumsResult enumerateObjectsUsingBlock:AlbumEnumerateObjectsUsingBlock];
    [userAlbumsResult enumerateObjectsUsingBlock:AlbumEnumerateObjectsUsingBlock];
    return collections;
}

獲取一個相冊中的所有圖片資源，按創建時間降序排序

	+ (void)getTimeLineSectionModelsForIos8AboveWithGroup:(MRAlbumGroupModel *)group success:(void (^)(NSMutableArray *))success failure:(void (^)(NSError *))failure {
    PHFetchResult *assetsResult = [PHAsset fetchAssetsInAssetCollection:group.collection options:[self fetchOptions]];
    NSMutableArray *sectionModels = [NSMutableArray array];
    [assetsResult enumerateObjectsUsingBlock:^(PHAsset * _Nonnull asset, NSUInteger idx, BOOL * _Nonnull stop) {
        [sectionModels addObject:asset];
    }];
    if (success != nil && sectionModels.count > 0) {
        success(sectionModels);
    }
    if (failure != nil && sectionModels.count == 0) {
        failure(nil);
    }
}
+ (PHFetchOptions *)fetchOptions {
    PHFetchOptions *fetchOptions = [PHFetchOptions new];
    fetchOptions.predicate = [NSPredicate predicateWithFormat:@"mediaType = %@", @(PHAssetMediaTypeImage)];
    fetchOptions.sortDescriptors = @[[NSSortDescriptor sortDescriptorWithKey:@"creationDate" ascending:NO]];
    return fetchOptions;
}

三、適配參考

我在不同系統的相冊適配中採用適配器的方式進行的適配，僅供參考。

1. 適配器

相冊適配主要是爲了解決在iOS8以上的系統中，使用ALLibrary相關API可能存在一些不兼容的問題，導致資源獲取不一致情況的出現。

在業務展現上並不期望因系統不同而給用戶差別較大的體驗，所以可以只針對相冊資源數據獲取的數據測適配即可，而無需改動UI。

這種場景可以在數據層對ALAssetsGroup和PHAssetCollection以及ALAsset和PHAsset做抽象，抽取適配器即可。

2. 簡單示例

AssetGroupModel

@interface AlbumGroupModel : NSObject

@property (nonatomic, strong) UIImage *posterImage;
@property (nonatomic, assign) NSUInteger numberOfAssets;
@property (nonatomic, copy) NSString *assetsGroupPropertyName;

@property (nonatomic, strong) PHAssetCollection *collection;
@property (nonatomic, strong) ALAssetsGroup *assetGroup;

@end
@implementation AlbumGroupModel

(UIImage *)posterImage {
if (_posterImage == nil) {
if ([XSLAppInfoTool systemVersion] < 8.0) {
_posterImage = [UIImage imageWithCGImage:self.assetGroup.posterImage];
} else {
PHFetchResult *groupResult = [PHAsset fetchAssetsInAssetCollection:self.collection options:self.class.fetchOptions];
PHAsset *asset = groupResult.firstObject;
PHImageRequestOptions *requestOptions = [[PHImageRequestOptions alloc] init];
requestOptions.resizeMode = PHImageRequestOptionsResizeModeExact;
```
      CGFloat scale = [UIScreen mainScreen].scale;
      CGFloat dimension = 80.0f;
      CGSize size = CGSizeMake(dimension * scale, dimension * scale);
      __block UIImage *resultImage = nil;
      [[PHImageManager defaultManager] requestImageForAsset:asset targetSize:size contentMode:PHImageContentModeAspectFill options:requestOptions resultHandler:^(UIImage *result, NSDictionary *info) {
          resultImage = result;
      }];
      _posterImage = resultImage;
  }
```
}
return _posterImage;
}
@end

AssetModel

@interface AlbumAssetModel : NSObject

@property (nonatomic, strong, nullable) PHAsset *assetPh;
@property (nonatomic, strong, nullable) ALAsset *assetAl;

- (void)thumbnail:(nullable void(^)(UIImage * _Nullable thumbnail))resultCallback;

@end
@implementation AlbumAssetModel

- (void)thumbnail:(void (^)(UIImage *))resultCallback {
    if (self.assetPh) {
        PHImageManager *manager = [PHImageManager defaultManager];
        [manager requestImageForAsset:self.assetPh targetSize:CGSizeMake(100, 100) contentMode:PHImageContentModeDefault options:nil resultHandler:^(UIImage * _Nullable result, NSDictionary * _Nullable info) {
            if (resultCallback) {
                resultCallback(result);
            }
        }];
    } else if (self.assetAl) {
        if (resultCallback) {
            resultCallback([UIImage imageWithCGImage:[self.assetAl thumbnail]]);
        }
    }
}

@end

wentianen

發佈了42 篇原創文章 · 獲贊 21 · 訪問量 20萬+

私信關注

iOS7、8、9相冊適配

文章目錄

前言

一、iOS8以下

1. 幾個重要的實體概念

2. 實體相關API

ALAssetsLibrary

ALAssetsGroup

3. 使用示例

二、iOS8及以上

1. 幾個重要的實體概念

與ALAssetsLibrary framework對應的幾個實體

新的實體

2. 實體相關API

PHAssetCollection

PHAsset

PHImageManager

3. 使用示例

三、適配參考

1. 適配器

2. 簡單示例

物理機開關機

sudo 命令直接添加密碼到腳本問題解決方案說明

Xcode9 xcodebuild export plist 配置前言一、現象二、原因三、解決步驟參考

El Capitan gem 命令由於訪問權限問題不能正常使用一、問題二、爲什麼三、解決方案參考

UIApplication openUrl too slow （十分慢 10秒）參考

iOS UICollectionView 卡片效果傳送帶效果 Carousel FlowLayout 場景實現思路實現細節封裝集成使用參考

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結