Adaptive Recognition Service Listener

Defined under the namespace Scandit.Datacapture.Barcode

AdaptiveRecognitionErrorReason

Added in version 8.7.0

Reason an adaptive recognition dispatch failed, delivered to an AdaptiveRecognitionServiceListener.

Unknown

Added in version 8.7.0

The dispatch failed for an unspecified reason, such as a network, backend, or pre-dispatch failure.

Timeout

Added in version 8.7.0

The dispatch did not complete within the allotted time.

AdaptiveRecognitionServiceListener

interface AdaptiveRecognitionServiceListener

Added in version 8.7.0

Interface for the outcome of adaptive recognition dispatches performed by a capture mode’s adaptive recognition service. Register it on the mode with BarcodeCapture.addAdaptiveRecognitionServiceListener(). Each callback receives the AdaptiveRecognitionFrameMetadata of the originating frame, so an asynchronously-delivered outcome can be correlated back to the frame that produced it.

All callbacks are optional, so an implementor overrides only the ones it needs.

For any given frame, its response or error callback always follows that frame’s dispatch-started callback.

Callbacks are delivered on the main thread and never run concurrently, so shared state needs no synchronization.

onAdaptiveRecognitionServiceDispatchStarted(frameData, frameMetadata)

onAdaptiveRecognitionServiceDispatchStarted?: (
        frameData: FrameData,
        frameMetadata: AdaptiveRecognitionFrameMetadata) => void

Added in version 8.7.0

Invoked when a frame is dispatched to the adaptive recognition service. The frame data is provided for the mode’s own use, for example to display the dispatched frame.

onAdaptiveRecognitionServiceResponse(response, frameMetadata)

onAdaptiveRecognitionServiceResponse?: (response: string,
        frameMetadata: AdaptiveRecognitionFrameMetadata) => void

Added in version 8.7.0

Invoked when an adaptive recognition dispatch completes successfully. The response is a JSON string whose shape is defined by the task’s response schema and is opaque to the SDK.

onAdaptiveRecognitionServiceError(reason, frameMetadata)

onAdaptiveRecognitionServiceError?: (reason: AdaptiveRecognitionErrorReason,
        frameMetadata: AdaptiveRecognitionFrameMetadata) => void

Added in version 8.7.0

Invoked when an adaptive recognition dispatch fails.

AdaptiveRecognitionFrameMetadata

interface AdaptiveRecognitionFrameMetadata

Added in version 8.7.0

Correlation metadata delivered with every AdaptiveRecognitionServiceListener callback. It ties an asynchronously-delivered adaptive recognition outcome back to the frame that produced the dispatch.

frameId

frameId: number

Added in version 8.7.0

Monotonic per-mode ordinal identifying the frame within a capture session.

barcodes

barcodes: Barcode[]

Added in version 8.7.0

The barcodes recognized in the dispatched frame.