保存图片到自定义相册
<b style="color:red">
实际上，自定义相册中的图片并不是实际的图片，而是对系统【相机胶卷】这个相册中的图片进行了一个引用。所以将图片保存到自定义相册的第一步就是先保存到系统的【相机胶卷】中。
</b>
1 步骤
-
保存到系统的相册【相机胶卷】中
（1）C语言函数来保存 （2）AssetsLibrary框架--系统自带，iOS9废弃 （3）Photos框架--系统自带，iOS8即可使用，取代AssetsLibrary -
拥有自定义相册（如果没有，则创建）
AssetsLibrary Photos -
将图片添加到自定义相册中
AssetsLibrary Photos
2 Photos 框架简单介绍
2.1 重要的类
该框架有几个非常重要的类：PHAsset、PHAssetCollection 和 PHLibrary。
- PHAsset 表示一个图片或者视频文件（存储在手机的照片 APP 中的）。与具体图片有关的使用这个类
- PHAssetCollection 表示图片集合或者视频集合，其实就是指相册（包括系统相册和自定义相册）
- PHLibrary 表示整个相册库，包括整个相册和图片等
<b style="color:red">
只要与单个图片相关，使用 PHAsset。只要与相册相关，使用 PHAssetCollection
</b>
2.2 查询操作
查询操作，直接使用 PHAsset 和 PHAssetCollection 类本身的方法
//1 获取相册中的图片--传入相册图片的 ID---返回一组图片
[PHAsset fetchAssetsWithLocalIdentifiers:@[ID] options:nil];
//2 查询手机中所有的相册列表(分为系统相册和自定义相册，通过控制传入的参数来确定)---返回相册组--类似数组-forin遍历即可
[PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum subtype:PHAssetCollectionSubtypeAlbumRegular options:nil];
2.3 增删改操作（除了获取之外所有的操作）
<b style="color:red">
1 如果做查询之外的操作，比如说保存图片、创建自定义相册、向自定义相册中添加图片等，都需要使用另外两个类：PHAssetChangeRequest 和 PHAssetCollectionChangeRequest
2 这些操作必须在 [[PHPhotoLibrary sharedPhotoLibrary]performChange...]的 block 中间调用
</b>
//1 保存图片
[PHAssetChangeRequest creationRequestForAssetFromImage:self.imageView.image];
//2 创建相册
[PHAssetCollectionChangeRequest creationRequestForAssetCollectionWithTitle:@"自定义相册"];
3 将图片保存到系统相册【相机胶卷】中
3.1 C语言函数保存
点击保存按钮后的代码：
//1 把图片保存到系统相册中，结束后调用 image:didFinishSavingWithError:contextInfo:方法（回调方法）
//2 回调方法的格式有要求，可以进入头文件查看
UIImageWriteToSavedPhotosAlbum(self.imageView.image, self, @selector(image:didFinishSavingWithError:contextInfo:), nil);
实现回调方法
-(void)image:(UIImage *)image didFinishSavingWithError:(NSError *)error contextInfo:(void *)contextInfo
{
if(error)
{
NSLog(@"保存图片失败");
return;
}
NSLog(@"保存图片成功");
}
3.2 Photos 框架保存图片到系统相册
Photos 框架保存图片 --- 使用 PHAssetChangeRequest 类 方法
有两种方式;异步方式和同步方式，但是保存图片的操作性能消耗不大，所以可以直接使用同步方式
3.2.1 异步方式保存图片
//异步保存图片
-(void)asyncSaveImageWithPhotos
{
//1 必须在 block 中调用
[[PHPhotoLibrary sharedPhotoLibrary] performChanges:^{
//2 异步执行保存图片操作
[PHAssetChangeRequest creationRequestForAssetFromImage:self.imageView.image];
} completionHandler:^(BOOL success, NSError * _Nullable error) {
//3 保存结束后，回调
if (error) {
[SVProgressHUD showErrorWithStatus:@"保存失败"];
}else
[SVProgressHUD showSuccessWithStatus:@"保存成功"];
}];
}
#######3.2.2 同步方式保存图片
下面的例子是通过保存时刻的占位 id 来获取图像，其实也可以直接返回占位图片。后面的操作可以直接进使用占位图片代替图片
/**同步方式保存图片到系统的相机胶卷中---返回的是当前保存成功后相册图片对象集合*/
-(PHFetchResult<PHAsset *> *)syncSaveImageWithPhotos
{
//--1 创建 ID 这个参数可以获取到图片保存后的 asset对象
__block NSString *createdAssetID = nil;
//--2 保存图片
NSError *error = nil;
[[PHPhotoLibrary sharedPhotoLibrary] performChangesAndWait:^{
//----block 执行的时候还没有保存成功--获取占位图片的 id，通过 id 获取图片---同步
createdAssetID = [PHAssetChangeRequest creationRequestForAssetFromImage:self.imageView.image].placeholderForCreatedAsset.localIdentifier;
} error:&error];
//--3 如果失败，则返回空
if (error) {
return nil;
}
//--4 成功后，返回对象
//获取保存到系统相册成功后的 asset 对象集合，并返回
PHFetchResult<PHAsset *> *assets = [PHAsset fetchAssetsWithLocalIdentifiers:@[createdAssetID] options:nil];
return assets;
}
4 拥有自定义相册(如果没有，则创建)
下面的例子是：如果没有，则常见跟当前 APP 同名的自定义相册
实现思路：
① 获取当前的 APP 的 BundleName
② 使用PHAssetCollection的fetchAssetCollectionsWithType:subType:options方法，通过传入类型，获取所有的自定义相册列表
③ 遍历获取的自定义相册列表，与APP的名称进行比对，匹配后返回当前同名的自定义相册 PHAssetCollection对象
④ 如果没有找到，则开始创建，在PHPhotoLibrary单例对象的perfromChange方法中执行创建自定义相册操作
⑤ block中，保存待创建相册的占位标识符---其实这个时刻，相册根本没创建完成
⑥ 通过error判断是否创建成功，
⑦ 如果创建成功，通过PHAssetCollection的fetchAssetCollectionsWithLocalIdentifiers:options来获取当前创建相册对象PHAssetCollection
/**拥有与 APP 同名的自定义相册--如果没有则创建*/
-(PHAssetCollection *)getAssetCollectionWithAppNameAndCreateIfNo
{
//1 获取以 APP 的名称
NSString *title = [NSBundle mainBundle].infoDictionary[(__bridge NSString *)kCFBundleNameKey];
//2 获取与 APP 同名的自定义相册
PHFetchResult<PHAssetCollection *> *collections = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum subtype:PHAssetCollectionSubtypeAlbumRegular options:nil];
for (PHAssetCollection *collection in collections) {
//遍历
if ([collection.localizedTitle isEqualToString:title]) {
//找到了同名的自定义相册--返回
return collection;
}
}
//说明没有找到，需要创建
NSError *error = nil;
__block NSString *createID = nil; //用来获取创建好的相册
[[PHPhotoLibrary sharedPhotoLibrary] performChangesAndWait:^{
//发起了创建新相册的请求，并拿到ID，当前并没有创建成功，待创建成功后，通过 ID 来获取创建好的自定义相册
PHAssetCollectionChangeRequest *request = [PHAssetCollectionChangeRequest creationRequestForAssetCollectionWithTitle:title];
createID = request.placeholderForCreatedAssetCollection.localIdentifier;
} error:&error];
if (error) {
[SVProgressHUD showErrorWithStatus:@"创建失败"];
return nil;
}else{
[SVProgressHUD showSuccessWithStatus:@"创建成功"];
//通过 ID 获取创建完成的相册 -- 是一个数组
return [PHAssetCollection fetchAssetCollectionsWithLocalIdentifiers:@[createID] options:nil].firstObject;
}
}
5 将图片对象添加到自定义相册中
实现思路
① 使用获取的自定义相册来创建PHAssetCollection对象
② 将刚才保存到系统相册的PHAsset保存到相册中
/**将图片保存到自定义相册中*/
-(void)saveImageToCustomAblum
{
//1 将图片保存到系统的【相机胶卷】中---调用刚才的方法
PHFetchResult<PHAsset *> *assets = [self syncSaveImageWithPhotos];
if (assets == nil)
{
[SVProgressHUD showErrorWithStatus:@"保存失败"];
return;
}
//2 拥有自定义相册（与 APP 同名，如果没有则创建）--调用刚才的方法
PHAssetCollection *assetCollection = [self getAssetCollectionWithAppNameAndCreateIfNo];
if (assetCollection == nil) {
[SVProgressHUD showErrorWithStatus:@"相册创建失败"];
return;
}
//3 将刚才保存到相机胶卷的图片添加到自定义相册中 --- 保存带自定义相册--属于增的操作，需要在PHPhotoLibrary的block中进行
NSError *error = nil;
[[PHPhotoLibrary sharedPhotoLibrary] performChangesAndWait:^{
//--告诉系统，要操作哪个相册
PHAssetCollectionChangeRequest *collectionChangeRequest = [PHAssetCollectionChangeRequest changeRequestForAssetCollection:assetCollection];
//--添加图片到自定义相册--追加--就不能成为封面了
//--[collectionChangeRequest addAssets:assets];
//--插入图片到自定义相册--插入--可以成为封面
[collectionChangeRequest insertAssets:assets atIndexes:[NSIndexSet indexSetWithIndex:0]];
} error:&error];
if (error) {
[SVProgressHUD showErrorWithStatus:@"保存失败"];
return;
}
[SVProgressHUD showSuccessWithStatus:@"保存成功"];
}
6 相册的授权访问
当第一次使用APP的时候，或者第一次访问相册的时候，系统会弹出授权选择对话框询问用户。所以我们在保存图片到相册的时候，需要判断当前是否授权。
6.1 权限分类
PHAuthorizationStatusNotDetermined ,---用户之前还未决定
PHAuthorizationStatusRestricted, ---系统问题，用户没有权限决定--比如家长控制器模式
PHAuthorizationStatusDenied,---用户之前拒绝过
PHAuthorizationStatusAuthorized --用户允许
6.2 请求权限的方式
可以使用NSPhotoLibrary的类方法requestAuthorization来查看权限，或者请求权限。如果用户之前没做决定，则弹出系统对话框请求权限；如果用户做过决定，则调用该类方法的block。
/*
1 block 调用时刻---这个实在子线程中调用的
--1.1 如果用户第一次打开 APP，之前决定过权限，则弹出系统框，让用户选择权限。---选择之后才会调用 block，并把刚才选择的结果一并传入
--1.2 如果用户之前已经决定过权限，则直接调用 block，并把之前选择的结果传入
2 state 类型
PHAuthorizationStatusNotDetermined ,---用户之前还未决定，直接弹出系统对话框，这个 state 不会传给 block，会传入用户选择的结果
PHAuthorizationStatusRestricted, ---系统问题，用户没有权限决定--比如家长控制器模式
PHAuthorizationStatusDenied,---用户之前拒绝过
PHAuthorizationStatusAuthorized --用户允许，直接调用 block，传入该状态
**/
[PHPhotoLibrary requestAuthorization:^(PHAuthorizationStatus status) {
//当前的block的调用是在子线程，需要回到主线程来操作
}
6.3 例子
点击保存图片按钮后的操作---一个完整的将图片保存到自定义相册的操作
-(void)save
{
//(1) 获取当前的授权状态
PHAuthorizationStatus lastStatus = [PHPhotoLibrary authorizationStatus];
//(2) 请求授权
[PHPhotoLibrary requestAuthorization:^(PHAuthorizationStatus status) {
//回到主线程
dispatch_async(dispatch_get_main_queue(), ^{
if(status == PHAuthorizationStatusDenied) //用户拒绝（可能是之前拒绝的，有可能是刚才在系统弹框中选择的拒绝）
{
if (lastStatus == PHAuthorizationStatusNotDetermined) {
//说明，用户之前没有做决定，在弹出授权框中，选择了拒绝
[SVProgressHUD showErrorWithStatus:@"保存失败"];
return;
}
// 说明，之前用户选择拒绝过，现在又点击保存按钮，说明想要使用该功能，需要提示用户打开授权
[SVProgressHUD showInfoWithStatus:@"失败！请在系统设置中开启访问相册权限"];
}
else if(status == PHAuthorizationStatusAuthorized) //用户允许
{
//保存图片---调用上面封装的方法
[self saveImageToCustomAblum];
}
else if (status == PHAuthorizationStatusRestricted)
{
[SVProgressHUD showErrorWithStatus:@"系统原因，无法访问相册"];
}
});
}];
}