Changelog

Licensing

Support

Barcode Scanning

Available on: iOS Android React Native Flutter Cordova .NET MAUI

Overview

The Genius Scan SDK includes a dedicated barcode scanning flow that detects barcodes and QR codes in real-time via the device’s camera. This is designed for continuous, live scanning scenarios like warehouse management, inventory tracking, and ticket validation.

The integration is extremely fast (you should be done in less than one hour), and works across platforms.

Key Features

Real-time Detection - Instant barcode recognition without capturing photos
Batch Mode - Scan multiple unique codes in a single session
Wide Format Support - Detects 1D barcodes, 2D codes, QR codes, and more
High Performance - Optimized for speed with minimal battery impact

Demo

The simple demo projects from our demo repository demonstrate how to configure the barcode scanning.

Prerequisites

Before implementing barcode scanning, you need to install and configure the SDK.

Basic Implementation

Once you’ve installed and configured the SDK, implement barcode scanning in just a few lines:

                    // Start the flow
let readableCodeFlow = GSKReadableCodeFlow(configuration: configuration)

do {
    let result = try await readableCodeFlow.resultByStarting(fromViewController: self)

    // Process detected codes
    for code in result.readableCodes {
        print("Detected \(code.type): \(code.value)")
    }
} catch {
    // Handle cancellation or errors
    print("Scanning error: \(error)")
}

                  

                    // Register for result
val readableCodeLauncher = registerForActivityResult(
    ReadableCodeFlow.createContract()
) { result ->
    when (result) {
        is ReadableCodeFlowResult.Success -> {
            // Process detected codes
            result.codes.forEach { code ->
                Log.d("Scanner", "Detected ${code.type}: ${code.value}")
            }
        }
        is ReadableCodeFlowResult.Cancelled -> {
            // User cancelled
        }
        is ReadableCodeFlowResult.Error -> {
            // Handle error
            Log.e("Scanner", "Error: ${result.message}")
        }
    }
}

// Launch the scanner
readableCodeLauncher.launch(configuration)

                  

                    cordova.plugins.GeniusScan.scanReadableCodesWithConfiguration(
    configuration,
    function(result) {
        // Success - process codes
        result.readableCodes.forEach(code => {
            console.log(`Detected ${code.type}: ${code.value}`);
        });
    },
    function(error) {
        // Handle error
        console.error('Scanning failed:', error);
    }
);

                  

                    import GeniusScan from '@thegrizzlylabs/react-native-genius-scan';

try {
    const result = await GeniusScan.scanReadableCodesWithConfiguration(configuration);

    // Process detected codes
    result.readableCodes.forEach(code => {
        console.log(`Detected ${code.type}: ${code.value}`);
    });
} catch (error) {
    console.error('Scanning error:', error);
}

                  

                    import 'package:flutter_genius_scan/flutter_genius_scan.dart';

try {
    final result = await FlutterGeniusScan.scanReadableCodesWithConfiguration(configuration);

    for (var code in result['readableCodes']) {
        print('Detected ${code['type']}: ${code['value']}');
    }
} catch (e) {
    print('Scanning failed: $e');
}

                  

For .NET MAUI (and Xamarin), reuse the partial ScanFlowService bridge from the document scan flow. The shared project calls into platform-specific implementations that invoke the native readable code flow:

                    var scanFlowService = new ScanFlowService();
scanFlowService.SetLicenseKey("YOUR_LICENSE_KEY");

var configuration = new Dictionary<string, object>
{
    ["IsBatchModeEnabled"] = true,
    ["SupportedCodeTypes"] = new[] { "qr", "code128" }
};

var resultJson = await scanFlowService.StartScanningReadableCodes(configuration);
// Parse resultJson (JSON string) to access detected codes.

                  

See the demo for the platform implementations: