Skip to content

A Cordova barcode scanning plugin based on the Google Mobile Vision library for iOS & Android.

License

Notifications You must be signed in to change notification settings

iconum-nl/cordova-plugin-mlkit-barcode-scanner

 
 

Repository files navigation

📷 cordova-plugin-mlkit-barcode-scanner

Purpose of this Project

The purpose of this project is to provide a barcode scanner utilizing the Google ML Kit Vision library for the Cordova framework on iOS and Android. The MLKit library is incredibly performant and fast in comparison to any other barcode reader that I have used that are free.

Plugin Dependencies

Dependency Version Info
cordova-android >=8.0.0
cordova-ios >=4.5.0
cordova-plugin-androidx ^3.0.0 If cordova-android <= 9.0.0
cordova-plugin-androidx-adapter ^1.1.3

Prerequisites

If your cordova-android version is below 9.0.0, you have to install cordova-plugin-androidx first beforce installing this plugin. Execute this command in your terminal:

cordova plugin add cordova-plugin-androidx

Installation

Run this command in your project root.

cordova plugin add cordova-plugin-mlkit-barcode-scanner

Supported Platforms

  • Android
  • iOS/iPadOS

Barcode Support

1d formats Android iOS
Codabar
Code 39
Code 93
Code 128
EAN-8.
EAN-13
ITF
MSI
RSS Expanded
RSS-14
UPC-A
UPC-E
2d formats Android iOS
Aztec
Codablock
Data Matrix
MaxiCode
PDF417
QR Code

ℹ️ Note that this API does not recognize barcodes in these forms:

  • 1D Barcodes with only one character
  • Barcodes in ITF format with fewer than six characters
  • Barcodes encoded with FNC2, FNC3 or FNC4
  • QR codes generated in the ECI mode

Usage

To use the plugin simply call cordova.plugins.mlkit.barcodeScanner.scan(options, sucessCallback, failureCallback). See the sample below.

cordova.plugins.mlkit.barcodeScanner.scan(options, (error, result) => {
  if (error) {
    // Error handling
  }

  // Do something with the data
  alert(result);
});

Plugin Options

The default options are shown below. Note that the detectorSize value must be a float. If the values are greater than 1 then they will not be visible on the screen. Use them as decimal percentages to determine how large you want the scan area to be. All values are optional.

const defaultOptions = {
  types: {
    Code128: true,
    Code39: true,
    Code93: true,
    CodaBar: true,
    DataMatrix: true,
    EAN13: true,
    EAN8: true,
    ITF: true,
    QRCode: true,
    UPCA: true,
    UPCE: true,
    PDF417: true,
    Aztec: true
  },
  detectorSize: 0.6
}

Output/Return value

result: {
  cancelled: boolean;
  text: string;
  format: string | undefined;
  type: string | undefined;
}

Run the test app

Install cordova

npm i -g cordova

Go to test app

cd test/scan-test-app

Install node modules

npm i

Prepare Cordova

cordova platform add android && cordova plugin add ../../ --link --force

Build and run the project Android

cordova build android && cordova run android

and iOS

cordova build ios && cordova run ios

To-dos (2021-May)

  • Android: Migrate from deprecatd Camera API to CameraX
  • Android: Get Viewfinder (detectorSize) to work
  • Android: Test functionality with Android 5.1 (API 22)

About

A Cordova barcode scanning plugin based on the Google Mobile Vision library for iOS & Android.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 51.6%
  • Objective-C 43.2%
  • JavaScript 5.2%