Swift - 使用PhotoKit获取照片1(获取所有照片缩略图、原图及其信息)
作者:hangge | 2016-06-16 08:40
(本文代码已升级至Swift4)
作为替代,苹果自 iOS 8 起提供了一个更现代化的框架 PhotoKit。本文将使用 PhotoKit 来实现同之前文章一样的功能:读取并显示设备中的所有照片。
2,获取原图
通过 PHImageManager.default().requestImageData() 这个方法可以获取图片的缩略图或者原图。如果要获取原图,即不对照片大小进行修改或裁剪,那么方法里参数要进行如下设置:
3,获取缩略图
(1)与 AssetsLibrary 相比,PhotoKit 没有直接的提供缩略图方法。我们需要指定需要获取的缩略图尺寸,系统会按照你的要求来返回接近该尺寸的图像(会提供刚好大于或等于该尺寸的缩略图,没有的话则返回原图)。
(2)前面提到,PHImageManager.default().requestImageData() 既可以用来获取原图,也可以用来获取缩略图。这里我们使用 PHCachingImageManager,它是 PHImageManager 的子类,所以获取图片的方法是一样的。但这个可以用于缓存 PHAsset,这样可以快速获取照片或视频。在 UICollectionViewController 中使用比较适合。
7,详细代码
--- 首页 CollectionViewController.swift ---
--- 详情页 ImageDetailViewController.swift ---
7,图像的裁剪与传输策略
上面样例运行后会发现虽然相册中的图片只有7张,但 collectionView 页面却加载了14次:

这是由于图像管理器的优化策略,即它在将图像的高质量版本递送给你之前,先传递一个较低质量的版本过来。这样就会让页面UI更加顺畅。
(3)synchronous 属性
默认是 false,表示 requestImageData() 方法是异步操作。如果设置成 true,这个就变成同步的了。
注意:当 synchronous 设为 true 时,deliveryMode 属性就会被忽略,并被当作 .highQualityFormat 来处理。
9,源码下载:
hangge_1233.zip
我之前写过一篇文章:Swift - 使用ALAssetsLibrary获取相簿里所有图片,视频(附样例)。介绍了如何使用 AssetsLibrary 框架来读取并显示系统中的所有照片。
几年以来,相机应用和照片应用发生了显著的变化,增加了许多新特性,包括按时刻来组织照片的方式。但与此同时,AssetsLibrary 框架却没有跟上步伐。所以到了iOS 9后,AssetsLibrary 框架要被彻底废除。作为替代,苹果自 iOS 8 起提供了一个更现代化的框架 PhotoKit。本文将使用 PhotoKit 来实现同之前文章一样的功能:读取并显示设备中的所有照片。
1,Photos框架的特点
淡化了照片库中 URL 的概念,改之使用一个标志符来唯一代表一个资源。同时这个标志符还是动态变化的,也就是说即使同一个资源,每次启动应用后获取的标志符和上一次都是不一样的。
2,获取原图
通过 PHImageManager.default().requestImageData() 这个方法可以获取图片的缩略图或者原图。如果要获取原图,即不对照片大小进行修改或裁剪,那么方法里参数要进行如下设置:
targetSize 设成 PHImageManagerMaximumSize
contentMode 设成 .default (其实 targetSize 如果是 PHImageManagerMaximumSize 的话,contentMode 不管设置成什么都会视作 .default )
(1)与 AssetsLibrary 相比,PhotoKit 没有直接的提供缩略图方法。我们需要指定需要获取的缩略图尺寸,系统会按照你的要求来返回接近该尺寸的图像(会提供刚好大于或等于该尺寸的缩略图,没有的话则返回原图)。
(2)前面提到,PHImageManager.default().requestImageData() 既可以用来获取原图,也可以用来获取缩略图。这里我们使用 PHCachingImageManager,它是 PHImageManager 的子类,所以获取图片的方法是一样的。但这个可以用于缓存 PHAsset,这样可以快速获取照片或视频。在 UICollectionViewController 中使用比较适合。
4,样例说明
(1)启动程序后会获取相机胶卷中所有图片的缩略图,并在 UICollectionViewController 中显示出来。
(2)图片按照创建时间倒序排列(最近拍的照片在最上面)。
(3)点击缩略图,可以查看照片的原图以及图片的相关信息。
(2)图片按照创建时间倒序排列(最近拍的照片在最上面)。
(3)点击缩略图,可以查看照片的原图以及图片的相关信息。
5,效果图如下

6,Info.plist配置
由于苹果安全策略更新,在使用Xcode8开发时,需要在 Info.plist 配置请求照片相的关描述字段(Privacy - Photo Library Usage Description)

