microblink/blinkid-ios

BlinkID SDK (iOS)

개요 – iOS 앱이 다양한 신분 문서(여권, 운전면허증, ID 카드 등)에서 데이터를 캡처, 분석 및 추출할 수 있게 해주는 상용 Swift SDK입니다. 문서 레이아웃, MRZ, 바코드 및 시각적 필드를 인식하는 온디바이스 AI 모델이 주요 작업을 수행합니다.

주요 구성 요소

BlinkIDSdk – 라이선스 키를 로드하고 필요한 AI 모델을 다운로드하거나 번들로 포함하며 스캔 세션을 생성하는 진입점입니다.
BlinkIDSession – 카메라 프레임(InputImage)을 수신하고 저수준 분석을 포함한 FrameProcessResult를 반환하며, 준비되면 전체 BlinkIDScanningResult를 반환하는 스캔별 객체입니다.
ScanningSettings – 모듈(문서 캡처, MRZ, 바코드, VIZ)을 활성화/비활성화하고 이미지 품질 임계값(흐림, 눈부심, 조명, 기울기)을 조정할 수 있습니다.
BlinkIDUX – 코어 SDK를 UI에 연결하는 기성 카메라 뷰(BlinkIDUXView)와 BlinkIDAnalyzer를 제공하는 선택적 SwiftUI 지원 UI 패키지입니다. 또한 스캔을 진행할 시기를 결정할 수 있도록 프레임별 완전성 정보를 노출합니다.
리소스 관리 – SDK는 모델을 OTA로 다운로드하거나 앱에 번들로 포함하거나 캐시를 지울 수 있습니다.

사용 방법

패키지 추가 – Swift Package Manager를 통해 추가(또는 BlinkID.xcframework를 수동으로 포함).

초기화 – 라이선스 키로 초기화:

let settings = BlinkIDSdkSettings(
    licenseKey: "YOUR‑KEY",
    resourcesConfiguration: ResourcesConfig(download: true)
)
let sdk = try await BlinkIDSdk.createBlinkIDSdk(withSettings: settings)

세션 생성 및 이미지 공급:

let session = await sdk.createScanningSession()
let result = await session.process(inputImage: capturedImage)
if result.processResult?.inputImageAnalysisResult.processingStatus == .success {
    let final = await session.getResult()
    // final에는 이름, 문서 번호, MRZ 등 추출된 필드가 포함됩니다
}

또는 UI 패키지 사용 – BlinkIDAnalyzer를 인스턴스화하고 BlinkIDUXView를 SwiftUI 계층 구조에 배치합니다. 이 뷰는 카메라 액세스, 실시간 피드백을 처리하고 현재 결과가 포함된 scanningResultState 클로저를 반환합니다.

중요한 이유 – 문서 검증은 온보딩, KYC, 여행 및 출입 통제 앱에서 일반적인 병목 현상입니다. BlinkID는 다음을 제공합니다:

온디바이스 AI – 이미지를 서버로 보낼 필요가 없어 개인 정보를 보호하고 지연 시간을 줄입니다.
광범위한 문서 지원 – README에는 지원되는 모든 ID 목록에 대한 링크가 있습니다.
최신 Swift – Swift 6, 동시성(async/await) 및 SwiftUI 통합으로 구축되었습니다.

일반적인 사용 사례

KYC를 위해 여권이나 운전면허증을 캡처해야 하는 모바일 뱅킹 앱.
여행 문서를 스캔하는 항공사 또는 국경 통제 앱.
연령 제한 ID를 검증하는 소매 또는 환대 솔루션.

시작하기 – 저장소를 클론하고 Samples 폴더를 열고 기기에서 샘플 앱을 실행한 후 README의 빠른 시작 가이드를 따르세요.

위의 모든 세부 정보는 저장소의 README에서 직접 가져온 것이며 추가 기능은 추론되지 않았습니다.

microblink/blinkid-ios

BlinkID SDK (iOS)

관련