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

iOS 實作 QR Code 掃描功能

編輯:iOS 相關教學

自 iOS 7 起,掃描二維碼不必再依賴 ZXing 這類第三方庫,AVFoundation 已經內建了完整的 metadata 擷取能力。以下是最精簡的實作。

// ViewController.m
#import <AVFoundation/AVFoundation.h>
#import "ViewController.h"

@interface ViewController () <AVCaptureMetadataOutputObjectsDelegate>
@end

@implementation ViewController

- (void)viewDidLoad
{
    [super viewDidLoad];

    // 1. 建立擷取工作階段
    AVCaptureSession *session = [[AVCaptureSession alloc] init];

    // 2. 取得相機裝置並建立輸入
    AVCaptureDevice *device = [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo];
    NSError *error = nil;
    AVCaptureDeviceInput *input = [AVCaptureDeviceInput deviceInputWithDevice:device error:&error];
    if (input) {
        [session addInput:input];
    } else {
        NSLog(@"Error: %@", error);
    }

    // 3. 建立 metadata 輸出,並指定要辨識的格式
    AVCaptureMetadataOutput *output = [[AVCaptureMetadataOutput alloc] init];
    // 同時支援 QR Code 與常見的一維條碼
    [output setMetadataObjectTypes:@[AVMetadataObjectTypeQRCode,
                                      AVMetadataObjectTypeEAN13Code,
                                      AVMetadataObjectTypeEAN8Code,
                                      AVMetadataObjectTypeCode128Code]];
    [output setMetadataObjectsDelegate:self queue:dispatch_get_main_queue()];
    [session addOutput:output];

    // 4. 啟動
    [session startRunning];
}

#pragma mark - AVCaptureMetadataOutputObjectsDelegate

- (void)captureOutput:(AVCaptureOutput *)captureOutput
didOutputMetadataObjects:(NSArray *)metadataObjects
       fromConnection:(AVCaptureConnection *)connection
{
    NSString *QRCode = nil;

    for (AVMetadataObject *metadata in metadataObjects) {
        if ([metadata.type isEqualToString:AVMetadataObjectTypeQRCode]) {
            QRCode = [(AVMetadataMachineReadableCodeObject *)metadata stringValue];
            break;
        }
    }

    NSLog(@"QR Code: %@", QRCode);
}

- (void)didReceiveMemoryWarning
{
    [super didReceiveMemoryWarning];
}

@end

運作原理

整個流程是標準的 AVFoundation 四段式:AVCaptureSession 是管線本身,負責串接輸入與輸出;AVCaptureDeviceInput 把相機畫面灌進來;AVCaptureMetadataOutput 在背景執行辨識;辨識成功後透過委派回呼把結果交給你。值得注意的是委派的第二個參數是 queue,範例中傳入主佇列,因此可以直接在回呼裡更新 UI。

實務上必須補上的部分

上面的程式碼只是「能掃」的最小骨架,要變成可用的功能還缺幾塊。

預覽層。使用者需要看到相機畫面才知道自己在對準什麼。建立一個 AVCaptureVideoPreviewLayer,把它加進 view 的 layer 並設定 frame 即可。

掃描框與提示。通常會在預覽上蓋一個半透明遮罩,中間挖出掃描區域,再搭配一行說明文字。若想做「僅掃描框內才辨識」,需實作 AVCaptureMetadataOutputRectOfInterest 的設定,注意這個矩形用的是「相鄰座標」而非 UIKit 座標系。

權限處理。iOS 7 時代只需在 App 執行時處理授權;iOS 10 之後必須在 Info.plist 加入 NSCameraUsageDescription 並以 AVCaptureDevice requestAccessForMediaType: 動態請求,否則 App 會直接崩潰。

避免重複觸發。同一個 QR code 在畫面前停留時,委派會連續回呼好幾次。實務上要在第一次取得結果後立刻暫停 session(或直接關閉掃描頁),否則可能重複送出請求。

别忘了在 dealloc 中停止 session。相機佔用資源不小,離開頁面時務必呼叫 [session stopRunning],並在 App 進入背景時暫停,回到前景再恢復。

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