Genius Scan SDK
The scan flow also lets you create a scanner to extract structured data.
The scan flow is able to extract the following structured data:
This guide assumes that you have followed the simple integration guide.
To configure the scan flow for structured data, you need to configure the structured data type you are interested in extracting with the structuredData property on the ScanConfiguration object.
We also recommend that you turn the multiPage option off, generally you are only interested in scanning the structured data on the first page.
val configuration = ScanConfiguration()
// You can specify a single or multiple structured data to extract
configuration.structuredData = EnumSet.of(RECEIPT, READABLE_CODE)
configuration.multiPage = false
ScanFlow.scanWithConfiguration(activity, scanConfiguration)
// Fetch the result by overriding `onActivityResult`
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
data?.let {
val result = getScanResultFromActivityResult(data)
// Handle result
}
}
The recognized structured data is present in each scan of the result object:
// Handle result
result.scans?.first()?.structuredDataResult?.receipt?.let {
Log.d("ScanFlow", "Receipt detected. Merchant: ${it.merchant} Amount: ${it.amount}")
}
Using readable code structured data extraction, the scan flow retrieves the values encoded in readable codes on each page of a scanned document. Additionally, you will receive an image of the scanned document.
To enable this feature, specify READABLE_CODE in the structuredData field of the scan flow configuration. Additionally, you must specify the types of readable codes you want to extract using the structuredDataReadableCodeTypes property. For a complete list of supported code types, refer to the API documentation for ReadableCode.Type.
let configuration = GSKScanFlowConfiguration()
configuration.structuredData = EnumSet.of(READABLE_CODE)
configuration.structuredDataReadableCodeTypes = EnumSet.of(ReadableCode.Type.EAN13)
configuration.multiPage = false
// Launch the scan flow
ScanFlow.scanWithConfiguration(activity, scanConfiguration)
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
data?.let {
val result = getScanResultFromActivityResult(data)
Log.d("ScanFlow", "Detected readable codes: ${result.scans?.first()?.structuredDataResult?.readableCodes}")
}
}
© 2025 The Grizzly Labs. All rights reserved.