HEPhotoPicker开源项目教程-优快云博客

HEPhotoPicker开源项目教程

HEPhotoPicker 自由定制支持视频，图片的相册选择器项目地址: https://gitcode.com/gh_mirrors/he/HEPhotoPicker

1. 项目介绍

HEPhotoPicker 是一个自由定制的 iOS 相册选择器，支持选择图片和视频。该项目提供了丰富的功能，包括图片和视频的选择、预览大图、累加选择、相册切换、设置选择数量限制等。它适用于 iOS 9.0 及以上版本，使用 Swift 4.2 编写，并且可以通过 CocoaPods 进行安装。HEPhotoPicker 使用 MIT 许可证，用户可以自由使用和修改。

2. 项目快速启动

首先，确保你的开发环境满足以下要求：

iOS 9.0 或更高版本
Xcode 10 或更高版本
Swift 4.2 或更高版本

通过以下步骤使用 CocoaPods 安装 HEPhotoPicker：

# 添加 HEPhotoPicker 到你的 Podfile
pod 'HEPhotoPicker'

# 在终端运行以下命令
pod install
# 或者
pod update

安装完成后，在你的项目中的 info.plist 文件中添加用户授权相册的描述：

<key>NSPhotoLibraryUsageDescription</key>
<string>我们需要您的同意来访问相册</string>

然后，在需要使用相册选择器的类中导入 HEPhotoPicker：

import HEPhotoPicker

接下来，实现 HEPhotoPickerViewControllerDelegate 代理，并处理选中的图片视频数据：

extension YourViewController: HEPhotoPickerViewControllerDelegate {
    func pickerController(_ picker: UIViewController, didFinishPicking selectedImages: [UIImage], selectedModel: [HEPhotoAsset]) {
        // 处理选中的图片和视频
    }
}

最后，弹出相册选择器：

let picker = HEPhotoPickerViewController(delegate: self)
hePresentPhotoPickerController(picker: picker, animated: true)

3. 应用案例和最佳实践

多选图片

配置选择器只允许选择图片，并设置最大选择数量：

let option = HEPickerOptions()
option.mediaType = .image
option.maxCountOfImage = 9
let picker = HEPhotoPickerViewController(delegate: self, options: option)
hePresentPhotoPickerController(picker: picker, animated: true)

单选图片

配置选择器只允许单选图片：

let option = HEPickerOptions()
option.singleImage = true
option.mediaType = .image
let picker = HEPhotoPickerViewController(delegate: self, options: option)
hePresentPhotoPickerController(picker: picker, animated: true)

选择视频

配置选择器只允许选择视频，并设置最大选择数量：

let option = HEPickerOptions()
option.mediaType = .video
option.maxCountOfVideo = 2
let picker = HEPhotoPickerViewController(delegate: self, options: option)
hePresentPhotoPickerController(picker: picker, animated: true)