iOS8 Photos Framework 自己学习用自己看

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;
            }
        });
    }];