该框架在图片app中用来管理图片和音视频文件，用来一部查找和缓存资源或者缩略图、修复内容和在不同设备间同步图片等资源。
先简单的了解一些概念：
- PHAsset:单个资源
- PHAssetCollection：PHCollection的子类，单个资源的集合，如相册、时刻等
- PHCollectionList：PHCollection的子类，集合的集合，如相册文件夹
- PHPhotoLibrary：类似于总管理，负责注册通知、检查和请求获取权限
- PHImageManager：按照要求获取制定的图片
- PHCachingImageManager：PHImageManager的子类
- PHAssetChangeRequest：编辑相册，增删改查
下面一一做尽可能详尽的说明
*PHCollection
在进行下面的实验之前，先简单的说说该类中的一个方法：
+ (PHFetchResult<PHCollection *> *)fetchTopLevelUserCollectionsWithOptions:(nullable PHFetchOptions *)options;
该方法用来获取处于图片app中根目录下的自己创建的相册（貌似自己创建的本身就在根目录下）
1、PHAssetCollection
一个该实例对象代表一个相册。是PHCollection的子类。
它的所有属性都是只读的，另外有8个类方法，用来获取想要的结果。
-
+ (PHFetchResult<PHAssetCollection *> *)fetchAssetCollectionsWithType:(PHAssetCollectionType)type subtype:(PHAssetCollectionSubtype)subtype options:(nullable PHFetchOptions *)options;
该方法是该类的主要访问方法，主要用于在未知相册的情况下，直接通过type和subtype从相册获取相应的相册。type和subtype如下所示：
typedef NS_ENUM(NSInteger, PHAssetCollectionType) {
PHAssetCollectionTypeAlbum = 1, 相册，系统外的
PHAssetCollectionTypeSmartAlbum = 2, 智能相册，系统自己分配和归纳的
PHAssetCollectionTypeMoment = 3, 时刻，系统自动通过时间和地点生成的分组
} PHOTOS_ENUM_AVAILABLE_IOS_TVOS(8_0, 10_0);
*
* typedef NS_ENUM(NSInteger, PHAssetCollectionSubtype) {
// PHAssetCollectionTypeAlbum regular subtypes
PHAssetCollectionSubtypeAlbumRegular = 2, // 在iPhone中自己创建的相册
PHAssetCollectionSubtypeAlbumSyncedEvent = 3, // 从iPhoto（就是现在的图片app）中导入图片到设备
PHAssetCollectionSubtypeAlbumSyncedFaces = 4, // 从图片app中导入的人物照片
PHAssetCollectionSubtypeAlbumSyncedAlbum = 5, // 从图片app导入的相册
PHAssetCollectionSubtypeAlbumImported = 6, // 从其他的相机或者存储设备导入的相册
// PHAssetCollectionTypeAlbum shared subtypes
PHAssetCollectionSubtypeAlbumMyPhotoStream = 100, // 照片流，照片流和iCloud有关，如果在设置里关闭了iCloud开关，就获取不到了
PHAssetCollectionSubtypeAlbumCloudShared = 101, // iCloud的共享相册，点击照片上的共享tab创建后就能拿到了，但是前提是你要在设置中打开iCloud的共享开关（打开后才能看见共享tab）
// PHAssetCollectionTypeSmartAlbum subtypes
PHAssetCollectionSubtypeSmartAlbumGeneric = 200,
PHAssetCollectionSubtypeSmartAlbumPanoramas = 201, // 全景图、全景照片
PHAssetCollectionSubtypeSmartAlbumVideos = 202, // 视频
PHAssetCollectionSubtypeSmartAlbumFavorites = 203, // 标记为喜欢、收藏
PHAssetCollectionSubtypeSmartAlbumTimelapses = 204, // 延时拍摄、定时拍摄
PHAssetCollectionSubtypeSmartAlbumAllHidden = 205, // 隐藏的
PHAssetCollectionSubtypeSmartAlbumRecentlyAdded = 206, // 最近添加的、近期添加
PHAssetCollectionSubtypeSmartAlbumBursts = 207, // 连拍
PHAssetCollectionSubtypeSmartAlbumSlomoVideos = 208, // Slow Motion,高速摄影慢动作（概念不懂）
PHAssetCollectionSubtypeSmartAlbumUserLibrary = 209, // 相机胶卷
PHAssetCollectionSubtypeSmartAlbumSelfPortraits PHOTOS_AVAILABLE_IOS_TVOS(9_0, 10_0) = 210, // 使用前置摄像头拍摄的作品
PHAssetCollectionSubtypeSmartAlbumScreenshots PHOTOS_AVAILABLE_IOS_TVOS(9_0, 10_0) = 211, // 屏幕截图
PHAssetCollectionSubtypeSmartAlbumDepthEffect PHOTOS_AVAILABLE_IOS_TVOS(10_2, 10_1) = 212, // 在可兼容的设备上使用景深摄像模式拍的照片（概念不懂）
PHAssetCollectionSubtypeSmartAlbumLivePhotos PHOTOS_AVAILABLE_IOS_TVOS(10_3, 10_2) = 213, // Live Photo资源
PHAssetCollectionSubtypeSmartAlbumAnimated PHOTOS_AVAILABLE_IOS_TVOS(11_0, 11_0) = 214, // 没有解释
PHAssetCollectionSubtypeSmartAlbumLongExposures PHOTOS_AVAILABLE_IOS_TVOS(11_0, 11_0) = 215, // 没有解释
// Used for fetching, if you don't care about the exact subtype
PHAssetCollectionSubtypeAny = NSIntegerMax
} PHOTOS_ENUM_AVAILABLE_IOS_TVOS(8_0, 10_0);
-
+ (PHFetchResult<PHAssetCollection *> *)fetchAssetCollectionsWithLocalIdentifiers:(NSArray<NSString *> *)identifiers options:(nullable PHFetchOptions *)options;
通过identifier的数组来查找到相应的资源，不过这里的identifier应使用上面的方法获取到相册后拿到的相册的identifier（根据属性localIdentifier即可获取到），否则会得到意想不到的结果。测试代码如下：
- (IBAction)fetchCollectionWithIdentifier:(id)sender {
// 先试试用图片的identifier
NSMutableArray * assetIdentifierArr = [NSMutableArray array];
NSMutableArray * identifierArr = [NSMutableArray array];
PHFetchResult<PHAssetCollection *> * result = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum subtype:PHAssetCollectionSubtypeAlbumRegular options:nil];
[result enumerateObjectsUsingBlock:^(PHAssetCollection * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
if (obj.localIdentifier.length > 0) {
NSLog(@"%@--%@", obj.localIdentifier, obj.localizedTitle);
[identifierArr addObject:obj.localIdentifier];
PHFetchResult<PHAsset *> * assetResult = [PHAsset fetchAssetsInAssetCollection:obj options:nil];
PHAsset * asset = assetResult.firstObject;
[assetIdentifierArr addObject:asset.localIdentifier];
}
}];
// 注意：这里使用的是单个资源的identifier
PHFetchResult<PHAssetCollection *> * assetIdentifierResult = [PHAssetCollection fetchAssetCollectionsWithLocalIdentifiers:assetIdentifierArr options:nil];
[assetIdentifierResult enumerateObjectsUsingBlock:^(PHAssetCollection * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
if (obj.localIdentifier.length > 0) {
NSLog(@"%@", obj);
}
}];
NSLog(@"================================");
// 注意：这里使用的是相册的identifier
PHFetchResult<PHAssetCollection *> * identifierResult = [PHAssetCollection fetchAssetCollectionsWithLocalIdentifiers:identifierArr options:nil];
[identifierResult enumerateObjectsUsingBlock:^(PHAssetCollection * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
if (obj.localIdentifier.length > 0) {
NSLog(@"%@", obj);
}
}];
}
image.png
上面的使用也再一次的证明了identifier一定要使用代码获取到的才行。
-
+ (PHFetchResult<PHAssetCollection *> *)fetchAssetCollectionsContainingAsset:(PHAsset *)asset withType:(PHAssetCollectionType)type options:(nullable PHFetchOptions *)options;
查找包含资源asset的相册 -
+ (PHFetchResult<PHAssetCollection *> *)fetchAssetCollectionsWithALAssetGroupURLs:(NSArray<NSURL *> *)assetGroupURLs options:(nullable PHFetchOptions *)options;
旧版的图片框架和新版框架的交互，不过到了今天，已经基本上不用考虑该方法的调用了。 + (PHFetchResult<PHAssetCollection *> *)fetchMomentsInMomentList:(PHCollectionList *)momentList options:(nullable PHFetchOptions *)options;-
+ (PHFetchResult<PHAssetCollection *> *)fetchMomentsWithOptions:(nullable PHFetchOptions *)options;
上面的两个方法是获取Moment相册的简单方法 + (PHAssetCollection *)transientAssetCollectionWithAssets:(NSArray<PHAsset *> *)assets title:(nullable NSString *)title;-
+ (PHAssetCollection *)transientAssetCollectionWithAssetFetchResult:(PHFetchResult<PHAsset *> *)fetchResult title:(nullable NSString *)title;
利用已知资源创建一个新的集合或者说相册，但是该相册不会被永久存储下来。具体的使用后面再说吧。
2、PHCollectionList
该类用来表示集合的集合。但是我并没有发现怎么创建出该现象。而如果不创建（假如可以创建但是没创建）时，在实际的调用中，得到的结果和预想的也不一样，有些困惑，所以，这一节暂时先放放吧。
3、PHAsset
该类表示具体的资源信息，如宽度、高度、时长、是否是收藏的等等。同上面提到的几个类一样，该类的属性也都是只读的，所以我们主要是用它的方法来获取资源。
-
- (BOOL)canPerformEditOperation:(PHAssetEditOperation)editOperation;
用来判断该资源是否可以做某些操作，比如增删改查。也从另一个方面暗示了，在对该资源做一些操作之前有必要先做一下判断，这可以省去一些不必要的麻烦。 -
+ (PHFetchResult<PHAsset *> *)fetchAssetsInAssetCollection:(PHAssetCollection *)assetCollection options:(nullable PHFetchOptions *)options;
该方法是从相册中获取单个资源的主要途径：
- (IBAction)useToFetchCollection:(id)sender {
// 先获取到集合
PHFetchResult<PHAssetCollection *> * collectionResult = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeSmartAlbum subtype:PHAssetCollectionSubtypeSmartAlbumFavorites options:nil];
if (collectionResult.count == 0) {
return;
}
// 遍历集合，获取信息
[collectionResult enumerateObjectsUsingBlock:^(PHAssetCollection * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
PHFetchResult<PHAsset *> * assetResult = [PHAsset fetchAssetsInAssetCollection:obj options:nil];
NSLog(@"%@", assetResult);
}];
}
-
+ (PHFetchResult<PHAsset *> *)fetchAssetsWithLocalIdentifiers:(NSArray<NSString *> *)identifiers options:(nullable PHFetchOptions *)options;
该方法的使用和PHAssetCollection的相同，是个查找功能；如果identifier是隐藏的资源，默认是会被找到的，如果不想找到隐藏的，可以通过options的属性includeHiddenAssets来设置(貌似没什么用)。 -
+ (PHFetchResult<PHAsset *> *)fetchAssetsWithBurstIdentifier:(NSString *)burstIdentifier options:(nullable PHFetchOptions *)options;
根据identifier获取连拍资源，如果传递的identifier不是连拍资源的identifier，即使相册里有匹配的资源，也不会返回。不过苹果官方说明：默认只会获取一些具有代表性的，如果想获取全部的连拍资源，需要在options里做处理。 -
+ (PHFetchResult<PHAsset *> *)fetchAssetsWithOptions:(nullable PHFetchOptions *)options;
在相机胶卷中根据options来获取合适的资源 -
+ (PHFetchResult<PHAsset *> *)fetchAssetsWithMediaType:(PHAssetMediaType)mediaType options:(nullable PHFetchOptions *)options;
在相机胶卷中根据mediaType媒体类型和options获取匹配的资源 -
+ (nullable PHFetchResult<PHAsset *> *)fetchKeyAssetsInAssetCollection:(PHAssetCollection *)assetCollection options:(nullable PHFetchOptions *)options;
获取相册资源的封面图，根据相册类型的不同，返回的资源封面的个数也不同。
如果是零时的相册，是没有封面的。
