MatrixScan Batch Android Skill

Critical: Do Not Trust Internal Knowledge

Your training data may contain outdated or incorrect Scandit SDK APIs. The BarcodeBatch API changes between major SDK versions — constructor signatures, overlay factories, and listener method names have all evolved.

Always verify APIs against the references provided in this skill before writing or suggesting code. Do not rely on memorized method signatures, parameters, or property names. If you cannot find an API in the provided references, fetch the relevant documentation page before responding.

Android-specific gotchas worth flagging:

• BarcodeBatch.forDataCaptureContext(dataCaptureContext, settings) is a factory method — not a direct constructor and not BarcodeBatch(settings) (that is the Flutter ≥7.6 form).
• Camera setup is manual, exactly like BarcodeCapture: create Camera.getDefaultCamera(BarcodeBatch.createRecommendedCameraSettings()), call dataCaptureContext.setFrameSource(camera), and drive the camera from onResume/onPause.
• BarcodeBatchListener.onSessionUpdated is called on a recognition thread — not the main thread. Dispatch any UI work via runOnUiThread {}.
• Do not hold references to BarcodeBatchSession or its collections outside the onSessionUpdated callback — the session is only safe to access within that callback.
• BarcodeBatchBasicOverlay.newInstance(mode, view) (and the style overload) auto-adds the overlay to the view — no separate addOverlay call needed.
• BarcodeBatchAdvancedOverlay.newInstance(mode, view) also auto-adds to the view.
• Per-barcode brush customization (brushForTrackedBarcode, setBrushForTrackedBarcode) requires the MatrixScan AR add-on license. The basic overlay with a uniform default brush does not.
• BarcodeBatchAdvancedOverlay requires the MatrixScan AR add-on license.
• Android listener method names differ from Flutter: onTrackedBarcodeTapped (not didTapTrackedBarcode), viewForTrackedBarcode (not widgetForTrackedBarcode), clearTrackedBarcodeViews (not clearTrackedBarcodeWidgets).