您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

iOS 二維碼掃描實作:以 ZBarSDK 打造自訂掃描介面

編輯:iOS 相關資訊

一、先認識二維碼

二維碼(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 掃描時能跳 App Store

這是最容易卡住的一環。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 以後會直接崩潰。

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