Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/heyode/hephotopicker
自由定制支持视频，图片的相册选择器
https://github.com/heyode/hephotopicker
image ios photopikcer photos picker swift swift4
Last synced: about 1 month ago
JSON representation
自由定制支持视频，图片的相册选择器
- Host: GitHub
- URL: https://github.com/heyode/hephotopicker
- Owner: heyode
- License: mit
- Created: 2018-10-16T09:22:18.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-04-09T01:55:44.000Z (over 4 years ago)
- Last Synced: 2024-09-29T22:03:50.931Z (about 2 months ago)
- Topics: image, ios, photopikcer, photos, picker, swift, swift4
- Language: Swift
- Homepage:
- Size: 10.3 MB
- Stars: 165
- Watchers: 9
- Forks: 32
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HEPhotoPicker
[](https://cocoapods.org/pods/HEPhotoPicker)
[](https://cocoapods.org/pods/HEPhotoPicker)
[](https://cocoapods.org/pods/HEPhotoPicker)
## 功能
- [x] 支持选择视频和图片（可自定义）
- [x] 支持预览大图
- [x] 支持累加选择
- [x] 可切换相册
- [x] 可设置视频和图片最大选择个数
- [x] 支持图片单选
- [x] 可定制为微博相册选择器
## 系统要求
- iOS 9.0
- Xcode 10
- Swift 4.2
## 安装
使用CocoaPods安装，添加以下内容至你的Podfile
```
pod 'HEPhotoPicker'
```
在终端运行`pod install`或`pod update`
## 使用
使用前需要在使用项目的info.plist文件中加上用户授权相册的描述Privacy - Photo Library Usage Description
### 导入HEPhotoPicker
```Swift
import HEPhotoPicker
```
### 实现代理
实现`HEPhotoPickerViewControllerDelegate`代理回调方法，处理选中的图片视频数据
```Swift
func pickerController(_ picker: UIViewController, didFinishPicking selectedImages: [UIImage], selectedModel: [HEPhotoAsset])
```
### 弹出相册选择器，使用默认配置
```Swift
// 创建选择器
let picker = HEPhotoPickerViewController.init(delegate: self)
// 弹出
hePresentPhotoPickerController(picker: picker, animated: true)
```
### 类似微博的相册选择器
```Swift
// 配置项
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)
```
### 多选图片
```Swift
// 配置项
let option = HEPickerOptions.init()
// 图片和视频只能选择一种
option.mediaType = .image
// 创建选择器
let picker = HEPhotoPickerViewController.init(delegate: self, options: option)
// 弹出
hePresentPhotoPickerController(picker: picker, animated: true)
```
### 单选图片
```Swift
// 配置项
let option = HEPickerOptions.init()
// 只能选择一个图片
option.singleImage = true
// 图片和视频只能选择一种
option.mediaType = .image
// 创建选择器
let picker = HEPhotoPickerViewController.init(delegate: self, options: option)
// 弹出
hePresentPhotoPickerController(picker: picker, animated: true)
```
### 自定义配置对象HEPickerOptions支持的属性
```Swift
/// 要挑选的数据类型
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 文件。