ZBar 是輕量級開源條碼/二維碼識別庫,支援 iOS、Android 等平台。本文詳細說明如何在 iOS 專案中整合 ZBar SDK,採用 ZBarReaderView 嵌入式模式 (而非全螢幕 ViewController),實現高度客製化的掃描介面、掃描區域裁剪、閃光燈控制、模擬器測試與代理回呼處理。
ZBarSDK.h、靜態庫 libzbar.a、資源包)ZBarSDK 資料夾拖入專案,勾選 Copy items if neededAVFoundation.framework, CoreMedia.framework, CoreVideo.framework, QuartzCore.framework, libiconv.tbd, libzbar.aOther Linker Flags 加入 -ObjC#import "ZBarSDK.h"- (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 呼叫 startdidReceiveMemoryWarning 時暫停掃描並釋放 readerViewZBarCameraSimulator 允許從相簿選圖模擬掃描,CI 自動化測試必備AVCaptureMetadataOutput 原生支援 QR/條碼,無第三方依賴,效能最佳,推薦新專案優先使用VNDetectBarcodesRequest 機器學習增強識別率,支援更多格式