Go to file
2016-04-13 10:57:20 +08:00
android Pull Request cleanup (#16): Reinstated old interval autofocus bahaviour on Android API Level < 14 (plus minor blank line formatting) 2015-04-19 23:58:45 +08:00
ios wait until viewController is dismissed before callback, fixes #47 2016-02-17 11:00:47 +11:00
www Fix incorrect upperlower-casing of zbar.js file (pt2 of 2) 2015-02-16 19:01:57 +08:00
.gitignore .gitignore for Mac OS X files 2014-09-11 15:45:27 +08:00
LICENSE.md Filled in copyright owner info 2016-04-13 10:44:54 +08:00
package.json Renamed plugin to cordova-plugin-cszbar + added NPM package.json 2016-04-13 10:54:40 +08:00
plugin.xml Renamed plugin to cordova-plugin-cszbar + added NPM package.json 2016-04-13 10:54:40 +08:00
README.md Updated plugin installation instructions with new plugin ID 2016-04-13 10:57:20 +08:00

This repository is looking for a maintainer! If you believe you are the right person, please leave a comment!

ZBar Barcode Scanner Plugin

This plugin integrates with the ZBar library, exposing a JavaScript interface for scanning barcodes (QR, 2D, etc).

Installation

cordova plugin add cordova-plugin-cszbar

API

Scan barcode

cloudSky.zBar.scan(params, onSuccess, onFailure)

Arguments:

  • params: Optional parameters:

    {
        text_title: "OPTIONAL Title Text - default = 'Scan QR Code'", // Android only
        text_instructions: "OPTIONAL Instruction Text - default = 'Please point your camera at the QR code.'", // Android only
        camera: "front" || "back" // defaults to "back"
        flash: "on" || "off" || "auto" // defaults to "auto". See Quirks
        drawSight: true || false //defaults to true, create a red sight/line in the center of the scanner view.
    }
    
  • onSuccess: function (s) {...} Callback for successful scan.

  • onFailure: function (s) {...} Callback for cancelled scan or error.

Return:

  • success('scanned bar code') Successful scan with value of scanned code
  • error('cancelled') If user cancelled the scan (with back button etc)
  • error('misc error message') Misc failure

Status:

  • Android: DONE
  • iOS: DONE

Quirks:

  • Android: On Android API Level < 14, flash "on" may cause the flash to alternate between on and off at about a half second/one second interval, instead of making it stay on...

LICENSE Apache 2.0

This plugin is released under the Apache 2.0 license, but the ZBar library on which it depends (and which is distribute with this plugin) is under the LGPL license (2.1).

Thanks

Thank you to @PaoloMessina and @nickgerman for code contributions.