Skip to content

Latest commit

 

History

History
175 lines (139 loc) · 8.43 KB

README_CN.md

File metadata and controls

175 lines (139 loc) · 8.43 KB
Raw

Version Carthage compatible SPM supported License Platform Language Usage

image

English | 简体中文

ZLPhotoBrowser是一款微信样式的图片选择器，支持预览/相册内拍照及录视频、拖拽/滑动选择，编辑图片/视频，支持多语言国际化等功能。

重要说明

  • 框架自 4.0.0 版本起，升级为纯Swift编写框架，支持最低版本由 iOS8 升级到了 iOS10
  • 添加并增强了一些实用功能（例如图片编辑、预览界面下方小视图显示及拖拽排序等等） 具体使用请下载demo查看

Swift 版本兼容 oc app调用； 如需使用之前的oc版本（oc版本不再维护），请点这里

目录

Swift及OC详细使用方法请查看Wiki

如果你仅想使用图片编辑功能，请移步ZLImageEditor

功能介绍

你想要的应有尽有，部分功能如下，更多功能请查看 ZLPhotoConfiguration 中的参数定义（没有的话欢迎提 issue ，功能建议好的话会采纳并着手开发）

  • 支持横竖屏
  • 自选框架样式
  • 预览快速选择（支持拖拽选择，效果参照QQ）
  • 相册内部选择（支持滑动选择）
  • 图片/Gif/LivePhoto/Video 混合选择
  • 自定义最大预览数/选择数/视频最大最小可选时长，控制可否选择原图
  • 自定义每行显示列数
  • 图片编辑（涂鸦/裁剪/图片贴纸/文字贴纸/马赛克/滤镜/色值调整(亮度、对比度和饱和度)）（图片编辑可编辑多张；涂鸦/文字颜色可自定义；裁剪比例可自定义；滤镜效果可自定义；编辑工具可根据需要自行选择）
  • 视频编辑（自定义最大裁剪时长）（效果参照微信视频编辑；支持编辑本地视频）
  • 自定义相机（效果参照微信拍照，点击拍照、长按拍摄；上滑调整焦距；可设置最大/最小录制时间及视频分辨率；可设置闪光灯模式及视频导出格式；可根据自己需要控制是否使用自定义相机）
  • 多语言国际化支持（中文简/繁，英文，日文，开发者可选根据系统或自己指定，多语言文案可自定义）
  • 已选择照片index
  • 已选/不可选 状态下mask阴影遮罩
  • 大图界面下方显示已选择照片，可拖拽排序（可根据自己需要控制是否显示）
  • 大图界面下拉返回
  • 相机内部拍照cell实时显示相机俘获画面
  • 可自定义框架字体
  • 框架各个部位颜色均可自定义（传入dynamic color即可支持 light/dark mode）
  • 框架内图片资源可自定义

如果你在使用中有好的需求及建议，或者遇到什么bug，欢迎随时issue，我会及时的回复

框架支持

  • iOS 10.0
  • Swift 5.x
  • Xcode 12.x

使用示例

  • 快速选择
let ps = ZLPhotoPreviewSheet()
ps.selectImageBlock = { [weak self] results, isOriginal in
    // your code
}
ps.showPreview(animate: true, sender: self)
  • 直接进入相册选择
let ps = ZLPhotoPreviewSheet()
ps.selectImageBlock = { [weak self] results, isOriginal in
    // your code
}
ps.showPhotoLibrary(sender: self)
  • 需要注意的地方，你需要在你app的 Info.plist 中添加如下键值对
// 如果不添加该键值对，则不支持多语言，相册名称默认为英文
Localized resources can be mixed YES
//或者右键plist文件Open As->Source Code 添加
CFBundleAllowMixedLocalizations

// 相册使用权限描述
Privacy - Photo Library Usage Description
// 相机使用权限描述
Privacy - Camera Usage Description
// 麦克风使用权限描述
Privacy - Microphone Usage Description

更新日志

更多更新日志

● 4.5.7
  Add:
    自定义相机支持点击后保持录像模式。
    自定义相机在iOS13以上系统支持广角摄像头。
    自定义相机支持添加自定义遮罩层。
    视频编辑控制器添加取消编辑的回调block。
    新增ZLImagePreviewControllerDelegate协议，接收ZLImagePreviewController中的事件回调。
● 4.5.6
  Add:
    支持iOS18。
    保存图片和视频的回调里添加error参数。
● 4.5.5
  Add:
    ZLImagePreviewController界面支持下拉返回手势。
    更新获取相册权限的API。
  Fix:
    修复马赛克在涂抹过程中不显示的bug。
...

国际化语言

🇨🇳 中文简/繁, 🇺🇸 英语, 🇯🇵 日语, 🇫🇷 法语, 🇩🇪 德语, 🇷🇺 俄语, 🇻🇳 越南语, 🇰🇷 韩语, 🇲🇾 马来语, 🇮🇹 意大利语, 🇮🇩 印度尼西亚语, 🇪🇸 西班牙语, 🇵🇹 葡萄牙语, 🇹🇷 土耳其语, 🇸🇦 阿拉伯语.

安装方法

  • Manually

    • 1.直接把Sources文件夹拖入到你的工程中

  • Cocoapods

    • 1.在Podfile 中添加 pod 'ZLPhotoBrowser'
    • 2.执行 pod install

    如找不到最新版本，可首先执行pod repo update

  • Carthage

    • 1.在Cartfile 中添加 github "longitachi/ZLPhotoBrowser" ~> 4.0.0
    • 2.执行 $ carthage update

    如果执行时遇到Building universal frameworks with common architectures is not possible. The device and simulator slices for "ZLPhotoBrowser" both build for: arm64 Rebuild with --use-xcframeworks to create an xcframework bundle instead.这个错误，点击这里

  • Swift Package Manager (该方式集成暂时有问题，图片及多语言资源无法读取，请暂时先用其他方式)

      1. 选择 File > Swift Packages > Add Package Dependency，输入 https://github.com/longitachi/ZLPhotoBrowser.git
      1. 输入对应版本号（SPM 最低版本为 4.0.9）
      1. 等Xcode下载完成后确定即可

支持

效果图

  • 选择 image image image

  • 编辑图片

image

  • 编辑视频

image

  • 多语言

image

  • 自定义相机介绍

image