Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

README.md

sf-extension-barcode

Twitter: @Smartface_io License

Installation

Smartface Barcode Extension can be installed via npm easily from our public npm repository. The installation is pretty easy via Smartface Cloud IDE.

(cd ~/workspace/scripts && npm i -S sf-extension-barcode)

How to use

  • Require extension with
const { BarcodeScanner } = require("sf-extension-barcode");
  • Create an instance of BarcodeScanner. Result will be handled in onResult callback.
var barcodeScanner = new BarcodeScanner({
    layout: myFlexLayout, // Required
    width: 200, // Required
    height: 200, // Required
    onResult: ({ barcode }) => {
        let { text, format } = barcode;
        alert(text);
        barcodeScanner.stopCamera();
        barcodeScanner.hide();
    }
});
  • Finally call show method with no parameters. Camera permissions must be granted before running show method.
barcodeScanner.show();

Barcode Format Type

Supported Formats:

Barcode.FormatType.AZTEC
Barcode.FormatType.CODABAR
Barcode.FormatType.CODE_39
Barcode.FormatType.CODE_93
Barcode.FormatType.CODE_128
Barcode.FormatType.DATA_MATRIX
Barcode.FormatType.EAN_8
Barcode.FormatType.EAN_13
Barcode.FormatType.ITF
Barcode.FormatType.MAXICODE
Barcode.FormatType.PDF_417
Barcode.FormatType.QR_CODE
Barcode.FormatType.RSS_14
Barcode.FormatType.RSS_EXPANDED
Barcode.FormatType.UPC_A
Barcode.FormatType.UPC_E
Barcode.FormatType.UPC_EAN_EXTENSION

Barcode format can be retrieved like this.

const { Barcode } = require("sf-extension-barcode");
barcodeScanner.onResult = ({ barcode }) => {
    if (barcode.format === Barcode.FormatType.QR_CODE) {
        console.log("This is a qr code");
    }
};

Notes

  • If there is a need for closing the scanner, it needs to be implemented by the developer. For Android onBackButtonPressed needs to be implemented.
  • Scanner does not hide automatically when scanned
  • A scanner instance can be used only for once per image scan. For each scan action, a new BarcodeScanner instance should be created and used
  • For Android, if there is an active textbox (keyboard is visible), developer needs to close the keyboard before showing the scanner.
  • It is advised to call show method with a timeout value for rendering performance.

Permissions

For iOS, you have to add camera permission to Info.plist.

<key>NSCameraUsageDescription</key>
<string>${PRODUCT_NAME} Camera Usage</string>

For Android, you have to add camera permission to AndroidManifest.xml.

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />

Sample

There are some examples in sample folder. You can use them.

Credits

This barcode library is based on:

Need Help?

Please submit an issue on GitHub and provide information about your problem.

Support & Documentation & Useful Links

Code of Conduct

We are committed to making participation in this project a harassment-free experience for everyone, regardless of the level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, religion, or nationality. Please read and follow our Code of Conduct.

License

This project is licensed under the terms of the MIT license. See the LICENSE file. Within the scope of this license, all modifications to the source code, regardless of the fact that it is used commercially or not, shall be committed as a contribution back to this repository.

About

Barcode Extension for Smartface Native Framework

Topics

Resources

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  
You can’t perform that action at this time.