WisdomsScanKit
一：简介
推荐一个强大，好用的摄像，扫描器框架： WisdomScanKit 。
WisdomScanKit 最低支持 iOS 8.0 / Swift 4 编写，SDK处理了系统兼容性问题，并且兼容OC项目调用。
WisdomScanKit 目前支持四大功能： 一：系统相册图片选择器; 二：全屏摄像功能; 三：扫二维码功能; 四：图片浏览器功能;
二：系统相册图片选择器 功能
1:API：
MARK: - startElectSystemPhoto (UIViewController extension method)
- 跳转加载系统相册图片浏览器，并选择图片
- Parameters:
- startType: The `StartTransformType` value.
- countType: The `ElectPhotoCountType`, `once` by default.
- theme: The `ElectPhotoTheme`, `whiteLight` by default.
- delegate: The `ElectPhotoDelegate`, custom navbar item.
- photoTask: The `WisdomPhotoTask`, back images array.
- Return: The created `WisdomPhotoSelectVC`.
@discardableResult
@objc public func startElectSystemPhoto(startType: StartTransformType = .present,
countType: ElectPhotoCountType = .nine,
theme: ElectPhotoTheme = .darkDim,
delegate: ElectPhotoDelegate? = nil,
photoTask: @escaping WisdomPhotoTask ) -> WisdomPhotoSelectVC {
return WisdomPhotoSelectVC()
}
2:入参：
`StartTransformType` 支持转场动画样式: 【.push .present .alpha】
`ElectPhotoCountType` 支持图片选择的数量： 【.once .four .nine】
`ElectPhotoTheme` 支持UI的主题风格： 【.whiteLight .darkDim】
`ElectPhotoDelegate` 自定义导航栏代理： 【导航栏返回按钮，导航栏主题文字】
`WisdomPhotoTask` 图片选择完成回调
二：全屏摄像 功能
1:API：
- MARK: - startScanPhoto (UIViewController extension method)
- Parameters:
- startType: The `StartTransformType` value.
- countType: The `ElectPhotoCountType`, `once` by default.
- electTheme: The `ElectPhotoTheme`, `whiteLight` by default.
- photosTask: The `WisdomPhotoTask`, back photos array.
- Returns: The created `WisdomPhotosVC`.
@discardableResult
@objc public func startScanPhoto(startType: StartTransformType = .push,
countType: ElectPhotoCountType = .nine,
electTheme: ElectPhotoTheme = .whiteLight,
photosTask: @escaping WisdomPhotoTask) -> WisdomPhotosVC {
return WisdomPhotosVC()
}
2:入参：
`StartTransformType` 支持转场动画样式: 【.push .present .alpha】
`ElectPhotoCountType` 支持图片选择的数量： 【.once .four .nine】
`ElectPhotoTheme` 支持删选UI主题风格： 【.whiteLight .darkDim】
`WisdomPhotoTask` 图片选择完成回调
三：扫二维码功能
1:API:
- MARK: - startScanRQCode
- Parameters:
- startType: The `StartTransformType` value.
- themeType: The `WisdomRQCodeThemeType`, `green` by default.
- delegate: The `ScanRQCodeDelegate`, custom navbar item.
- answerTask: The `WisdomRQCodeFinishTask`, back code string.
- errorTask: The `WisdomRQCodeErrorTask`, Returns Bool Value, to next?.
- Returns: The created `WisdomRQCodeVC`.
@discardableResult
@objc public func startScanRQCode(startType: StartTransformType = .push,
themeType: WisdomRQCodeThemeType = .green,
delegate: ScanRQCodeDelegate? = nil,
answerTask: @escaping WisdomRQCodeFinishTask,
errorTask: @escaping WisdomRQCodeErrorTask) -> WisdomRQCodeVC {
return WisdomRQCodeVC()
}
2:入参：
`StartTransformType` 支持转场动画样式: 【.push .present .alpha】
`WisdomRQCodeThemeType` 支持扫描页面主题风格：【.green .snowy】
`ScanRQCodeDelegate` 自定义导航栏代理： 【导航栏返回按钮，导航栏主题文字，导航栏右边操作按钮】
`WisdomRQCodeFinishTask` 扫描成功回调 value: String return: [.closeScan .pauseScan .continueScan .hudFailScan]
`WisdomRQCodeErrorTask` 扫描失败回调 return: [.closeScan .pauseScan .continueScan .hudFailScan]
3: 属性设置
【1】：public var scanPaneShowCover: Bool = false
说明： 全局非扫码区域是否显示覆盖效果,可赋值，
在调用 开启扫描页面 之前调用。
【2】：public var rectOfInterestSize: CGSize = {
let size = CGSize(width: scanPaneWidth,height: scanPaneWidth)
return size
}()
说明：全局掩藏的扫描区域大小,可赋值
在调用 开启扫描页面 之前调用。
默认掩藏的扫描区域大小是： let scanPaneWidth: CGFloat = 240.0
四：酷炫图片浏览器
1:API:
- MARK: - WisdomPhotoChromeHUD
- Parameters:
- startIconIndex: show begin image index frame array. (当前展示图片在数组中的下标)
- startIconAnimatRect: show begin image animation the frame.(开始展示动画的屏幕Frame)
- iconList: show images. (图片集合)
- didScrollTask: The "WisdomDidScrollTask". (滑动回调)
- Returns: The created `WisdomPhotoChromeHUD`.
@discardableResult
@objc public class func startPhotoChrome(startIconIndex: Int=0,
startIconAnimatRect: CGRect,
iconList: [UIImage],
didScrollTask: WisdomDidScrollTask?) -> WisdomPhotoChromeHUD {
return WisdomPhotoChromeHUD()
}
2:入参：
`startIconIndex` 当前展示图片在数组中的下标
`startIconAnimatRect` 开始展示动画的屏幕Frame
`iconList` 图片集合
`WisdomDidScrollTask` 滑动回调， ((Int) -> (CGRect))： 参数 int 是当前展示图片下标，返回 CGRect：结束动画Frame
3:高效能浏览系统相册图片
-【说明：为了解决浏览系统相册图片产生的性能问题，WisdomsScanKit 有提供高效能浏览系统相册图片API】
-
@objc public class func startPhotoChrome(startIconIndex: Int=0,
startIconAnimatRect: CGRect,
fetchResult: PHFetchResult<PHAsset>,
didScrollTask: WisdomDidScrollTask?) -> WisdomPhotoChromeHUD {
return WisdomPhotoChromeHUD()
}
说明：与上面的自定义图片浏览API参数一样，只是 [UIImage] 换成了 PHFetchResult<PHAsset> 加载，PHFetchResult<PHAsset> 的数据缓存比较小。
-【WisdomsScanKit 也提供了获取相册 PHFetchResult<PHAsset> 带缓存的图片管理对象】
-
public let imageManager = PHCachingImageManager()
五：结语：
WisdomsScanKit，界面设计漂亮，开发中使用方便，性能高效，自动管理生命周期，非常推荐给大家使用！
如有问题欢迎来信讨论！