iOS 花式二維碼生成和二維碼識別

EyreFree發表於2017-12-26
iOS

iOS 原生的二維碼識別非常之棒，反正比 ZXing 和 ZBar 效果都好些，所以以後打算儘量用原生的二維碼識別，然後最近把原生的二維碼生成也順便做了一遍，並且在原有基礎上加了一些樣式引數，封了一個小庫方便以後使用。

專案地址：github.com/EyreFree/EF…

iOS 花式二維碼生成和二維碼識別

EFQRCode 是一個用 Swift 編寫的用來生成和識別二維碼的庫，基於 CoreImage 進行開發。

  • 生成：利用輸入的水印圖/圖示等資源生成各種藝術二維碼；
  • 識別：識別率比 iOS 原生二維碼識別率更高。

支援 iOS / macOS / tvOS 平臺，支援 CocoaPods / Carthage / SPM 整合。

概述

iOS 花式二維碼生成和二維碼識別
iOS 花式二維碼生成和二維碼識別
iOS 花式二維碼生成和二維碼識別
iOS 花式二維碼生成和二維碼識別
iOS 花式二維碼生成和二維碼識別
iOS 花式二維碼生成和二維碼識別
iOS 花式二維碼生成和二維碼識別
iOS 花式二維碼生成和二維碼識別

示例

應用商店

你可以點選下方的 App Store 按鈕從應用商店下載示例程式，支援 iOS 和 tvOS：

iOS 花式二維碼生成和二維碼識別

你也可以點選下方的 Mac App Store 按鈕下載 macOS 示例程式：

iOS 花式二維碼生成和二維碼識別

手動

  1. 利用 git clone 命令下載本倉庫, Examples 目錄包含了所有的示例程式；
  2. 用 XCode 開啟對應專案編譯即可。

或執行以下命令：

git clone git@github.com:EyreFree/EFQRCode.git; cd EFQRCode/Examples/iOS; open 'iOS Example.xcodeproj'
複製程式碼

環境

版本 需求
1.x XCode 8.0+
Swift 3.0+
iOS 8.0+ / macOS 10.11+ / tvOS 9.0+
4.x XCode 9.0+
Swift 4.0+
iOS 8.0+ / macOS 10.11+ / tvOS 9.0+

安裝

CocoaPods

EFQRCode 可以通過 CocoaPods 進行獲取。只需要在你的 Podfile 中新增如下程式碼就能實現引入：

pod "EFQRCode", '~> 4.1.0'
複製程式碼

然後，執行如下命令即可：

$ pod install
複製程式碼

Carthage

Carthage 是一個去中心化的依賴管理器，它為我們構建依賴並通過提供二進位制 Frameworks 的方式供我們使用。

你可以通過 Homebrew 使用如下命令來安裝 Carthage：

$ brew update
$ brew install carthage
複製程式碼

通過在你的 Cartfile 新增如下語句可以將 EFQRCode 引入你的專案：

github "EyreFree/EFQRCode" ~> 4.1.0
複製程式碼

接下來執行 carthage update 命令生成 Framework 並且將生成的 EFQRCode.framework 拖入工程即可。

Swift Package Manager

Swift Package Manager 是一個整合在 swift 編譯器中的用來進行 Swift 程式碼自動化釋出的工具。

如果你已經建立了你的 Swift 包，將 EFQRCode 加入依賴是十分容易的，只需要將其新增到你的 Package.swift 檔案的 dependencies 項中即可：

dependencies: [
    .Package(url: "https://github.com/EyreFree/EFQRCode.git", Version(4, 1, 0))
]
複製程式碼

快速使用

1. 匯入 EFQRCode

在你需要使用的地方新增如下程式碼引入 EFQRCode 模組：

import EFQRCode
複製程式碼

2. 二維碼識別

獲取圖片中所包含的二維碼，同一張圖片中可能包含多個二維碼，所以返回值是一個字串陣列：

if let testImage = UIImage(named: "test.png")?.toCGImage() {
    if let tryCodes = EFQRCode.recognize(image: testImage) {
        if tryCodes.count > 0 {
            print("There are \(tryCodes.count) codes in testImage.")
            for (index, code) in tryCodes.enumerated() {
                print("The content of \(index) QR Code is: \(code).")
            }
        } else {
            print("There is no QR Codes in testImage.")
        }
    } else {
        print("Recognize failed, check your input image!")
    }
}
複製程式碼

3. 二維碼生成

根據所輸入引數建立各種藝術二維碼圖片，快速使用方式如下:

//                    content: 二維碼內容
//            size (Optional): 二維碼寬高
// backgroundColor (Optional): 二維碼背景色
// foregroundColor (Optional): 二維碼前景色
//       watermark (Optional): 水印圖
複製程式碼
if let tryImage = EFQRCode.generate(
    content: "https://github.com/EyreFree/EFQRCode",
    watermark: UIImage(named: "WWF")?.toCGImage()
) {
    print("Create QRCode image success: \(tryImage)")
} else {
    print("Create QRCode image failed!")
}
複製程式碼

結果：

iOS 花式二維碼生成和二維碼識別

4. 動態二維碼

可通過 EFQRCode 的類方法 generateWithGIF 來建立 GIF 二維碼，使用方式如下：

//                  data: 輸入的 GIF 圖片的資料
//             generator: 一個用來獲取設定的 EFQRCodeGenerator 物件
// pathToSave (Optional): 用來儲存 GIF 的路徑，預設不填的話會儲存在臨時路徑
//      delay (Optional): 輸出的動態 QRCode 的幀間延時，預設不填的話從輸入的 GIF 圖片獲取
//  loopCount (Optional): 輸出的動態 QRCode 的迴圈次數，預設不填的話從輸入的 GIF 圖片獲取
複製程式碼
if let qrcodeData = EFQRCode.generateWithGIF(data: data, generator: generator) {
    print("Create QRCode image success.")
} else {
    print("Create QRCode image failed!")
}
複製程式碼

你可以通過檢視 Demo 程式碼的方式來獲取更多資訊，結果預覽：

iOS 花式二維碼生成和二維碼識別

使用指南

詳情可參見具體使用文件：github.com/EyreFree/EF…

備註

  1. 請選用對比度較高的前景色和背景色組合；
  2. 想要提高生成二維碼的清晰度可以選擇使用 magnificatio 替代 size，或適當提高它們的數值；
  3. 放大倍數過高／邊長過大／二維碼內容過多可能會導致生成失敗；
  4. 建議對生成的二維碼進行測試後投入使用，例如微信能夠掃描成功並不代表支付寶也能成功掃描，請務必根據您的具體業務需要做有針對性的測試；
  5. 若有任何問題，期待得到您的反饋，Issue 和 Pull request 都是受歡迎的。

備註的備註：好用的話可以給個星星，蟹蟹，QAQ...

如有任何智慧財產權、版權問題或理論錯誤，還請指正。
https://juejin.im/post/5a3214a451882503eb4b4bed
轉載請註明原作者及以上資訊。

相關文章