将图片保存到系统相册中, PHPhotoLibrary的简单使用

一. 最简单的保存函数

UIImage的函数来保存图片

较为简单, 只需要一个函数一个方法就可以保存

但是不能创建相册, 保存的图片会直接保存到默认的系统相册中

  /** 该函数用于将图片保存到系统相册中
    UIImage * _Nonnull image : 要保存的图片
    id  _Nullable completionTarget : 调用completionSelector方法的对象, 一般为self
    SEL  _Nullable completionSelector : 当保存完成调用的方法, 是一个系统指定的方法
    void * _Nullable contextInfo : 上下文信息, 用于传给完成后的回调方法, 一般为nil
  */
  UIImageWriteToSavedPhotosAlbum(_image, self, @selector(image:didFinishSavingWithError:contextInfo:), nil);
  
  - (void)image:(UIImage *)image didFinishSavingWithError:(NSError *)error contextInfo:(void *)contextInfo {
      
      if (error) {
          NSLog(@"保存失败");
      } else {
          NSLog(@"保存成功");
      }
  }

注意点
1. 第三个参数一定要使用系统的回调方法, 否则这个方法会报错
2. 系统指定的image: didFinishSavingWithError: contextInfo:方法一定要实现, 否则也会出现问题

二. 使用PHPhotoLibrary来保存图片

框架的简单介绍:
1. PHPhotoLibrary类, 专门用于管理系统的相片, 相簿等功能, 他可以获取系统相册中的相片信息, 也可以将App中获取的图片/相片存到手机相册中, 以及iCloud Photos中.
2. 对于手机相册的各种操作, 几乎都是通过PHPhotoLibrary的单例对象, 在ChangeBlock中, 以ChangeRequest来执行的
  - 相片请求操作: PHAssetChangeRequest
  - 相册请求操作: PHAssetCollectionChangeRequest
  - 相册列表请求操作: PHCollectionListChangeRequest(小的暂时没试过)
3. PHObjectPlaceholder对象
  - 这个对象是用于存储图片时的占位对象
  - 如果你想保存一个图片到一个相册中, 需要先将这个占位对象添加到相册中, 当ChangeBlock调用结束之后, 会根据占位对象的标识符搜索到占位对象的所在位置, 然后在保存图片
4. PHAuthorization: 用于查看当前App的相册授权状态
  - 这个类用于获取当前你的App, 系统对其相册访问权限的授权状态
  - 通过对四种不同的授权状态的判断, 我们可以做出对应的操作
    - PHAuthorizationStatusNotDetermined : 用户还没有决定是否授权
    - PHAuthorizationStatusRestricted : 访问权限受限制, 这个很少见, 如家长模式的限制才会有
    - PHAuthorizationStatusDenied : 用户拒绝App访问相册
    - PHAuthorizationStatusAuthorized : 用户已经授权了访问
5. PHFetchResult: 检索相簿中的相册/相片
  - 这个类创建的对象, 是一个有序集合, 可以用于保存系统相簿中的相片/相册的搜索结果列表
  - 该对象的每个元素, 都有一个localizedTitle, 即搜索得到的相片/相册的名称, 可以通过这个属性来获得指定的相册/相片
  - 一般是通过遍历的方式, 然后判断localizedTitle, 取得我们想要的相片/相册

保存图片的步骤

提供给外界调用的方法, 通过传入要保存的图片, 和指定的相册名称来保存一张图片

在这个方法中, 要获取当前App的相册授权状态
如果用户授权了, 就直接调用步骤2的方法, 保存图片
如果用户没有确定是否授权, 要创建授权申请, 让用户选择

