MMPhotoPicker 使用指南

MMPhotoPicker 使用指南

MMPhotoPicker 项目地址: https://gitcode.com/gh_mirrors/mm/MMPhotoPicker

1. 目录结构及介绍

MMPhotoPicker 是一个基于Photos框架的iOS图片和视频选择器，支持多选、单选、图片裁剪、选择原图、视频与图片预览，并且能够创建自定义相册以及将视频和图片保存到这些相册中。其项目结构大致如下：

• 根目录:
  • MMPhotoPickerController.swift: 主控制器，负责展示和管理选择过程。
  • MMPhotoPickerDemo: 示例工程，展示了如何集成MMPhotoPicker。
  • swift-version: 记录使用的Swift版本。
  • LICENSE: 开源许可证文件，遵循MIT协议。
  • `podspec**:-MMPhotoPicker的CocoaPods规范文件。
  • Photos.png, README.md, Screenshot.png: 项目图标、说明文件和截图。
  • 其他如MMPhotoUtil.swift等实用工具类，用于辅助功能实现。

2. 项目的启动文件介绍

主要的启动和配置发生在您的应用代码中，通过集成MMPhotoPickerController来实现。启动的核心在于实例化MMPhotoPickerController并设置必要的委托(MMPhotoPickerDelegate)。一个典型的初始化和呈现流程如下：

// 初始化照片选择控制器
let photoPicker = MMPhotoPickerController(delegate: self)
photoPicker.showEmptyAlbum = true // 是否显示空相册
photoPicker.showVideo = true // 是否允许选择视频
photoPicker.cropOption = false // 不启用裁剪
photoPicker.singleOption = false // 不限制单选
photoPicker.maxNumber = 6 // 最大选择数量
// 在导航控制器中展示
if let navigationController = UINavigationController(rootViewController: photoPicker) {
    self.present(navigationController, animated: true, completion: nil)
}

这里，你的视图控制器需要遵守MMPhotoPickerDelegate协议以处理用户的选择或取消操作。

3. 项目的配置文件介绍

Info.plist的配置

为了保证MMPhotoPicker正常工作，你需要在你的应用的Info.plist文件中添加两项重要的隐私权限声明：

• Privacy - Photo Library Usage Description: 解释为什么应用程序需要访问用户的相册。
• 如果你计划创建自定义相册并希望支持本地化的相册名称，还需要将Localized resources can be mixed设置为YES。

以上步骤确保了用户在被请求访问相册时，能看到明确的使用目的，这是iOS隐私策略的一部分。

通过上述介绍，你应该能够顺利地集成和使用MMPhotoPicker到你的iOS项目中，实现高度定制化的图片和视频选择体验。记得测试所有配置和权限，确保应用在不同场景下的表现符合预期。

MMPhotoPicker 项目地址: https://gitcode.com/gh_mirrors/mm/MMPhotoPicker