Swift 照片/视频选择器：从基础实现到进阶优化

一、Swift照片/视频选择器的核心价值

在iOS应用开发中，照片/视频选择器是社交类、电商类、教育类应用的标配功能。通过系统原生API或第三方库实现媒体资源选择，不仅能提升用户体验，还能确保数据安全性和隐私合规性。相较于直接调用系统相册，自定义选择器可实现更精细的控制，例如：限制选择类型（仅图片/仅视频）、设置最大选择数量、过滤特定尺寸的媒体文件等。

二、基础实现：使用PHPickerConfiguration

苹果在iOS 14中推出的PHPicker是当前推荐的照片选择方案，其优势在于无需手动处理权限弹窗，且自动适配暗黑模式。以下是基础实现步骤：

1. 配置Picker属性

var config = PHPickerConfiguration(photoLibrary: .shared())
config.selectionLimit = 10 // 限制最多选择10个媒体
config.filter = .any(of: [.images, .videos]) // 支持图片和视频
config.preferredAssetRepresentationMode = .current // 优先获取原始文件

2. 创建并展示Picker

let picker = PHPickerViewController(configuration: config)
picker.delegate = self
present(picker, animated: true)

3. 处理选择结果

extension ViewController: PHPickerViewControllerDelegate {
    func picker(_ picker: PHPickerViewController, 
               didFinishPicking results: [PHPickerResult]) {
        picker.dismiss(animated: true)
        for result in results {
            result.itemProvider.loadObject(ofClass: UIImage.self) { image, error in
                guard let image = image as? UIImage else { return }
                DispatchQueue.main.async {
                    // 更新UI显示选中的图片
                }
            }
        }
    }
}

三、进阶功能实现

1. 视频选择优化

对于视频文件，需额外处理时长和格式限制：

config.filter = .videos
// 在代理方法中检查视频属性
if result.itemProvider.hasItemConformingToTypeIdentifier(UTType.movie.identifier) {
    result.itemProvider.loadFileRepresentation(forTypeIdentifier: UTType.movie.identifier) { url, error in
        let asset = AVAsset(url: url!)
        let duration = CMTimeGetSeconds(asset.duration)
        if duration > 30 { // 限制视频不超过30秒
            // 提示用户
        }
    }
}

2. 性能优化策略

• 后台线程处理：使用DispatchQueue.global().async处理媒体解码
• 内存管理：对大尺寸图片进行降采样处理

  let options = PHImageRequestOptions()
  options.deliveryMode = .highQualityFormat
  options.isSynchronous = false
  PHImageManager.default().requestImage(for: asset, 
                                      targetSize: CGSize(width: 800, height: 800), 
                                      contentMode: .aspectFill, 
                                      options: options) { image, _ in
    // 使用处理后的图片
  }

3. 自定义UI集成

通过UICollectionView实现网格布局选择器：

class MediaPickerCollectionView: UICollectionView {
    init() {
        let layout = UICollectionViewFlowLayout()
        layout.itemSize = CGSize(width: 100, height: 100)
        super.init(frame: .zero, collectionViewLayout: layout)
        register(MediaPickerCell.self, forCellWithReuseIdentifier: "cell")
    }
    // 实现数据源和代理方法
}

四、常见问题解决方案

1. 权限处理

虽然PHPicker不需要相册权限，但若需直接访问相册（如使用UIImagePickerController），需在Info.plist中添加：

<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册以选择照片</string>

2. 跨设备兼容性

• iOS 13以下设备需使用UIImagePickerController
• 检查PHPicker可用性：

  if #available(iOS 14, *) {
    // 使用PHPicker
  } else {
    // 降级方案
  }

3. 内存泄漏防范

在PHPicker代理方法中，务必在主线程更新UI，避免因异步操作导致的视图控制器释放问题：

DispatchQueue.main.async {
    self.imageView.image = processedImage
}

五、第三方库对比

库名称	优势	局限性
YPImagePicker	开源免费，支持滤镜和裁剪	最后更新于2020年
DKImagePicker	功能全面，支持自定义相机	配置复杂度较高
TZImagePicker	类似微信的选择器，中文文档完善	Objective-C实现，Swift调用需桥接

六、最佳实践建议

1. 预加载策略：对相册内容采用分页加载，避免一次性加载过多资源
2. 缓存机制：使用NSCache存储缩略图，减少重复解码
3. 错误处理：实现完善的错误回调，处理如用户取消选择、存储空间不足等情况
4. 测试覆盖：重点测试以下场景：
   • 选择10张4K图片时的内存占用
   • 连续快速选择/取消的操作响应
   • 低电量模式下的性能表现

七、未来演进方向

随着iOS 16对PHPicker的增强，开发者可关注：

• 更精细的媒体类型过滤（如Live Photo、HEIC格式）
• 与SharePlay的深度集成
• 基于机器学习的媒体内容智能分类

通过系统化实现和持续优化，Swift照片/视频选择器可成为提升应用用户体验的关键组件。建议开发者定期参考苹果官方文档（如Human Interface Guidelines中的Media Picking部分），保持实现方案与系统演进的同步。