# cordova-plugin-cipherlab-rs30

**Repository Path**: 1428915751/cordova-plugin-cipherlab-rs30

## Basic Information

- **Project Name**: cordova-plugin-cipherlab-rs30
- **Description**: cordova-plugin-cipherlab-rs30
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-08-09
- **Last Updated**: 2021-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cordova-plugin-cipherlab-rs30
Apache Cordova Barcode Scanner Plugin for Cipherlab RS30

## Supported Platforms
Cipherlab RS30 Scanner
(BarcodeAPI_V1_0_35.jar)

## Installation

```
cordova plugin add https://github.com/mribbons/cordova-plugin-cipherlab-rs30
```

# Sample Code

Initialise the reader manager and filters using initialise:

```
cordova.plugins.CipherlabRS30CordovaPlugin.initialise()
```

Subscribe to scans by providing a callback method:
(This will receive scans triggered by hardware button or software trigger (below)
```
cordova.plugins.CipherlabRS30CordovaPlugin.setReceiveScanCallback(function (data) {
    append("scan received: " + data);
});
```

Request a scan on button click event:
```
document.getElementById("scan_button").addEventListener('click', function () {
	cordova.plugins.CipherlabRS30CordovaPlugin.requestScan(function () {
		// This callback doesn't need to do anything, the setReceiveScanCallback callback is what receives the scan data.
	});
});
```

Clean up resources when our app exits:
```
window.onbeforeunload = function () {
	cordova.plugins.CipherlabRS30CordovaPlugin.destroy(function () { });
}
```

Full sample (eg index.js):
```
(function () {
    "use strict";

    document.addEventListener('deviceready', onDeviceReady.bind(this), false);

    function append(message) {
        var node = document.createElement("p");
        node.appendChild(document.createTextNode(message));
        document.body.appendChild(node);
    }

    async function onDeviceReady() {
        // Handle the Cordova pause and resume events
        document.addEventListener( 'pause', onPause.bind( this ), false );
        document.addEventListener('resume', onResume.bind(this), false);

        document.getElementById("scan_button").addEventListener('click', function () {
            cordova.plugins.CipherlabRS30CordovaPlugin.requestScan(function () {
                // MDR 30/11/2015 - This is just a placeholder callback. Results will be handled by setReceiveScanCallback() parameter below
            });
        });
        
        // TODO: Cordova has been loaded. Perform any initialization that requires Cordova here.
        await cordova.plugins.CipherlabRS30CordovaPlugin.initialise(async function () {

            append("init done");
            
            cordova.plugins.CipherlabRS30CordovaPlugin.setReceiveScanCallback(function (data, type) {
                append("scan received: " + data + "(" + type + ")");
            });

            // or alternatively, if your data contains binary data you can get an array of integers:
            await cordova.plugins.CipherlabRS30CordovaPlugin.setEnableBinaryData(true);
            cordova.plugins.CipherlabRS30CordovaPlugin.setReceiveScanCallback(function (data, type, binary) { 
                // process binary array
            }
        });

        window.onbeforeunload = function () {
            cordova.plugins.CipherlabRS30CordovaPlugin.destroy(function () { });
        }

        append("setup done");
    };

    function onPause() {
        // TODO: This application has been suspended. Save application state here.
    };

    function onResume() {
        // TODO: This application has been reactivated. Restore application state here.
    };
} )();
```

## TODO

Receive barcode types as part of ReceiveScanCallback

Implement scanner configuration support (ReaderOutputConfiguration)