HEPhotoPicker 0.0.8

HEPhotoPicker 0.0.8

heyode 维护。




  • heyode

HEPhotoPicker

Version License Platform
image

功能

  • 支持选择视频和图片(可以自定义)
  • 支持预览大图
  • 支持累加选择
  • 可切换相册
  • 可设置视频和图片最大选择数量
  • 支持图片单选
  • 可定制为微博相册选择器

系统要求

  • iOS 9.0
  • Xcode 10
  • Swift 4.2

安装

使用 CocoaPods 安装,请将以下内容添加到您的 Podfile 中:

pod 'HEPhotoPicker'

在终端运行 pod installpod update

使用

在使用前,请确保在使用项目的 info.plist 文件中添加隐私描述 "Privacy - Photo Library Usage Description"。

导入HEPhotoPicker

import HEPhotoPicker

实现代理

实现 HEPhotoPickerViewControllerDelegate 代理回调方法,处理选中的图片视频数据

func pickerController(_ picker: UIViewController, didFinishPicking selectedImages: [UIImage], selectedModel: [HEPhotoAsset]) 

弹出相册选择器,使用默认配置

// 创建选择器
let picker = HEPhotoPickerViewController.init(delegate: self)
// 弹出
hePresentPhotoPickerController(picker: picker, animated: true)

类似微博的相册选择器

// 配置项
let option = HEPickerOptions.init()
// 只能选择一个视频
option.singleVideo = true
// 图片和视频只能选择一种
option.mediaType = .imageOrVideo
// 将上次选择的数据传入,表示支持多次累加选择,
option.defaultSelections = self.selectedModel
// 选择图片的最大个数
option.maxCountOfImage = 9
// 创建选择器
let picker = HEPhotoPickerViewController.init(delegate: self, options: option)
// 弹出
hePresentPhotoPickerController(picker: picker, animated: true)

image

多选图片

// 配置项
let option = HEPickerOptions.init()
// 图片和视频只能选择一种
option.mediaType = .image
// 创建选择器
let picker = HEPhotoPickerViewController.init(delegate: self, options: option)
// 弹出
hePresentPhotoPickerController(picker: picker, animated: true)

image

单选图片

// 配置项
let option = HEPickerOptions.init()
// 只能选择一个图片
option.singleImage = true
// 图片和视频只能选择一种
option.mediaType = .image
// 创建选择器
let picker = HEPhotoPickerViewController.init(delegate: self, options: option)
// 弹出
hePresentPhotoPickerController(picker: picker, animated: true)

image

自定义配置对象HEPickerOptions支持的属性

  /// 要挑选的数据类型
  public var mediaType : HEMediaType = .imageAndVideo
  /// 列表是否按创建时间升序排列
  public var ascendingOfCreationDateSort : Bool = false
  /// 挑选图片的最大个数
  public var maxCountOfImage = 9
  /// 挑选视频的最大个数
  public var maxCountOfVideo = 2
  /// 是否支持图片单选,默认是false,如果是ture只允许选择一张图片(如果 mediaType = imageAndVideo 或者 imageOrVideo 此属性无效)
  public var singlePicture = false
  /// 是否支持视频单选 默认是false,如果是ture只允许选择一个视频(如果 mediaType = imageAndVideo 此属性无效)
  public var singleVideo = false
  ///  实现多次累加选择时,需要传入的选中的模型。为空时表示不需要多次累加
  public var defaultSelections : [HEPhotoAsset]?

许可证

HEPhotoPicker 使用 MIT 许可证,详情见 LICENSE 文件。