143 lines
4.0 KiB
Markdown
143 lines
4.0 KiB
Markdown
|
||
# SGQRCode
|
||
|
||
| Version | UIKit | Use |
|
||
|:-----:|:-----:|:-----:|
|
||
| 3.5x | iOS 9.0+ | Block
|
||
| 4.x | iOS 11.0+ | Delegate
|
||
|
||
* QQ群：825339547
|
||
|
||
* [3.5.1版本 API 使用说明](https://github.com/kingsic/SGQRCode/wiki/3.5.1版本API说明)
|
||
|
||
|
||
## 主要功能
|
||
|
||
`生成二维码`<br>
|
||
|
||
`扫描二维码`<br>
|
||
|
||
`捕获内容缩放功能`<br>
|
||
|
||
`图片中识别二维码`<br>
|
||
|
||
`相机、相册权限判断`<br>
|
||
|
||
`根据光线强弱开启关闭手电筒`<br>
|
||
|
||
`扫描成功后界面间的逻辑跳转处理`<br>
|
||
|
||
`扫描界面可高度自定义（满足所有主流app）`<br>
|
||
|
||
|
||
## 主要类说明
|
||
| 类名 | 说明 |
|
||
|-----|-----|
|
||
| SGScanCode | 扫描二维码 |
|
||
| SGScanViewConfigure | 扫描视图配置 |
|
||
| SGScanView | 扫描视图 |
|
||
| SGPermission | 相册、相机权限管理 |
|
||
| SGTorch | 手电筒管理 |
|
||
| SGQRCodeLog | 调试日志 |
|
||
|
||
|
||
## SGQRCode 集成流程
|
||
|
||
**手动集成**
|
||
|
||
`添加 SGQRCode 文件夹到工程中`
|
||
|
||
**通过 CocoaPods 集成**
|
||
|
||
`pod 'SGQRCode', '~> 4.1.0'`
|
||
|
||
|
||
**Info.plist 添加以下字段**
|
||
|
||
`NSCameraUsageDescription (相机权限访问)`<br>
|
||
|
||
`NSPhotoLibraryUsageDescription (相册权限访问)`<br>
|
||
|
||
|
||
**引用头文件**
|
||
|
||
`#import <SGQRCode/SGQRCode.h>`
|
||
|
||
|
||
**扫描二维码相关代码**
|
||
```Objective-C
|
||
// 创建二维码扫描类
|
||
scanCode = [SGScanCode scanCode];
|
||
|
||
// 预览视图，必须设置
|
||
scanCode.preview = self.view;
|
||
|
||
// 遵循 SGScanCodeDelegate
|
||
scanCode.delegate = self;
|
||
|
||
// 遵循 SGScanCodeSampleBufferDelegate
|
||
scanCode.sampleBufferDelegate = self;
|
||
|
||
// 开启扫描
|
||
[scanCode startRunning];
|
||
|
||
// 结束扫描
|
||
[scanCode stopRunning];
|
||
```
|
||
|
||
**Delegate 方法**
|
||
```Objective-C
|
||
// SGScanCodeDelegate
|
||
- (void)scanCode:(SGScanCode *)scanCode result:(NSString *)result {
|
||
<#code#>
|
||
}
|
||
|
||
// SGScanCodeSampleBufferDelegate
|
||
- (void)scanCode:(SGScanCode *)scanCode brightness:(CGFloat)brightness {
|
||
<#code#>
|
||
}
|
||
```
|
||
|
||
**图片中识别二维码方法**
|
||
```Objective-C
|
||
[scanCode readQRCode:image completion:^(NSString *result) {
|
||
<#code#>
|
||
}];
|
||
```
|
||
|
||
**生成二维码相关方法**
|
||
```Objective-C
|
||
// 普通二维码生成方法
|
||
[SGGenerateQRCode generateQRCodeWithData:data size:size];
|
||
|
||
// 带 logo 的二维码生成方法
|
||
[SGGenerateQRCode generateQRCodeWithData:data size:size logoImage:logoImage ratio:ratio];
|
||
```
|
||
|
||
|
||
## 效果图
|
||
|
||
<img src="https://github.com/kingsic/SGQRCode/raw/master/Pictures/sgqrcode_1.png" width="40%" height="40%"> <img src="https://github.com/kingsic/SGQRCode/raw/master/Pictures/sgqrcode_2.png" width="40%" height="40%">
|
||
<img src="https://github.com/kingsic/SGQRCode/raw/master/Pictures/sgqrcode_3.png" width="40%" height="40%"> <img src="https://github.com/kingsic/SGQRCode/raw/master/Pictures/sgqrcode_4.png" width="40%" height="40%">
|
||
<img src="https://github.com/kingsic/SGQRCode/raw/master/Pictures/sgqrcode_5.png" width="40%" height="40%"> <img src="https://github.com/kingsic/SGQRCode/raw/master/Pictures/sgqrcode_6.png" width="40%" height="40%">
|
||
|
||
|
||
## 问题及解决方案
|
||
|
||
* 若在使用 CocoaPods 安装第三方时，出现 [!] Unable to find a specification for SGQRCode 提示时，打开终端先输入 pod repo remove master；执行完毕后再输入 pod setup 即可 (可能会等待一段时间)
|
||
|
||
* CIDetector 类只能识别图片中的二维码，目前暂不支持识别图片中的条形码 [解决方案](https://juejin.cn/post/6844903910428114952l)
|
||
|
||
|
||
## 更新说明
|
||
|
||
* 2021-07-05 ：v3.5.1 版本重构：修复 [#163](https://github.com/kingsic/SGQRCode/issues/163) 问题，更多内容请在 [releases](https://github.com/kingsic/SGQRCode/releases/tag/3.5.1) 中查看
|
||
|
||
* 2022-07-16 ：v4.0.0 版本重构：Delegate 取代 Block，新增手动对焦功能，优化拓展扫描视图，更多内容请在 [releases](https://github.com/kingsic/SGQRCode/releases/tag/4.0.0) 中查看
|
||
|
||
* 2022-07-16 ：v4.1.0 优化SGScanView内部代码逻辑，修复无扫描线时，导致程序崩溃问题
|
||
|
||
|
||
## License
|
||
SGQRCode is released under the Apache License 2.0. See [LICENSE](https://github.com/kingsic/SGQRCode/blob/master/LICENSE) for details.
|