如果用户已经拒绝了授权, 要显示一个指示框, 让用户去打开授权

  + (void)saveImage:(UIImage *)image assetCollectionName:(NSString *)collectionName {
      
      // 1. 获取当前App的相册授权状态
      PHAuthorizationStatus authorizationStatus = [PHPhotoLibrary authorizationStatus];
      
      // 2. 判断授权状态
      if (authorizationStatus == PHAuthorizationStatusAuthorized) {
          
          // 2.1 如果已经授权, 保存图片(调用步骤2的方法)
          [self saveImage:image toCollectionWithName:collectionName];
          
      } else if (authorizationStatus == PHAuthorizationStatusNotDetermined) { // 如果没决定, 弹出指示框, 让用户选择
          
          [PHPhotoLibrary requestAuthorization:^(PHAuthorizationStatus status) {
              
              // 如果用户选择授权, 则保存图片
              if (status == PHAuthorizationStatusAuthorized) {
                  [self saveImage:image toCollectionWithName:collectionName];
              }
          }];
          
      } else {
          
          [SVProgressHUD showWithStatus:@"请在设置界面, 授权访问相册"];
      }
  }

用于保存图片的方法, 通过外接接口获取到的图片, 相册名称来进行保存

将一个相片保存到一个自定义的相册, 需要同时创建相片变动请求和相册变动请求
根据传入的相册名, 要判断一下当前系统是否有这个相册(这里需要步骤3的方法, 传入相册名称, 来获取相册)

在这个步骤, 需要用到的四个核心对象为PHPhotoLibrary, PHAssetCollectionChangeRequest, PHAssetChangeRequest, 以及PHObjectPlaceholder

  // 保存图片
  + (void)saveImage:(UIImage *)image toCollectionWithName:(NSString *)collectionName {
      
      // 1. 获取相片库对象
      PHPhotoLibrary *library = [PHPhotoLibrary sharedPhotoLibrary];
      
      // 2. 调用changeBlock
      [library performChanges:^{
          
          // 2.1 创建一个相册变动请求
          PHAssetCollectionChangeRequest *collectionRequest;
          
          // 2.2 取出指定名称的相册
          PHAssetCollection *assetCollection = [self getCurrentPhotoCollectionWithTitle:collectionName];
          
          // 2.3 判断相册是否存在
          if (assetCollection) { // 如果存在就使用当前的相册创建相册请求
              collectionRequest = [PHAssetCollectionChangeRequest changeRequestForAssetCollection:assetCollection];
          } else { // 如果不存在, 就创建一个新的相册请求
              collectionRequest = [PHAssetCollectionChangeRequest creationRequestForAssetCollectionWithTitle:collectionName];
          }
          
          // 2.4 根据传入的相片, 创建相片变动请求
          PHAssetChangeRequest *assetRequest = [PHAssetChangeRequest creationRequestForAssetFromImage:image];
          
          // 2.4 创建一个占位对象
          PHObjectPlaceholder *placeholder = [assetRequest placeholderForCreatedAsset];
          
          // 2.5 将占位对象添加到相册请求中
          [collectionRequest addAssets:@[placeholder]];
          
      } completionHandler:^(BOOL success, NSError * _Nullable error) {
          
          // 3. 判断是否出错, 如果报错, 声明保存不成功
          if (error) {
              [SVProgressHUD showErrorWithStatus:@"保存失败"];
          } else {
              [SVProgressHUD showSuccessWithStatus:@"保存成功"];
          }
      }];
  }

步骤三用于获取当前系统中是否有指定的相册

如果有的话, 就返回已有相册
如果没有的话, 就返回nil, 让步骤二去创建一个新的系统相册
此处需要用到的关键类为: FHFetchResult, 用于搜索相册/相片名称的集合对象

通过搜索结果的localizedTitle来找到对应的相册

  + (PHAssetCollection *)getCurrentPhotoCollectionWithTitle:(NSString *)collectionName {
      
      // 1. 创建搜索集合
      PHFetchResult *result = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum subtype:PHAssetCollectionSubtypeAlbumRegular options:nil];
      
      // 2. 遍历搜索集合并取出对应的相册
      for (PHAssetCollection *assetCollection in result) {
          
          if ([assetCollection.localizedTitle containsString:collectionName]) {
              return assetCollection;
          }
      }
      
      return nil;
  }

将图片保存到系统相册中, PHPhotoLibrary的简单使用

一. 最简单的保存函数

二. 使用PHPhotoLibrary来保存图片

推荐阅读更多精彩内容