Barcode Scanner

barcode_scanner es un framework y no es útil por sí solo: instala un módulo de funcionalidad como barcode_stock para obtener operaciones reales.

Para crear tu propio módulo de funcionalidad, registra tus piezas en los registros del framework — no se requiere ningún cambio en el módulo base.

Registra una pantalla:

import {barcodeScreens} from "@barcode_scanner/js/registries";

barcodeScreens.add("my_screen", {component: MyScreen});

Registra un manejador de escaneos (se prueban en orden sequence; el primero que devuelva un valor verdadero consume el escaneo):

import {barcodeScanHandlers} from "@barcode_scanner/js/registries";

barcodeScanHandlers.add("my_handler", {
    async handle(barcode, parsed, {api, navigate, notify}) {
        // return true when handled
    },
}, {sequence: 50});

Registra un mosaico de la pantalla de inicio:

import {barcodeMenuTiles} from "@barcode_scanner/js/registries";

barcodeMenuTiles.add("my_tile", {
    label: "My Screen",
    icon: "fa-cube",
    action: ({navigate}) => navigate("my_screen"),
}, {sequence: 50});

Registra un analizador de códigos de barras (se prueban en orden sequence antes que el integrado EAN13; devuelve null para dejar que el siguiente analizador lo intente):

import {barcodeParsers} from "@barcode_scanner/js/registries";

barcodeParsers.add("my_symbology", (barcode) => {
    // return {type: "...", value: "<product code>", ...} or null
}, {sequence: 20});

Registra una tarea de inicio, para los datos que tu módulo necesita antes del primer escaneo (barcode_gs1 lee su nomenclatura de esta forma). Las tareas se esperan cuando se abre la aplicación; una que falla se registra y se omite:

import {barcodeStartupTasks} from "@barcode_scanner/js/registries";

barcodeStartupTasks.add("my_config", (env) => loadMyConfig(env.services.orm));

Lee escaneos en una pantalla con el hook useBarcodeHandler. El servicio de códigos de barras cuenta los componentes que lo hacen (readers.count, reactivo), de modo que una fuente de escaneo como un botón de cámara puede ofrecerse solo mientras una pantalla lee escaneos:

import {useBarcodeHandler} from "@barcode_scanner/js/hooks/use_barcode_handler.esm";

useBarcodeHandler({onScan: (barcode, parsed) => this.onScan(barcode, parsed)});