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

iOS 二維碼名片的生成與掃描:從 CIFilter 到 AVCaptureSession

編輯:iOS 相關教學

二維碼本質上是按特定規則在平面上分佈的黑白圖形,用來記錄數據符號信息。它能承載的內容大致分三類:純文本、名片信息(vCard)和 URL。對應的應用場景也非常成熟——二維碼名片、掃碼支付、掃碼跳轉網頁等。本文完整實現「生成」與「掃描」兩個方向。

一、二維碼的生成

原理

生成環節的核心是 CIFilter(濾鏡)。系統內置了一個名為 CIQRCodeGenerator 的濾鏡,把數據塞進去就能得到二維碼圖像。至於中間那個頭像,則是在生成結果上再疊一張圖片。

步驟

  1. 創建濾鏡。
  2. 調用 setDefaults 恢復默認參數。
  3. 把字符串轉為 NSData 後設置給濾鏡。
  4. 取出輸出的 CIImage 並轉為 UIImage。
  5. 展示到界面上。

效果如下:

實現代碼

先用 storyboard 佈置兩個 imageView,一個放二維碼,一個放頭像:

@property (weak, nonatomic) IBOutlet UIImageView *imageView;
/** 點擊屏幕時生成並顯示二維碼 */
- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
{
    // 1. 創建濾鏡
    CIFilter *filter = [CIFilter filterWithName:@"CIQRCodeGenerator"];

    // 2. 恢復默認參數
    [filter setDefaults];

    // 3. 設置要編碼的數據
    NSString *dataString = @"https://www.xxx.com/theDesertIslandOutOfTheWorld/";
    NSData *data = [dataString dataUsingEncoding:NSUTF8StringEncoding];

    // 通過 KVC 設置輸入
    [filter setValue:data forKey:@"inputMessage"];

    // 4. 取出輸出圖像(CIImage 類型)
    CIImage *outImage = [filter outputImage];

    // 轉為 UIImage
    UIImage *image = [UIImage imageWithCIImage:outImage];

    // 5. 展示
    self.imageView.image = image;
}

用任意二維碼掃描工具驗證即可。若編碼內容是 URL,掃描後通常會直接打開對應網頁。

一個實務提醒:CIQRCodeGenerator 生成的原始圖尺寸很小(往往只有幾十像素),直接放大顯示邊緣會模糊。通常做法是對 CIImage 做 CGAffineTransformMakeScale 放大,或者用 CIFilter 的 inputCorrectionLevel 配合後續/CoreGraphics 重繪,保證每個「像素塊」邊緣銳利。

二、二維碼的掃描

前置條件

掃碼必須使用攝像頭,因此需要真機調試。Xcode 7 之後真機調試已免費,只要有 Apple ID 即可。

整體流程

  1. 通過攝像頭捕獲畫面。
  2. 解析出二維碼數據。
  3. 根據數據內容執行相應操作。

關鍵類 AVCaptureSession

AVCaptureSession 的作用是協調從音頻/視頻輸入設備到輸出端的數據流。它由三部分組成:

  • 輸入設備:AVCaptureDeviceInput,通常是攝像頭。
  • 輸出端:可以有多個,掃二維碼用 AVCaptureMetadataOutput。
  • 啟動:調用 -startRunning 開始捕獲。

此外還有兩個配套角色:通過設置輸出端的 metadataObjectTypes 過濾條件,可以只解析感興趣的類型;通過 AVCaptureVideoPreviewLayer 可以把攝像頭畫面渲染到指定圖層上,作為掃描界面的預覽背景。而為輸出端設置代理,則能實時接收解析結果。

完整實現

用屬性持有 session 與 preview layer,方便後續停止與移除:

@property (nonatomic, weak) AVCaptureSession *session;
@property (nonatomic, weak) AVCaptureVideoPreviewLayer *layer;

創建捕獲會話:

AVCaptureSession *session = [[AVCaptureSession alloc] init];
self.session = session;

添加視頻輸入設備:

// 指定輸入的媒體類型為視頻
AVCaptureDevice *device = [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo];
AVCaptureDeviceInput *input = [AVCaptureDeviceInput deviceInputWithDevice:device error:nil];
[session addInput:input];

添加元數據輸出端並設置代理:

AVCaptureMetadataOutput *output = [[AVCaptureMetadataOutput alloc] init];
[output setMetadataObjectsDelegate:self queue:dispatch_get_main_queue()];
[session addOutput:output];

限定只解析二維碼類型,這一步能顯著提升識別效率:

[output setMetadataObjectTypes:@[AVMetadataObjectTypeQRCode]];

把攝像頭畫面鋪到控制器視圖上:

AVCaptureVideoPreviewLayer *layer = [AVCaptureVideoPreviewLayer layerWithSession:session];
layer.frame = self.view.bounds;
[self.view.layer addSublayer:layer];

開始捕獲:

[session startRunning];

在代理方法中接收結果,掃到即停止並移除預覽圖層:

- (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(@"沒有掃描到數據");
    }
}

三、實戰中容易忽略的細節

  • startRunning 不要放主線程:它會阻塞當前線程,應放到後台隊列執行,否則界面會卡住。
  • 掃描框取景範圍:可以在 AVCaptureMetadataOutput 上設置 rectOfInterest,只解析取景框內的區域,既省性能也避免誤識別。
  • 權限說明:iOS 10 之後需要在 Info.plist 中配置 NSCameraUsageDescription,缺失會直接崩潰。
  • result 可能是多個:metadataObjects 是數組,一幀畫面可能識別出多個碼,業務上需要決定取哪一個。
  • 掃到之後要善後:停止 session、移除 preview layer、恢復閃光燈狀態,這些清理工作缺一不可。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved