barcode_scanner_plugin 0.1.3

A powerful Flutter plugin for dual-mode barcode scanning. Supports dedicated PDA hardware via Broadcast Intents and smartphone cameras using CameraX and Google ML Kit.

barcode_scanner_plugin

A powerful Flutter plugin for barcode scanning, supporting both dedicated PDA hardware scanners (via Android Broadcast Intents) and smartphone cameras (via Google ML Kit).

Features

• Dual-Mode Scanning:
  • Hardware PDA: Real-time stream from integrated scanners (Zebra, Honeywell, Sunmi, etc.) using EventChannel.
  • Camera Scan: High-performance camera scanning using CameraX and Google ML Kit for regular smartphones.
• Stream-based API: Simple barcodeStream for background hardware scanning.
• Easy Integration: Optimized for Android handheld terminals and mobile devices.

Installation

Add barcode_scanner_plugin to your pubspec.yaml file:

dependencies:
  barcode_scanner_plugin:
    git:
      url: https://github.com/Hung2003s/barcode_scanner_plugin.git

Usage

1. Import the package

import 'package:barcode_scanner_plugin/barcode_scanner_plugin.dart';

2. Initialize the plugin

final _barcodeScanner = BarcodeScannerPlugin();

3. Hardware PDA Scanning (Background Stream)

Ideal for devices with a physical scan button. It listens for Broadcast Intents in the background.

StreamBuilder<String>(
  stream: _barcodeScanner.barcodeStream,
  builder: (context, snapshot) {
    if (snapshot.hasData) {
      return Text('PDA Scanned: ${snapshot.data}');
    }
    return Text('Waiting for hardware scan...');
  },
)

4. Camera Scanning (Interactive)

Use this for devices without a hardware scanner or as a fallback. It opens a camera preview.

final result = await _barcodeScanner.startCameraScan();
if (result != null) {
  print('Camera Scanned: $result');
}

Android Configuration

Permissions

The plugin requires Camera permission for the camera scanning feature. Add this to your AndroidManifest.xml:

<uses-permission android:name="android.permission.CAMERA" />

Hardware Scanner Setup

Ensure your PDA device is configured to send Broadcast Intents. Common settings:

• Action: com.pda.scan.ACTION (or similar, depending on your device vendor)
• Data Key: Usually data or value.

Example

import 'package:flutter/material.dart';
import 'package:barcode_scanner_plugin/barcode_scanner_plugin.dart';

void main() => runApp(const MyApp());

class _MyAppState extends State<MyApp> {
  final _plugin = BarcodeScannerPlugin();
  String _camResult = 'None';

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Dual Barcode Scanner')),
      body: Column(
        children: [
          // Hardware Scanner Listener
          StreamBuilder<String>(
            stream: _plugin.barcodeStream,
            builder: (context, snapshot) => Text('PDA: ${snapshot.data ?? "Waiting..."}'),
          ),
          
          const Divider(),
          
          // Camera Scanner Button
          Text('Camera: $_camResult'),
          ElevatedButton(
            onPressed: () async {
              final code = await _plugin.startCameraScan();
              if (code != null) setState(() => _camResult = code);
            },
            child: const Text('Open Camera Scanner'),
          ),
        ],
      ),
    );
  }
}

License

This project is licensed under the MIT License - see the LICENSE file for details.