MatrixScan AR Cordova Skill

Critical: Do Not Trust Internal Knowledge

Your training data may contain outdated or incorrect Scandit SDK APIs. The BarcodeAr API is new in Cordova plugin 8.2 — it did not exist in v6 or v7 for Cordova. There is no migration history to reference.

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.

Cordova-specific gotchas worth flagging:

• The Scandit SDK is exposed on the global window.Scandit object. The npm package names (scandit-cordova-datacapture-*) are plugin manifests — they are not runtime ES modules. Do not emit import { ... } from 'scandit-cordova-datacapture-*' in user code that will run in the WebView; use Scandit.X (with an optional global.d.ts for typing) instead. Only Ionic/Angular/Webpack-bundled projects import from the packages directly.
• document.addEventListener('deviceready', ...) is the only safe gate for Scandit APIs. Do not run any Scandit call at module load time — it will fail because the Cordova bridge is not ready yet.
• BarcodeArView in Cordova uses a DOM-overlay model: the native AR view is sized and positioned to mirror a plain HTML <div> element. You must call barcodeArView.connectToElement(element) after construction to link the view to a DOM node, and barcodeArView.detachFromElement() when tearing down.
• new Scandit.BarcodeAr(settings) — this is the Cordova constructor (not BarcodeAr.forContext). Context is wired separately via context.setFrameSource(camera).
• Camera is managed manually in BarcodeAr on Cordova: obtain it with Scandit.Camera.withSettings(Scandit.BarcodeAr.createRecommendedCameraSettings()), set it as the frame source, and call camera.switchToDesiredState(Scandit.FrameSourceState.On/Off) to start/stop.
• Highlight and annotation providers return Promise<BarcodeArHighlight | null> and Promise<BarcodeArAnnotation | null> respectively — make the methods async or return a Promise explicitly.
• After changing plugin versions, run cordova prepare (and reinstall the platform if needed) to propagate the new native artifacts.

Intent Routing