Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kingsic/SGQRCode
The easy to use bar code and QR code scan library for iOS【支持二维码生成、读取图片中二维码、条形码和二维码扫描】
https://github.com/kingsic/SGQRCode
barcode qrcode
Last synced: 3 months ago
JSON representation
The easy to use bar code and QR code scan library for iOS【支持二维码生成、读取图片中二维码、条形码和二维码扫描】
- Host: GitHub
- URL: https://github.com/kingsic/SGQRCode
- Owner: kingsic
- License: apache-2.0
- Created: 2016-08-29T17:19:47.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2024-02-02T07:16:28.000Z (9 months ago)
- Last Synced: 2024-06-18T12:38:32.208Z (5 months ago)
- Topics: barcode, qrcode
- Language: Objective-C
- Homepage:
- Size: 51.2 MB
- Stars: 1,676
- Watchers: 40
- Forks: 368
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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说明)
## 主要功能
`生成二维码`
`扫描二维码`
`捕获内容缩放功能`
`图片中识别二维码`
`相机、相册权限判断`
`根据光线强弱开启关闭手电筒`
`扫描成功后界面间的逻辑跳转处理`
`扫描界面可高度自定义（满足所有主流app）`
## 主要类说明
| 类名 | 说明 |
|-----|-----|
| SGScanCode | 扫描二维码 |
| SGScanViewConfigure | 扫描视图配置 |
| SGScanView | 扫描视图 |
| SGPermission | 相册、相机权限管理 |
| SGTorch | 手电筒管理 |
| SGQRCodeLog | 调试日志 |
## SGQRCode 集成流程
**手动集成**
`添加 SGQRCode 文件夹到工程中`
**通过 CocoaPods 集成**
`pod 'SGQRCode', '~> 4.1.0'`
**Info.plist 添加以下字段**
`NSCameraUsageDescription (相机权限访问)`
`NSPhotoLibraryUsageDescription (相册权限访问)`
**引用头文件**
`#import `
**扫描二维码相关代码**
```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];
```
## 效果图
## 问题及解决方案
* 若在使用 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.