ProGlove Documentation

To trigger custom feedback, use the API pgManager.triggerFeedback. The function takes a predefined feedback ID (PgPredefinedFeedback) wrapped in a PgCommand and an implementation of the IPgFeedbackCallback callback as arguments.

After feedback is successfully triggered on the scanner (or in case of any errors) the IPgFeedbackCallback is called with the relevant information.

The PgPredefinedFeedback ID defines the feedback sequence to be played. The convenience function PgPredefinedFeedback.toComamnd() used here to wrap PgPredefinedFeedback optionally takes a PgCommandParams object, which gives additional control over how the command is executed.

For now we only support the replaceQueue flag here, which, if set to true, cancels all the commands currently in the queue and adds itself as the first element.

To learn more, see Command queueing in Insight Mobile.

 val feedbackId = PgPredefinedFeedback.SPECIAL_1
 pgManager.triggerFeedback(feedbackId.toCommand(), object : IPgFeedbackCallback {
    override fun onSuccess() {
    // everything worked
    }

    override fun onError(error: PgError) {
    // handle the error
    }
})

Possible feedback IDs are:

To trigger custom feedback, use the API pgManager.triggerFeedback. The function takes a predefined feedback ID (PgPredefinedFeedback) wrapped in a PgCommand and an implementation of the IPgFeedbackCallback callback as arguments.

After feedback is successfully triggered on the scanner (or in case of any errors) the IPgFeedbackCallback is called with the relevant information.

The PgPredefinedFeedback ID defines the feedback sequence to be played. The convenience function PgPredefinedFeedback.toComamnd() used here to wrap PgPredefinedFeedback optionally takes a PgCommandParams object, which gives additional control over how the command is executed.

For now we only support the replaceQueue flag here, which, if set to true, cancels all the commands currently in the queue and adds itself as the first element.

To learn more, see Command queueing in Insight Mobile.

 val feedbackId = PgPredefinedFeedback.SPECIAL_1
 pgManager.triggerFeedback(feedbackId.toCommand(), object : IPgFeedbackCallback {
    override fun onSuccess() {
    // everything worked
    }

    override fun onError(error: PgError) {
    // handle the error
    }
})

Possible feedback IDs are:

To trigger a feedback sequence on the connected scanner, send and Intent with the following:

Currently, Insight Mobile supports the the following ffeedback sequences:

val intent = Intent()
intent.setAction("com.proglove.api.PLAY_FEEDBACK")
intent.putExtra("com.proglove.api.extra.FEEDBACK_SEQUENCE_ID", 1)
sendBroadcast(intent)

By default, the scanner returns positive feedback when a barcode transmission is started. The default scan feedback (green LED blinking twice) can be disabled/enabled by calling using SDK API call or sending an Intent.

To disable the default scan feedback using SDK, use the API call pgManager.setScannerConfig. The call takes a PgScannerConfig object and an IPgConfigCallback callback object as parameter.

You can use the PgScannerConfig object to change the scanner’s bahavior - in this case, to disable the default scanning feedback (code below in KOTLIN).

To disable the default scan feedback using Intent, send an Intent with the action com.proglove.api.SET_CONFIG and a bundle-typed extra com.proglove.api.extra.CONFIG_BUNDLE containing the scanner’s configuration.

This setting is lost when disconnected.

val config = PgScannerConfig(isDefaultScanAckEnabled = false)

pgManager.setScannerConfig(config, object : IPgConfigCallback {
    override fun onScannerConfigSuccess(config: PgScannerConfig) {
        // everything worked
    }

    override fun onError(error: PgError) {
        // handle the error
    }
})

val intent = Intent()
intent.action = "com.proglove.api.SET_CONFIG"
val bundle = Bundle()
bundle.putBoolean("com.proglove.api.extra.config.DEFAULT_SCAN_FEEDBACK_ENABLED", false)
intent.putExtra("com.proglove.api.extra.CONFIG_BUNDLE", bundle)

sendBroadcast(intent)` 

Since there is no callback for Intent, it is impossible to react upon a finished sequence to start another one right away.

Intent API allows you to play multiple sequences with one Intent.

If an intArray is provided as extra com.proglove.api.extra.FEEDBACK_SEQUENCES_IN_ORDER, the feedback sequences in that array are conducted in that order one after another.

val intent = Intent()
intent.setAction("com.proglove.api.PLAY_FEEDBACK")
intent.putExtra("com.proglove.api.extra.FEEDBACK_SEQUENCES_IN_ORDER", [4, 4, 4])
sendBroadcast(intent)

When multiple sequences are provided, the extra com.proglove.api.extra.FEEDBACK_SEQUENCE_ID is ignored.

Besides the above structure, you can also provide a Boolean valued extra in com.proglove.api.extra.REPLACE_QUEUE, which, if set to true, makes this command cancel all currently waiting commands and executes this command as soon as possible.

To learn more, see Command queueing in Insight Mobile.