您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 集成 ZXing 實現二維碼掃描的完整步驟

編輯:iOS 開發綜合

此前在 iOS 項目中接入過 ZXing 的掃碼能力,這裡把集成過程與使用方式整理出來,供需要的人參考。

一、集成步驟

1. 下載並裁剪源碼

從 Google Code 或 GitHub 下載 ZXing,整個倉庫相當龐大,我們只需要 iOS 相關部分。原則上保留 cpp 與 iphone 兩個目錄,其餘全部刪除。

2. 繼續精簡 cpp 目錄

對 cpp 目錄,只保留 cpp/core/src/zxing 下的內容,其餘也可刪去,但目錄結構必須保持原樣,否則編譯會大量報錯。裁剪後的結構如下:

3. 拖入工程

把裁剪後的 zxing 目錄移動到 iOS 項目目錄下,並將 ZXingWidget.xcodeproj 拖進我們的工程。

4. 配置依賴關係

在 iOS 項目的 Build Phases 中,添加 Target Dependencies 與 Link Binary With Libraries,並引入以下庫:

  • AVFoundation
  • AudioToolbox
  • CoreVideo
  • CoreMedia
  • libiconv
  • AddressBook
  • AddressBookUI

5. 添加 Header Search Path

./zxing/iphone/ZXingWidget/Classes
./zxing/cpp/core/src

注意第一個路徑需勾選遞歸查找子目錄,第二個則不勾選。

二、掃碼功能的兩種用法

方法一:直接用現成的 ZXingWidgetController

ZXing 已經封裝好一個掃碼視圖控制器,接入最快。先在文件中引入頭文件:

#import <ZXingWidgetController.h>
#import <QRCodeReader.h>

需要掃描時調用:

- (IBAction)scanPressed:(id)sender
{
    ZXingWidgetController *widController =
        [[ZXingWidgetController alloc] initWithDelegate:self showCancel:YES OneDMode:NO];
    NSMutableSet *readers = [[NSMutableSet alloc] init];
    QRCodeReader *qrcodeReader = [[QRCodeReader alloc] init];
    [readers addObject:qrcodeReader];
    [qrcodeReader release];
    widController.readers = readers;
    [readers release];
    [self presentModalViewController:widController animated:YES];
    [widController release];
}

掃描結果通過 delegate 回落:

@protocol ZXingDelegate
- (void)zxingController:(ZXingWidgetController *)controller didScanResult:(NSString *)result;
- (void)zxingControllerDidCancel:(ZXingWidgetController *)controller;
@end

方法二:自行控制採集流程

方法二與方法一的關係,就像 AVCaptureSession 與 UIImagePickerController 的關係:前者更麻煩,但可定制性高得多。做法是自行用 AVFoundation 取得相機實時畫面,轉成 UIImage,再交給 ZXing 的 Decoder 解碼。

#import "Decoder.h"
#import "TwoDDecoderResult.h"
#import "QRCodeReader.h"

- (void)viewDidLoad
{
    // 準備 QR 讀取器集合
    self.qrReader = [[NSMutableSet alloc] init];
    QRCodeReader *qrcodeReader = [[QRCodeReader alloc] init];
    [self.qrReader addObject:qrcodeReader];
    self.scanningQR = NO;
    self.step = STEP_QR;
}

// AVFoundation 採樣回調
- (void)captureOutput:(AVCaptureOutput *)captureOutput
didOutputSampleBuffer:(CMSampleBufferRef)sampleBuffer
       fromConnection:(AVCaptureConnection *)connection
{
    // 第一步:把 sampleBuffer 轉成 UIImage
    UIImage *image = [self getCaptureImage:sampleBuffer];

    // 第二步:交給 Decoder 識別
    Decoder *d = [[Decoder alloc] init];
    d.readers = self.qrReader;
    d.delegate = self;
    self.scanningQR = [d decodeImage:image] == YES ? NO : YES;
}

Decoder 提供的回調協議:

@protocol DecoderDelegate <NSObject>
@optional
- (void)decoder:(Decoder *)decoder willDecodeImage:(UIImage *)image usingSubset:(UIImage *)subset;
- (void)decoder:(Decoder *)decoder didDecodeImage:(UIImage *)image usingSubset:(UIImage *)subset
     withResult:(TwoDDecoderResult *)result {
    NSLog(@"result = %@", [result text]);
}
- (void)decoder:(Decoder *)decoder failedToDecodeImage:(UIImage *)image usingSubset:(UIImage *)subset
         reason:(NSString *)reason;
- (void)decoder:(Decoder *)decoder foundPossibleResultPoint:(CGPoint)point;
@end

三、踩坑記錄

接入過程中最麻煩的是編譯問題:

  • 找不到頭文件:把引用 ZXing 的源文件後綴由 .m 改為 .mm,因為 ZXing 核心是 C++ 實現。
  • Undefined symbols for architecture armv7s:把 ZXingWidget target 的 Build Active Architecture Only 改為 NO。
  • No such file or directory:多半是 Header Search Path 寫錯,或 zxing 目錄結構未按要求保留,逐項核對即可。

四、與 OpenCV 的兼容問題

ZXing 2.1 與 OpenCV 2.4.3 的 iOS 版本存在兼容衝突,二者對 C++ 標準庫版本與編譯器版本的要求不一致,滿足一方另一方就編譯失敗。社區裡找到的解法可讓它們共存,但僅適用於 iOS 5.0 及以上。若你也遇到同樣問題,可參考相關討論帖。

五、更現代的選擇

需要說明的是,ZXing 的 Objective-C 分支(ZXingObjC)與 iOS 原生 AVCaptureMetadataOutput 都已能輕鬆完成二維碼識別。若只需掃描常見碼制,直接使用原生 API 幾行代碼即可搞定,無需引入這麼重的庫:

AVCaptureMetadataOutput *output = [[AVCaptureMetadataOutput alloc] init];
[session addOutput:output];
[output setMetadataObjectsDelegate:self queue:dispatch_get_main_queue()];
output.metadataObjectTypes = @[AVMetadataObjectTypeQRCode];

權衡點在於:ZXing 支持的碼制更全、可定制性更強,但集成成本高;原生方案集成簡單、性能更好,但對 PDF417、Aztec 等冷門格式的支持有限。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved