從 iOS 7 開始,蘋果已經把二維碼的生成與掃描整合進系統框架,不必再引入第三方庫。
第一步:導入 CoreImage 框架。
#import <CoreImage/CoreImage.h>
第二步:透過 CIFilter 的 CIQRCodeGenerator 產生影像。
要注意的是,傳統的一維條碼只能承載數字,而二維碼的容量大得多,可以放純文字、名片資訊(vCard)、URL 等各類內容。
// 1. 建立過濾器
CIFilter *filter = [CIFilter filterWithName:@"CIQRCodeGenerator"];
// 2. 還原預設參數
[filter setDefaults];
// 3. 放入要編碼的資料(這裡以 URL 為例)
NSString *dataString = @"https://www.520it.com";
NSData *data = [dataString dataUsingEncoding:NSUTF8StringEncoding];
[filter setValue:data forKeyPath:@"inputMessage"];
// 4. 取得輸出影像
CIImage *outputImage = [filter outputImage];
// 5. 直接顯示會模糊,需放大並關閉內插以保留銳利邊緣
self.imageView.image = [self createNonInterpolatedUIImageFormCIImage:outputImage withSize:300];
/**
* 依 CIImage 產生指定尺寸的 UIImage
* @param image 來源 CIImage
* @param size 目標邊長
*/
- (UIImage *)createNonInterpolatedUIImageFormCIImage:(CIImage *)image withSize:(CGFloat)size {
CGRect extent = CGRectIntegral(image.extent);
CGFloat scale = MIN(size/CGRectGetWidth(extent), size/CGRectGetHeight(extent));
// 1. 建立 bitmap 上下文
size_t width = CGRectGetWidth(extent) * scale;
size_t height = CGRectGetHeight(extent) * scale;
CGColorSpaceRef cs = CGColorSpaceCreateDeviceGray();
CGContextRef bitmapRef = CGBitmapContextCreate(nil, width, height, 8, 0, cs, (CGBitmapInfo)kCGImageAlphaNone);
CIContext *context = [CIContext contextWithOptions:nil];
CGImageRef bitmapImage = [context createCGImage:image fromRect:extent];
// 關閉內插是關鍵:二維碼是位圖式圖形,內插會讓邊緣發糊導致掃不出來
CGContextSetInterpolationQuality(bitmapRef, kCGInterpolationNone);
CGContextScaleCTM(bitmapRef, scale, scale);
CGContextDrawImage(bitmapRef, extent, bitmapImage);
// 2. 轉回 UIImage
CGImageRef scaledImage = CGBitmapContextCreateImage(bitmapRef);
CGContextRelease(bitmapRef);
CGImageRelease(bitmapImage);
return [UIImage imageWithCGImage:scaledImage];
}
這段程式裡最容易被忽略卻最關鍵的一行是 CGContextSetInterpolationQuality(bitmapRef, kCGInterpolationNone)。CIQRCodeGenerator 輸出的原始影像很小,放大時若使用預設的內插演算法,黑白方塊的邊緣會被模糊化,結果就是「看起來很清楚但掃不出來」。
掃描走的是 AVFoundation 的 metadata 擷取流程,五個步驟:
// 1. 建立擷取工作階段 AVCaptureSession *session = [[AVCaptureSession alloc] init]; self.session = session; // 2. 加入輸入設備(影像來自相機) AVCaptureDevice *device = [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo]; AVCaptureDeviceInput *input = [AVCaptureDeviceInput deviceInputWithDevice:device error:nil]; [session addInput:input]; // 3. 加入 metadata 輸出 AVCaptureMetadataOutput *output = [[AVCaptureMetadataOutput alloc] init]; [output setMetadataObjectsDelegate:self queue:dispatch_get_main_queue()]; [session addOutput:output]; // 3.1 指定要辨識的 metadata 類型 [output setMetadataObjectTypes:@[AVMetadataObjectTypeQRCode]]; // 4. 加入預覽圖層 AVCaptureVideoPreviewLayer *layer = [AVCaptureVideoPreviewLayer layerWithSession:session]; layer.frame = self.view.bounds; [self.view.layer addSublayer:layer]; self.layer = layer; // 5. 開始掃描 [session startRunning];
補充兩點:AVCaptureMetadataOutput 的 availableMetadataObjectTypes 必須先確認裝置支援,在某些模擬器上會拿到空集合;另外 delegate 的 queue 指定為主佇列,回呼中就能直接更新 UI。
// 掃到資料時會呼叫此方法
- (void)captureOutput:(AVCaptureOutput *)captureOutput
didOutputMetadataObjects:(NSArray *)metadataObjects
fromConnection:(AVCaptureConnection *)connection {
if (metadataObjects.count > 0) {
// 取最後一筆,即為最新掃到的結果
AVMetadataMachineReadableCodeObject *object = [metadataObjects lastObject];
NSLog(@"%@", object.stringValue);
[self.session stopRunning]; // 停止掃描
[self.layer removeFromSuperlayer]; // 移除預覽圖層
} else {
NSLog(@"沒有掃描到數據");
}
}
實務上通常還會加一層「內容白名單」驗證,比對 stringValue 是否符合自家 URL scheme 或特定前綴,避免使用者掃到惡意連結後直接跳轉。
另外提醒:startRunning 是阻塞呼叫,若放在主執行緒會短暫卡住畫面。實測在真機上通常可接受,但若在模擬器或舊機型上感覺卡頓,可以把它移到背景佇列執行。