萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

iOS 集成 ZBar 掃描二維碼完整指南:ZBarReaderView 嵌入式模式最佳實踐

前言

ZBar 是輕量級開源條碼/二維碼識別庫,支援 iOS、Android 等平台。本文詳細說明如何在 iOS 專案中整合 ZBar SDK,採用 ZBarReaderView 嵌入式模式 (而非全螢幕 ViewController),實現高度客製化的掃描介面、掃描區域裁剪、閃光燈控制、模擬器測試與代理回呼處理。

整合準備

  1. 下載 ZBar iOS SDK (含 ZBarSDK.h、靜態庫 libzbar.a、資源包)
  2. 將 ZBarSDK 資料夾拖入專案,勾選 Copy items if needed
  3. Target → Build Phases → Link Binary With Libraries → 加入:
    AVFoundation.framework, CoreMedia.framework, CoreVideo.framework, QuartzCore.framework, libiconv.tbd, libzbar.a
  4. Build Settings → Other Linker Flags 加入 -ObjC
  5. 在需使用的檔案匯入:#import "ZBarSDK.h"

ZBarReaderView 初始化與配置

- (void)setupZBarReaderView {
    // 1. 建立 ReaderView,預留頂部 44pt 給導航列
    ZBarReaderView *readerView = [[ZBarReaderView alloc] init];
    readerView.frame = CGRectMake(0, 44,
        self.view.frame.size.width,
        self.view.frame.size.height - 44);

    // 2. 設定代理
    readerView.readerDelegate = self;

    // 3. 關閉閃光燈 (0=關, 1=開, 2=自動)
    readerView.torchMode = 0;

    // 4. 定義掃描區域遮罩 (畫面中央 200x200 區域)
    CGRect scanMaskRect = CGRectMake(60,
        CGRectGetMidY(readerView.frame) - 126,
        200, 200);

    // 5. 模擬器相容處理 (真機可略過)
    #if TARGET_IPHONE_SIMULATOR
    ZBarCameraSimulator *cameraSimulator =
        [[ZBarCameraSimulator alloc] initWithViewController:self];
    cameraSimulator.readerView = readerView;
    #endif

    // 6. 加入視圖
    [self.view addSubview:readerView];
    self.readerView = readerView; // 持有強引用

    // 7. 關鍵:將 UIKit 座標系掃描區轉換為 ZBar 正規化座標系 (0~1)
    readerView.scanCrop = [self scanCropForRect:scanMaskRect
                              readerViewBounds:readerView.bounds];

    // 8. 啟動掃描
    [readerView start];
}

座標系轉換核心方法

- (CGRect)scanCropForRect:(CGRect)rect readerViewBounds:(CGRect)bounds {
    // ZBar 使用歸一化座標:origin (0,0) 為左上,width/height 為 1.0 代表全畫面
    CGFloat x = rect.origin.x / bounds.size.width;
    CGFloat y = rect.origin.y / bounds.size.height;
    CGFloat w = rect.size.width / bounds.size.width;
    CGFloat h = rect.size.height / bounds.size.height;
    return CGRectMake(x, y, w, h);
}

⚠️ 常見錯誤:網路上許多範例將 x/y 或 width/height 交叉對調,導致掃描區域錯位。正確邏輯:x 對應 width、y 對應 height,切勿交叉。

代理回呼處理掃描結果

#pragma mark - ZBarReaderViewDelegate

- (void)readerView:(ZBarReaderView *)readerView
    didReadSymbols:(ZBarSymbolSet *)symbols
        fromImage:(UIImage *)image {

    for (ZBarSymbol *symbol in symbols) {
        NSString *scannedData = symbol.data;
        NSLog(@"掃描結果: %@", scannedData);

        // 業務邏輯:跳轉、查詢 API、本地資料庫比對等
        [self handleScannedCode:scannedData type:symbol.type];

        break; // 單次掃描模式:取第一個結果即停止
    }

    // 停止掃描以節省資源
    [readerView stop];
}

生命週期管理

- (void)viewWillDisappear:(BOOL)animated {
    [super viewWillDisappear:animated];
    [self.readerView stop];
    self.readerView.readerDelegate = nil;
    self.readerView = nil;
}

- (void)viewDidAppear:(BOOL)animated {
    [super viewDidAppear:animated];
    if (self.readerView) [self.readerView start];
}

進階客製化技巧

需求實現方式
自訂掃描框 UI在 readerView 上層疊加自定義 UIView 繪製動畫掃描線、角標、提示文字
支援多種條碼格式readerView.symbologies = @[ZBarSymbolQRCODE, ZBarSymbolEAN13, ZBarSymbolUPCA]
連續掃描模式移除 break 與 stop,維持 readerView 運行;去重邏輯自行實現
前置攝像頭掃描readerView.cameraDevice = UIImagePickerControllerCameraDeviceFront (iOS 4+)
相機權限處理iOS 10+ 需 NSCameraUsageDescription;被拒時引導至設定頁

效能與穩定性建議

  • 弱引用代理:@property (nonatomic, weak) id readerDelegate; 避免循環引用
  • 背景/前台切換:applicationDidEnterBackground 呼叫 stop,applicationWillEnterForeground 呼叫 start
  • 記憶體壓力:didReceiveMemoryWarning 時暫停掃描並釋放 readerView
  • 模擬器測試:ZBarCameraSimulator 允許從相簿選圖模擬掃描,CI 自動化測試必備

替代方案對比

  • AVFoundation 原生 (iOS 7+):AVCaptureMetadataOutput 原生支援 QR/條碼,無第三方依賴,效能最佳,推薦新專案優先使用
  • Vision Framework (iOS 11+):VNDetectBarcodesRequest 機器學習增強識別率,支援更多格式
  • ML Kit / Firebase ML:雲端/離線模型,跨平台一致性佳
copyright © 萬盛學電腦網 all rights reserved