二維碼(QR Code,Quick Response Code)最早起源於日本,用特定的幾何圖形在平面(水平與垂直兩個方向)上按規律分布黑白方塊來承載資訊。相較於一維條碼只能在單一方向上表達、且僅能編碼數字與字母,二維碼可以存放漢字、數字、圖片連結等更豐富的內容,因此應用範圍廣泛得多。
本次要做的掃描插件需要:能讀取一般大眾二維碼;能辨識其中的網址與純文字;網址預設以 Safari 開啟,但自家網域必須在 App 內的 WebView 開啟;掃描結果以彈窗呈現;同時希望別的 App(如微信、淘寶)掃我們的碼時能導向 App Store 下載。
自己實作解碼演算法不現實,週期太長,因此選用第三方庫 ZBarSDK。判斷是否為網址用正則表達式過濾;內建瀏覽器用 UIWebView;彈窗部分因 UIAlertView 的 delegate 寫法繁瑣,改用開源的 BlockAlertView,它以 block 撰寫,使用起來直覺許多。
1. 從 GitHub 下載 ZBarSDK(bmorton/ZBarSDK)與 BlockAlertView,建立測試工程。
2. 在 storyboard 上放一個 button,連線到 btnClicked: 觸發掃描。
3. 加入所需的系統連結庫:QuartzCore、CoreVideo、CoreMedia、CoreGraphics 與 libiconv。
4. 於控制器的 header 引入 ZBarSDK.h 與 BlockAlertView.h,並宣告遵循 ZBarReaderDelegate。
ZBarSDK 是封裝好的靜態庫,其預設介面不易直接改寫。實用的做法是:先把 reader 原本的 subview 清空,再疊上自己的遮罩、掃描線與取消按鈕。
- (void)setOverlayStyle:(ZBarReaderViewController *)reader_ {
for (UIView *temp in [reader_.view subviews]) {
for (UIButton *btn in [temp subviews]) {
if ([btn isKindOfClass:[UIButton class]]) [btn removeFromSuperview];
}
for (UIToolbar *tool in [temp subviews]) {
if ([tool isKindOfClass:[UIToolbar class]]) {
[tool setHidden:YES];
[tool removeFromSuperview];
}
}
}
isBottom = NO;
line = [[UIView alloc] initWithFrame:CGRectMake(40, 105, 240, 2)];
line.backgroundColor = [UIColor greenColor];
[reader_.view addSubview:line];
lineTimer = [NSTimer scheduledTimerWithTimeInterval:1.5
target:self
selector:@selector(moveLine)
userInfo:nil repeats:YES];
CGSize size = [UIScreen mainScreen].bounds.size;
UIImageView *scanningView = [[UIImageView alloc]
initWithFrame:CGRectMake(0, 0, size.width, size.height)];
scanningView.image = [UIImage imageNamed:@"scanning-568h.png"];
[reader_.view addSubview:scanningView];
UIButton *cancelButton = [UIButton buttonWithType:UIButtonTypeRoundedRect];
[cancelButton setFrame:CGRectMake(20, size.height - 84, 280, 40)];
[cancelButton setTitle:@"取消" forState:UIControlStateNormal];
[cancelButton addTarget:self action:@selector(dismissOverlayView:)
forControlEvents:UIControlEventTouchUpInside];
[reader_.view addSubview:cancelButton];
}
掃描線的上下往返用一段簡單的動畫即可:
- (void)moveLine {
CGRect frame = line.frame;
if (!isBottom) {
isBottom = YES;
frame.origin.y += 245.0;
} else {
isBottom = NO;
frame.origin.y -= 245.0;
}
[UIView animateWithDuration:1.5 animations:^{ line.frame = frame; }];
}
- (void)dismissOverlayView:(id)sender {
[lineTimer invalidate];
[reader dismissViewControllerAnimated:YES completion:nil];
}
- (void)viewDidLoad {
[super viewDidLoad];
reader = [ZBarReaderViewController new];
reader.readerDelegate = self;
reader.wantsFullScreenLayout = NO;
reader.showsZBarControls = NO; // 隱藏底部控制列
[self setOverlayStyle:reader];
}
- (IBAction)btnClicked:(id)sender {
[self presentViewController:reader animated:YES completion:nil];
}
- (void)imagePickerController:(UIImagePickerController *)reader
didFinishPickingMediaWithInfo:(NSDictionary *)info {
id<NSFastEnumeration> results = [info objectForKey:ZBarReaderControllerResults];
ZBarSymbol *symbol = nil;
for (symbol in results) break;
if (symbol.data && [symbol.data rangeOfString:@"http:"].length > 0) {
NSString *regex = @"http+:[^\\s]*";
NSPredicate *predicate =
[NSPredicate predicateWithFormat:@"SELF MATCHES %@", regex];
if ([predicate evaluateWithObject:symbol.data]) {
// 自家連結走內建瀏覽器,其餘交給系統
[[UIApplication sharedApplication] openURL:
[NSURL URLWithString:symbol.data]];
}
} else {
NSString *msg = [symbol.data
stringByReplacingPercentEscapesUsingEncoding:NSUTF8StringEncoding];
BlockAlertView *alert = [BlockAlertView alertWithTitle:@"結果" message:msg];
[alert addButtonWithTitle:@"知道了" block:nil];
[alert show];
}
}
若讀取失敗,可在 readerControllerDidFailToRead:withRetry: 中同樣用 BlockAlertView 提示「掃描失敗,無法讀取二維碼資訊」。
建立一個 WebViewVC,實作 UIWebViewDelegate,並用一個 urlStr 屬性接收要載入的網址;在 viewDidLoad 中判斷 urlStr 是否以 http 開頭,若是則建立 UIWebView 並 loadRequest。
這是最容易卡住的一環。App Store 有兩種常見的跳轉寫法:
寫法一:itms-apps://ax.itunes.apple.com/...
寫法二:itms-apps://itunes.apple.com/cn/app/idXXXXXXXX?...
實測經驗是:微信、淘寶等掃描器往往只把內容當網址處理,遇到 itms-apps 開頭不會跳。若要在二維碼裡「騙過」這些掃描器,內容必須以 https:// 開頭。此時寫法二較可靠,可改成:
https://itunes.apple.com/cn/app/id794862904?url=https://xyk.cebbank.com
曾嘗試先用一個 http 網址再做重定向,但微信依舊不跳。仔細研究可發現某些大廠的碼會經過多次轉址(例如 m.ctrip.com 的短址 → 下載頁 → itunes.apple.com → itms-apps://),最後由 Safari 完成跳轉。這類多段轉址的做法兼容性最好,值得在正式專案中採用。
ZBarSDK 屬於較早期的方案,如今 AVFoundation 內建的 AVCaptureMetadataOutput 已能原生支援 QR、PDF417、Aztec 等格式,且不需引入額外套件。新專案建議優先評估原生 API,只有在需要 ZBar 特有格式時才考慮第三方庫。此外,無論用哪種方案,都別忘了在 Info.plist 加上 NSCameraUsageDescription 說明用途,否則 iOS 10 以後會直接崩潰。