52 lines
1.6 KiB
Markdown
52 lines
1.6 KiB
Markdown
# ZBar Barcode Scanner Plugin
|
|
|
|
This plugin integrates with the [ZBar](http://zbar.sourceforge.net/) library,
|
|
exposing a JavaScript interface for scanning barcodes (QR, 2D, etc).
|
|
|
|
## Installation
|
|
|
|
cordova plugins install org.cloudsky.cordovaplugins.zbar
|
|
|
|
## License
|
|
|
|
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).
|
|
|
|
## API
|
|
|
|
### Scan barcode
|
|
|
|
cloudSky.zBar.scan(params, onSuccess, onFailure)
|
|
|
|
Arguments:
|
|
|
|
- **params**: Optional parameters:
|
|
|
|
```javascript
|
|
{
|
|
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__: 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...
|