SmartScanner Core

ID scanning Android app and library. Supports MRZ, NFC, Barcodes, and ID PASS Lite cards.

Note: The library's API might keep evolving before we reach v1.0, so be careful when upgrading between these pre-v1.0 versions. Starting at v1.0 we will be careful in introducing breaking API changes.

Features

Scan MRZ
Scan NFC
Scan Barcode
Scan ID PASS Lite
Scan OCR
Supports Intent Call Out (ODK & Non-ODK)

This repository also includes an Android demo app to test what the library can do.

Related projects

smartscanner-android-api - Provides convenience methods to simplify the SmartScanner intent call out process
smartscanner-capacitor - SmartScanner Capacitor plugin
smartscanner-cordova - SmartScanner Cordova plugin

Installation

Declare Maven Central repository in the dependency configuration, then add this library in the dependencies. An example using build.gradle:

repositories {
  mavenCentral()
}

dependencies {
  implementation "org.idpass:idpass-smartscanner:0.0.1-SNAPSHOT"
}

If you want to build this library from source, instructions to do so can be found in the Building from source wiki page.

Usage

The following table shows the intent actions available for each operation available in the library, both in ODK and Non-ODK:

Scan Operation	ODK	Non-ODK
MRZ	`org.idpass.smartscanner.odk.MRZ_SCAN`	`org.idpass.smartscanner.MRZ_SCAN`
NFC	`org.idpass.smartscanner.odk.NFC_SCAN`	`org.idpass.smartscanner.NFC_SCAN`
Barcode	`org.idpass.smartscanner.odk.BARCODE_SCAN`	`org.idpass.smartscanner.BARCODE_SCAN`
QR code	`org.idpass.smartscanner.odk.QRCODE_SCAN`	`org.idpass.smartscanner.QRCODE_SCAN`
ID PASS Lite	`org.idpass.smartscanner.odk.IDPASS_LITE_SCAN`	`org.idpass.smartscanner.IDPASS_LITE_SCAN`
OCR	`org.idpass.smartscanner.odk.OCR_SCAN`	`org.idpass.smartscanner.OCR_SCAN`

To perform an operation, create an intent for the desired operation. This example shows how to call an intent to scan an MRZ (ODK):

import android.app.Activity
import android.content.ActivityNotFoundException
import android.content.Intent
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {

  private const val OP_SCANNER = 1001 // Activity request code

  override fun onStart() {
    super.onStart()

    try {
      val action = "org.idpass.smartscanner.odk.MRZ_SCAN"
      val intent = Intent(action)
      startActivityForResult(intent, OP_SCANNER)
    } catch (ex: ActivityNotFoundException) {
      ex.printStackTrace()
    }
  }

  public override fun onActivityResult(requestCode: Int, resultCode: Int, intent: Intent?) {
    super.onActivityResult(requestCode, resultCode, intent)

    if (requestCode == OP_SCANNER) {
      if (resultCode == Activity.RESULT_OK) {
        val bundle = intent?.getBundleExtra("result")
      }
    }
  }

}

The bundle variable is a Bundle object containing the scan results. For example, the scanned surname can be obtained through:

val surname = bundle.getString("surname")

Refer to the Result fields reference for the different fields available from the scan results.

Refer to the API Reference for complete information about each scan operation and the different options available.

Refer to the SmartScanner intent extra reference for examples on how to pass different options intent extra to SmartScanner.

Finally, for convenience we recommend using the smartscanner-android-api library which simplifies the app intent call out process.

Running the demo app

The Android demo app is available in this repository's app directory. Open this directory in Android Studio (version 4.1 and above) and the app can be built and run from there.

License

Apache-2.0 License

Investigate Raphael failed Chip Authentication

Current Behaviour

Use smartscanner to scan your passport/ID. If your passport/ID has Chip Auth feature, then Chip Authentication is performed and it should pass.

Background info: PH passports have no Chip Auth feature. Ken's passport have Chip Auth feature.

Expected Behaviour

In the Authentication section of smartscanner's result page, the Chip should have a checked marked if the passport/ID being scanned has Chip Auth feature. Otherwise, the Chip should not appear in cases where Chip Auth feature is not supported.

Steps to Reproduce the Problem

Raphael scanned his passport using smartscanner app
The page results here showed an x mark in Chip.

Context

The same smartscanner app is able to verify Ken's passport which has a Chip Auth feature as shown here

Version:

newlogic / smartscanner-core Goto Github PK