PHKIT理解.001.jpeg
PHCollection : PHObject
//能够执行什么操作 PHCollectionEditOperation是一个枚举里面各种操作
1.- (BOOL)canPerformEditOperation:(PHCollectionEditOperation)anOperation;
//获取用户自定义的相册 包括软件自己创建的相册
2.+ (PHFetchResult<PHCollection *> *)fetchTopLevelUserCollectionsWithOptions:(nullable PHFetchOptions *)options;
PHAssetCollection : PHCollection
1.PHAssetCollectionType
typedef NS_ENUM(NSInteger, PHAssetCollectionType) {
PHAssetCollectionTypeAlbum = 1,//从 iTunes 同步来的相册，以及用户在 Photos 中自己建立的相册
PHAssetCollectionTypeSmartAlbum = 2,//经由相机得来的相册
PHAssetCollectionTypeMoment = 3, //Photos 为我们自动生成的时间分组的相册
} NS_ENUM_AVAILABLE_IOS(8_0);
//根据某个id获取具体的相册 在创建相册的时候会反回一个id 反回列表
2.+ (PHFetchResult<PHAssetCollection *> *)fetchAssetCollectionsWithLocalIdentifiers:(NSArray<NSString *> *)identifiers options:(nullable PHFetchOptions *)options;
//根据枚举类型获取 相册列表
3.+ (PHFetchResult<PHAssetCollection *> *)fetchAssetCollectionsWithType:(PHAssetCollectionType)type subtype:(PHAssetCollectionSubtype)subtype options:(nullable PHFetchOptions *)options;
//根据某个资源找到包含他的相册 注意 Smart Albums are not supported, only Albums and Moments
4+ (PHFetchResult<PHAssetCollection *> *)fetchAssetCollectionsContainingAsset:(PHAsset *)asset withType:(PHAssetCollectionType)type options:(nullable PHFetchOptions *)options;
//唯一标识URL获取相册
5+ (PHFetchResult<PHAssetCollection *> *)fetchAssetCollectionsWithALAssetGroupURLs:(NSArray<NSURL *> *)assetGroupURLs options:(nullable PHFetchOptions *)options;
相同文件的下的其他方法 类似以上理解方式不做赘述
PHAsset : PHObject
//传入一个PHAssetCollection 资源集合 获取PHAsset集合 options=nil 获取全部类型资源
1.+ (PHFetchResult<PHAsset *> *)fetchAssetsInAssetCollection:(PHAssetCollection *)assetCollection options:(nullable PHFetchOptions *)options;
//根据id获取图片 在写入相册的时候会返回一个id
2.+ (PHFetchResult<PHAsset *> *)fetchAssetsWithBurstIdentifier:(NSString *)burstIdentifier options:(nullable PHFetchOptions *)options;
//获取连拍所有照片 burstIdentifier传 NSString *burstIdentifier字段
3+ (PHFetchResult<PHAsset *> *)fetchAssetsWithBurstIdentifier:(NSString *)burstIdentifier options:(nullable PHFetchOptions *)options;
representsBurst 和 burstSelectionTypes: 对于一个资源，如果其 PHAsset 的 representsBurst 属性为 true，则表示这个资源是一系列连拍照片中的代表照片 (多张照片是在用户按住快门时拍摄的)。它还有一个属性是 burstIdentifier，如果想要获取连拍照片中的剩余的其他照片。
burstSelectionTypes 属性来访问。这个属性是用三个常量组成的位掩码：.UserPick 表示用户手动标记的资源，.AutoPick 表示用户可能标记的潜在资源，.None 表示没有标记的资源。
Favorite 布尔值，用户是否标记资源为"收藏"。
hidden 要验证一个资源是否被用户标记为收被隐藏。
PHAssetChangeRequest
1> 负责执行对PHAsset的【增删改】操作
2> 这个类只能放在-[PHPhotoLibrary performChanges:completionHandler:] 或者 -[PHPhotoLibrary performChangesAndWait:error:]方法的block中使用
//保存图片到手机相册
1.+ (instancetype)creationRequestForAssetFromImage:(UIImage *)image;
//写入照片的例子
__block NSString *localIdentifier = [NSString string];
[[PHPhotoLibrary sharedPhotoLibrary] performChanges:^{
//返回了一个id
localIdentifier = [PHAssetChangeRequest creationRequestForAssetFromImage:[UIImage imageNamed:@"PHKIT"]].placeholderForCreatedAsset.localIdentifier;
} completionHandler:^(BOOL success, NSError * _Nullable error) {
NSLog(@"%ld",success);
}];
//该方法不能直接使用 须配合一下方法
//异步
2.- (void)performChanges:(dispatch_block_t)changeBlock completionHandler:(nullable void(^)(BOOL success, NSError *__nullable error))completionHandler;
//同步
3.- (BOOL)performChangesAndWait:(dispatch_block_t)changeBlock error:(NSError *__autoreleasing *)error;
PHAssetCollectionChangeRequest
1> 负责执行对PHAssetCollection的【增删改】操作
2> 这个类只能放在-[PHPhotoLibrary performChanges:completionHandler:] 或者 -[PHPhotoLibrary performChangesAndWait:error:]方法的block中使用
//创建相册
1.+ (instancetype)creationRequestForAssetCollectionWithTitle:(NSString *)title;
//例子
__block NSString *createdCollectionId = nil;
// 创建一个新的相册
[[PHPhotoLibrary sharedPhotoLibrary] performChangesAndWait:^{
createdCollectionId = [PHAssetCollectionChangeRequest creationRequestForAssetCollectionWithTitle:title].placeholderForCreatedAssetCollection.localIdentifier;
} error:nil];
鉴权
/*
requestAuthorization方法的功能
1.如果用户还没有做过选择，这个方法就会弹框让用户做出选择
1> 用户做出选择以后才会回调block
2.如果用户之前已经做过选择，这个方法就不会再弹框，直接回调block，传递现在的授权状态给block
*/
[PHPhotoLibrary requestAuthorization:^(PHAuthorizationStatus status) {
dispatch_async(dispatch_get_main_queue(), ^{
switch (status) {
case PHAuthorizationStatusAuthorized: {
// 保存图片到相册
[self saveImageIntoAlbum];
break;
}
case PHAuthorizationStatusDenied: {
if (oldStatus == PHAuthorizationStatusNotDetermined) return;
NSLog(@"提醒用户打开相册的访问开关")
break;
}
case PHAuthorizationStatusRestricted: {
[SVProgressHUD showErrorWithStatus:@"因系统原因，无法访问相册！"];
break;
}
default:
break;
}
});
}];