7,详细代码
--- 首页 CollectionViewController.swift ---
import UIKit
import Photos
class CollectionViewController: UICollectionViewController {
///取得的资源结果,用了存放的PHAsset
var assetsFetchResults:PHFetchResult<PHAsset>?
///缩略图大小
var assetGridThumbnailSize:CGSize!
/// 带缓存的图片管理对象
var imageManager:PHCachingImageManager!
override func viewWillAppear(_ animated: Bool) {
super.viewWillAppear(animated)
//根据单元格的尺寸计算我们需要的缩略图大小
let scale = UIScreen.main.scale
let cellSize = (self.collectionViewLayout as! UICollectionViewFlowLayout).itemSize
assetGridThumbnailSize = CGSize(width:cellSize.width*scale ,
height:cellSize.height*scale)
}
override func viewDidLoad() {
super.viewDidLoad()
//申请权限
PHPhotoLibrary.requestAuthorization({ (status) in
if status != .authorized {
return
}
//则获取所有资源
let allPhotosOptions = PHFetchOptions()
//按照创建时间倒序排列
allPhotosOptions.sortDescriptors = [NSSortDescriptor(key: "creationDate",
ascending: false)]
//只获取图片
allPhotosOptions.predicate = NSPredicate(format: "mediaType = %d",
PHAssetMediaType.image.rawValue)
self.assetsFetchResults = PHAsset.fetchAssets(with: PHAssetMediaType.image,
options: allPhotosOptions)
// 初始化和重置缓存
self.imageManager = PHCachingImageManager()
self.resetCachedAssets()
//collection view 重新加载数据
DispatchQueue.main.async{
self.collectionView?.reloadData()
}
})
}
//重置缓存
func resetCachedAssets(){
self.imageManager.stopCachingImagesForAllAssets()
}
// CollectionView行数
override func collectionView(_ collectionView: UICollectionView,
numberOfItemsInSection section: Int) -> Int {
return self.assetsFetchResults?.count ?? 0
}
// 获取单元格
override func collectionView(_ collectionView: UICollectionView,
cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
// storyboard里设计的单元格
let identify:String = "DesignViewCell"
// 获取设计的单元格,不需要再动态添加界面元素
let cell = (self.collectionView?.dequeueReusableCell(
withReuseIdentifier: identify, for: indexPath))! as UICollectionViewCell
if let asset = self.assetsFetchResults?[indexPath.row] {
//获取缩略图
self.imageManager.requestImage(for: asset, targetSize: assetGridThumbnailSize,
contentMode: PHImageContentMode.aspectFill,
options: nil) { (image, nfo) in
(cell.contentView.viewWithTag(1) as! UIImageView).image = image
print(image ?? "")
}
}
return cell
}
// 单元格点击响应
override func collectionView(_ collectionView: UICollectionView,
didSelectItemAt indexPath: IndexPath) {
let myAsset = self.assetsFetchResults![indexPath.row]
//这里不使用segue跳转(建议用segue跳转)
let detailViewController = UIStoryboard(name: "Main", bundle: nil)
.instantiateViewController(withIdentifier: "detail")
as! ImageDetailViewController
detailViewController.myAsset = myAsset
// navigationController跳转到detailViewController
self.navigationController!.pushViewController(detailViewController,
animated:true)
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}
import UIKit
import Photos
class ImageDetailViewController: UIViewController {
//选中的图片资源
var myAsset:PHAsset!
//用于显示图片信息
@IBOutlet weak var textView: UITextView!
//用于显示原图
@IBOutlet weak var imageView: UIImageView!
override func viewDidLoad() {
super.viewDidLoad()
//获取文件名
PHImageManager.default().requestImageData(for: myAsset, options: nil,
resultHandler: {
_, _, _, info in
self.title = (info!["PHImageFileURLKey"] as! NSURL).lastPathComponent
})
//获取图片信息
textView.text = "日期:\(myAsset.creationDate!)\n"
+ "类型:\(myAsset.mediaType.rawValue)\n"
+ "位置:\(String(describing: myAsset.location))\n"
+ "时长:\(myAsset.duration)\n"
//获取原图
PHImageManager.default().requestImage(for: myAsset,
targetSize: PHImageManagerMaximumSize , contentMode: .default,
options: nil, resultHandler: {
(image, _: [AnyHashable : Any]?) in
self.imageView.image = image
})
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
}
7,图像的裁剪与传输策略
上面样例运行后会发现虽然相册中的图片只有7张,但 collectionView 页面却加载了14次:

这是由于图像管理器的优化策略,即它在将图像的高质量版本递送给你之前,先传递一个较低质量的版本过来。这样就会让页面UI更加顺畅。
当然这些策略也是可以通过 requestImageData() 方法中的 options 参数进行设置的(类型是 PHImageRequestOptions。本文样例都是传的都是 nil,即使用默认设置。)
8,PHImageRequestOptions对象常用属性说明
(1)resizeMode 属性
可以设置为 .exact (返回图像必须和目标大小相匹配),.fast (比 .exact 效率更高,但返回图像可能和目标大小不一样,接近且稍大与目标大小) 或者 .none(默认值)。
可以设置为 .exact (返回图像必须和目标大小相匹配),.fast (比 .exact 效率更高,但返回图像可能和目标大小不一样,接近且稍大与目标大小) 或者 .none(默认值)。
比如:我们如果将其设置成 .exact,那么输出结果如下:


(2)deliveryMode 属性
前面提到的在得到高质量的图片之前,会先传输个低质量的策略就是由这个属性设置。一共有三种方式:
.opportunistic(默认值)
.fastFormat(如果你想要更快的加载速度,且可以牺牲一点图像质量,可以设成这个。)
.highQualityFormat(如果你只想要高质量的图像,并且可以接受更长的加载时间,那么就设成这个。)
比如我们将 deliveryMode 设置 .highQualityFormat,那么可以看到图片只加载了7次,之前不会再先获得低质量的图片了。
前面提到的在得到高质量的图片之前,会先传输个低质量的策略就是由这个属性设置。一共有三种方式:
.opportunistic(默认值)
.fastFormat(如果你想要更快的加载速度,且可以牺牲一点图像质量,可以设成这个。)
.highQualityFormat(如果你只想要高质量的图像,并且可以接受更长的加载时间,那么就设成这个。)
比如我们将 deliveryMode 设置 .highQualityFormat,那么可以看到图片只加载了7次,之前不会再先获得低质量的图片了。
默认是 false,表示 requestImageData() 方法是异步操作。如果设置成 true,这个就变成同步的了。
注意:当 synchronous 设为 true 时,deliveryMode 属性就会被忽略,并被当作 .highQualityFormat 来处理。
9,源码下载:
全部评论(4)
当不允许使用相册时,程序会崩溃
站长回复:多谢提醒,代码现已更新,你可以再看下。
站长代码经过测试实验证实, 如果获取缩略图的时候设置size大于400多的时候就会获取的是原图的尺寸。
根据官方文档的注释来看,如果PHImageRequestOptions中isSynchronoustimes 是false 的话 PHImageManager.defaultManager().requestImageForAsset这个方法的回调函数会被调用1次或者多次。在这种情况下,如果第一次调用返回的图像大小,不满足要求的大小,会在获得“正确”的结果之后再次调用回调函数;
所以如果想避免回调函数被调用多次的情况产生,需要将PHImageRequestOptions中的synchronous属性设置为true.
当然,也为了避免获取图片的size设置超过400而返回原图的情况产生,可以顺道设置一下PHImageRequestOptions中的resizeMode属性; resizeMode是个枚举,有一下可选值:
case None // 不重置大小
case Fast // 快速
case Exact // 精确
这三个我也没太看明白官方的注释是什么意思(期待得到指导)。
最后将设置好属性的PHImageRequestOptions赋值给PHImageManager.defaultManager().requestImageForAsset方法的options参数。
完整代码如下:
let opt = PHImageRequestOptions();
opt.synchronous = true;
opt.resizeMode = .Fast;
//获取图片尺寸,由于原图过大所以这里获取的图片尺寸最大为1080
PHImageManager.defaultManager().requestImageForAsset(newValue, targetSize: CGSize(width: 1080, height: 1080) , contentMode: .AspectFit, options: opt, resultHandler: {(image, _: [NSObject : AnyObject]?) in
print(image);
});
站长回复:你很有专研精神,要赞一个。如果你不想多次调用的话,建议是修改PHImageRequestOptions的deliveryMode属性就好了。如果将synchronous改成true,那么获取图片这个操作就会变成同步。特别是在CollectionViewController这样图片特别多的页面,你如果快速滑动滚动条,会发现界面会有卡顿现象。
关于PHImageRequestOptions里属性的说明,我在文章里也更新了,你可以看下,希望能解决你的疑问。
PHImageManager.defaultManager().requestImageForAsset回调的时候不知道为什么会回调两次,第一次获取到一张40,30的图片,然后第二次才是获取到要求的大小
站长回复:这个是图像管理器的默认传输策略(这个可以设置的),即它在将图像的高质量版本递送给你之前,先传递一个较低质量的版本过来。这样就会让页面UI更加顺畅。
双击选中代码,代码就崩了。
站长回复:你指的是双击哪里的代码。如果是网站里面代码区域的话,双击是变成编辑状态的。你如果要复制代码,不要在编辑状态下复制。