Kotlin

Multiple Barcode Scanning

Multiple Barcode Scanning is a mode in the Vision SDK that allows you to scan and detect multiple barcodes within the camera frame simultaneously. This is useful in scenarios where several barcodes are present in a single image or view, and you want to capture all of them in one go.

Unlike single barcode scanning, this mode does not restrict detection to just one barcode. Instead, it returns an array of all valid barcodes detected within the scanning region, improving efficiency for batch processing or document scanning use cases.

⚙️ Configure the SDK

To enable multiple barcode scanning, you need to configure the Vision SDK using the configure method:

        visionCameraView.configure(
    detectionMode: DetectionMode,
    scanningMode: ScanningMode,
    isMultipleScanEnabled = true
)

Select the camera lens you want to use for barcode scanning:

        visionCameraView.setCameraSettings(
  CameraSettings(cameraLensFace: CameraLensFace.Back)
)

🤖 Auto Mode Barcode Scanning

For automatic barcode capture, set the scanningMode to ScanningMode.Auto:

        scanningMode = ScanningMode.Auto

Configuration example:

        visionCameraView.configure(
    detectionMode: DetectionMode,
    scanningMode = ScanningMode.Auto,
    isMultipleScanEnabled = true
)

✋ Manual Mode Barcode Scanning

For manual barcode capture, set the scanningMode to ScanningMode.Manual:

        scanningMode = ScanningMode.Manual

Configuration example:

        visionCameraView.configure(
    detectionMode: DetectionMode,
    scanningMode = ScanningMode.Manual,
    isMultipleScanEnabled = true
)

Afterwards, when you want to capture, call the following method:

        visionCameraView.capture()

📦 Callback Method for Barcode Values

When a barcode is successfully scanned, the following callback method is called:

        private fun startMultipleScanning() {

    visionCameraView.setScannerCallback(object : ScannerCallbackAdapter() {

      override fun onScanResult(barcodeList: List<ScannedCodeResult>) {

      }
    })

    visionCameraView.startCamera()
}

Note that, once onScanResult or onImageCaptured callbacks are called, VisionSDK will stop analyzing camera feed for text or barcodes/QR codes. This is to prevent extra processing and battery consumption. When client wants to start analyzing camera feed again, after consuming the results of previous scan, client needs to call the following function:

        visionCameraView.rescan()

❗️Error Handling Callback

If an error occurs during the barcode scanning process, the following callback method will be triggered. You can implement this to handle any failures during scanning, gracefully.

        private fun startMultipleScanning() {

    visionCameraView.setScannerCallback(object : ScannerCallbackAdapter() {

      override fun onFailure(exception: VisionSDKException) {

      }
    })

    visionCameraView.startCamera()
}

Use this method to log errors, display messages to the user, or perform recovery actions when scanning fails.

🧾 Barcode Object Structure

The ScannedCodeResult object returned in the callback contains the following properties:

        data class ScannedCodeResult(
    val scannedCode: String,
    val symbology: BarcodeSymbology, // UPC, Code 128 etc
    val gs1ExtractedInfo: Map<String, String>? = null
)

🧭 Detection Indicators

To receive detection indicators (without actual values), implement the following callback method:

        private fun startScanning() {

    visionCameraView.setScannerCallback(object : ScannerCallbackAdapter() {

      override fun onIndications(barcodeDetected: Boolean, qrCodeDetected: Boolean, textDetected: Boolean, documentDetected: Boolean) {

      }
    })

    visionCameraView.startCamera()
}

textDetected: Indicates presence of text
barcodeDetected: Indicates presence of a barcode
qrCodeDetected: Indicates presence of a QR code
documentDetected: Indicates presence of a document

🔘 Enable Detection Indicators

You can toggle detection indicators as follows:

        visionCameraView.setObjectDetectionConfiguration(
   ObjectDetectionConfiguration(
      isTextIndicationOn = true,
      isBarcodeOrQRCodeIndicationOn = true,
      isDocumentIndicationOn = true,
      secondsToWaitBeforeDocumentCapture = 3
   )
)

🧪 Sample Code

To start scanning for barcodes, QR codes, text or documents, use the startCamera method. See the code below for example:

        private fun startMultipleScanning() {

    visionCameraView.configure(
      detectionMode = DetectionMode.BarcodeOrQRCode,
      scanningMode = ScanningMode.Auto,
      isMultipleScanEnabled = true
    )

    visionCameraView.setScannerCallback(object : ScannerCallbackAdapter() {

      fun onIndications(barcodeDetected: Boolean, qrCodeDetected: Boolean, textDetected: Boolean, documentDetected: Boolean) {

      }

      fun onCodesScanned(barcodeList: List<ScannedCodeResult>) {

      }

      fun onFailure(exception: VisionSDKException) {

      }
    })

    visionCameraView.startCamera()
}

Multiple Barcode Scanning

# ⚙️ Configure the SDK

# 🤖 Auto Mode Barcode Scanning

# ✋ Manual Mode Barcode Scanning

# 📦 Callback Method for Barcode Values

# ❗️Error Handling Callback

# 🧾 Barcode Object Structure

# 🧭 Detection Indicators

# 🔘 Enable Detection Indicators

# 🧪 Sample Code

On this page