1.2.2 • Published 4 years ago

cordova-plugin-ios-simple-scanner v1.2.2

Weekly downloads
11
License
MIT
Repository
github
Last release
4 years ago

cordova-plugin-ios-simple-scanner npm version

Simple iOS Barcode Scanner for Cordova.

  • PDF417 Supported!
  • QR Supported!
  • Flash toggle button
  • Cancel scan button
  • Optional onscreen guide box (with 'Scanning...' text)

How To Use

Install the plugin using:

cordova plugin add cordova-plugin-ios-simple-scanner

//or

cordova plugin add https://github.com/DavidBriglio/cordova-plugin-ios-simple-scanner

Call the scanBarcode method with the following parameters:

ParameterTypeDescription
orientationStringThe locked orientation to show the scanner in. Can be: "portrait", "landscapeLeft", "landscapeRight", "portraitUpsideDown".
show guideBooleanIf set to true, the guide box and 'Scanning..' label will be shown.
success callbackFunctionMethod to handle successfully scanning a barcode. This method will be passed an object with two string attributes: "format" - Type of the barcode scanned, "data" - all data contained within the barcode (string).
error callbackFunctionMethod to handle all errors / cancelling the scanner. A status message will be passed in.

Example:

var successCallback = function(result) {
    console.log("Format Found: " + result.format + ", Data: " + result.data);
};

var errorCallback = function(error) {
    console.log("Error Reading Barcode: " + error);
};

// Scan as landscapeLeft, showing the box guide, with success and error callbacks
cordova.plugins.ios.simpleScanner.scanBarcode("landscapeLeft", true, successCallback, errorCallback);

// Or you can use promise logic:
cordova.plugins.ios.simpleScanner.scanBarcode("landscapeRight", true)
    .then(result => {
        console.log("Format Found: " + result.format + ", Data: " + result.data);
    })
    .catch(error => {
        console.log("Error Reading Barcode: " + error);
    });

Supported Formats

  • PDF417
  • QR

Known Issues

If the scan method is called while the scanner is already running, the scanner will freeze. If you are planning on opening another instance of the scanner, make sure the current one is not scanning.

Since this plugin creates a view to show the user, there will be a warning about time taken to run the plugin that will suggest running in a background thread.

Images

All icon images were taken and modified from ionicons (100% Free and Open Source - MIT).

License

MIT License, please look at the LICENSE file.