自 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 進入背景時暫停,回到前景再恢復。