ProGlove Documentation

To download the AAR:

To integrate a scanner, you need somewhere to hold a reference to it.

If you need access to the scanner in multiple places of your application, the SDK can be instantiated in the Application Android Object. However, any other Context object will work as well (Activity or Service).

In the onCreate, instantiate the Scanner Manager and connect it to the Insight Mobile app.

val pgManager: PgManager = PgManager()

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate()
    val result = pgManager.ensureConnectionToService(this.applicationContext)
}

Check the return value (boolean) to see if the service binding worked. If the correct version of Insight Mobile is installed on your device, you will get a positive response.

After this, access the pgManager variable to use the SDK.

The connection to the SDK Service is fast and you should not encounter any issues by proceeding with the pairing process right away.

But it is still asynchronous, so you may want to register for callbacks of the Service connection.

Before calling pgManager.connect(...), register your implementation of the IServiceOutput interface (In this case this).

Also, make sure to unsubscribe from these events. onCreate and onDestroy are great for that.

override fun onCreate(savedInstanceState: Bundle?) {

    //...
    pgManager.subscribeToServiceEvents(this)
}

override fun onDestroy() {
    super.onDestroy()

    pgManager.unsubscribeFromServiceEvents(this)
}

To receive new barcode scan data, call the pgManager.subscribeToScans() function and implement the IScannerOutput interface.

For example, in the same onCreate of our sample app, we subscribe to the scanner info. And we unsubscribe in the onDestroy function.

override fun onCreate(savedInstanceState: Bundle?) {

     //...

     pgManager.subscribeToScans(this)

     //...
}

override fun onDestroy() {
     super.onDestroy()
     pgManager.unsubscribeFromScans(this)
}

To do this, our Activity needs to implement the IScannerOutput interface:

//
// -- IScannerOutput --
//

override fun onBarcodeScanned(barcodeScanResults: BarcodeScanResults) {
      // the scanner input will come on background threads, make sure to execute this on the UI Thread
    runOnUiThread {
        if(barcodeScanResults.symbology.isNotEmpty()) {
            Toast.makeText(this, "Got barcode: ${barcodeScanResults.barcodeContent} with symbology: ${barcodeScanResults.symbology}", Toast.LENGTH_LONG).show()
            // do some custom logic here to react on received barcodes and symbology
        } else {
            Toast.makeText(this, "Got barcode: ${barcodeScanResults.barcodeContent}", Toast.LENGTH_LONG).show()
            // not every scanner currently has the ability to send the barcode symbology
        }
    }
}

override fun onScannerConnected() {
        // let the user know that the scanner is connected
}

override fun onScannerDisconnected() {
     // Inform the user that the scanner has been disconnected
}

The IScannerOutput callback and PgManager provide you with several methods for tracking the scanner state.

As shown above, the IScannerOutput interface will be called whenever a scanner connects or disconnects.

You can also query the PgManager methods.

To disconnect, call the PgManager.disconnectScanner() method.

To start the pairing process, call startPairing() on your PgManager reference. The Insight Mobile app will take over and show the paring QR code.

After your device was paired with a scanner or the process was canceled by the user, your Activity will be brought back to the foreground. Your registered IScannerOutput implementations will be called according to the updated scanner state.

To help with debugging, the PgManager can be injected with a java.util.Logger object that will receive all log information.

    private val pgManager = PgManager(logger)

The Sample apps demonstrate using the SDK to display the last scanned value in a text field. Use the SDK Sample app to see how to implement the Scanner API.

For the list of supported Symbologies, see Symbology Settings.

To integrate Insight Mobile with a Xamarin app, see the official Microsoft documentation and use the Intent API integration.

Android 11 introduced some changes related to package visibility that affect apps which target Android 11.

For further description of the changes, see Package visibility filtering on Android.