如何在Blink ID iOS SDK中实现与Android SDK同款QuadView功能

算力阿峰

2026-7-13

在Blink ID iOS SDK中实现QuadView功能

核心实现步骤

iOS SDK里的QuadView对应实时识别并展示证件边缘轮廓的功能，可通过以下方式实现与Android端一致的效果：

基础集成方案（利用SDK内置组件）
使用MBBlinkIdCombinedRecognizer作为核心识别器，搭配MBBlinkIdOverlayViewController即可默认开启Quad框展示：

let recognizer = MBBlinkIdCombinedRecognizer()
let overlaySettings = MBBlinkIdOverlaySettings()
let overlayVC = MBBlinkIdOverlayViewController(recognizer: recognizer, settings: overlaySettings)
let scanningVC = MBViewControllerFactory.viewController(with: overlayVC)
present(scanningVC, animated: true)

自定义Quad框样式
如果需要和Android端样式对齐，可通过MBBlinkIdOverlaySettings调整外观属性：

let overlaySettings = MBBlinkIdOverlaySettings()
// 设置Quad框边框颜色
overlaySettings.overlayViewSettings.detectionFrameBorderColor = UIColor(red: 0, green: 1, blue: 0, alpha: 1)
// 设置边框粗细
overlaySettings.overlayViewSettings.detectionFrameBorderWidth = 2.0
// 开启自动缩放适配证件大小
overlaySettings.shouldEnableZoom = true

自定义扫描界面（进阶场景）
若需完全自定义布局，可实现MBScanningRecognizerRunnerDelegate监听Quad检测结果，手动绘制框体：

func recognizerRunner(_ recognizerRunner: MBRecognizerRunner, didOutput result: MBRecognizerResult) {
    guard let quadResult = result as? MBQuadDetectionResult else { return }
    // 获取证件四个顶点坐标
    let quadPoints = quadResult.quadrilateral.points
    // 调用自定义绘制方法渲染Quad框
    renderCustomQuadView(with: quadPoints)
}