React Native

Dashboard 知识库 React Native

Integrate the cmbSDK React-Native Module in your App

通过NPM下载插件

$ npm install cmbsdk-react-native --save

主要是自动安装

$ react-native link cmbsdk-react-native

Import the component in your react-native app by adding this

JavaScript

从'cmbsdk-reacter-native'导入{cmbreader，cmb};

You can access all of the API methods through thecmbconstant, and all of the enums and constants are available in the CMBReader class.

Before continuing, download the cmbSDK React-Native zip file from our download section, and see the API reference.

Download page:https://cmbdn.cognex.com/download

API reference:https://cmbdn.cognex.com/knowledge/react-nat/rct-api-metho

Integrating cmbSDK iOS React-Native Module

Make sure you have downloaded the cmbSDK React-Native zip archive from our download page. From the downloaded zip file, open the iOS directory.

1. If you are using the mobile device's built in camera, do the same with the "MWBScannerImages.xcassets" file located in the iOS/Resources directory.

2. In your projects info.plist file you need to add a key depending on the readerDevice type that you are using.

If you are using the device camera for scanning, add the "NSCameraUsageDescription" key with a description on how your app will use the camera (for example: Scanning barcodes").
如果您使用的是MX-1XXX设备，则需要使用项目“ com.cognex.dmcc”添加“支持的外部附件协议”数组。您还需要关注此GUIDE在将MX-1XXX启用应用程序发布到App Store之前。这仅是使用MX移动终端扫描所必需的。

就是这样。您应该能够使用CMBSDK React-Native模块工作来运行应用程序。

集成CMBSDK Android反应本模块

Make sure you have downloaded the cmbSDK React-Native zip archive from our download page. From the downloaded zip file, open the Android/cmbsdk-android-binary directory.

1. Open theyourRNApp/android/app/directory, create a new folder named "libs" if there isn't one already, and open it. Place the file "cmbsdklib-release.aar" inside the libs folder. This aar can be found in "Android/cmbsdk-android-binary" from the downloaded zip file

2. Open the app build.gradle located inyourRNApp/android/appand add these lines:

- Above the dependencies add this:

repositories { flatDir { dirs 'libs' } }

3.打开构建。yourRNApp/androidand change the minSdkVersion to 19 or above

就是这样。您应该能够使用CMBSDK React-Native模块工作来运行应用程序。

API METHODS

loadScanner()

To get a scanner up and running, the first thing to do, is to call theloadScanner()方法。它期望cmbreader.device_type param。此方法不连接到阅读器设备。我们需要打电话连接()在回调中实际连接到读取器设备

cmb.loadScanner（cmbreader.device_type.mxreader）.then（（wendesp）=> {cmb.getAvailability（）。然后（response）=> {if（wif（wif（wif）= = = = = = = = = = = = = = = = = =>}）。catch（（（ounders）=> {}）}）;

连接()

/ * @return（Promise）{状态：布尔值，如果连接成功如果不是false erry：string，则如果状态false false erry不会为null} */

The result from the connect() method is returned as a Promise and it will contain the result of the connection attempt:

cmb.connect().then((connectMethodResult) => { // do something after a connection has been established configureReader(); }).catch((failure) => { console.log("CMB - connectReader failed: "+JSON.stringify(failure)) });

有一个事件监听器的连接属性us of the ReaderDevice, namely theCMBReader.EVENT.ConnectionStateChangedevent which is explained in more detail below.

disconnect()

/* @return (promise) { status : boolean, if disconnect succeeded true if not false err : string , if status false err will not be null } */

Just as there is连接()，，，，there is adisconnect()method that does the opposite of连接()：

cmb.disconnect();

Similarly to连接()，，，，disconnect()also triggers theCMBReader.EVENT.ConnectionStateChangedevent.

startScanning()

/* @return Promise (bool) value of the Scanner Activity (true if the command was successful, false otherwise ex: if readerDevice not initialized) */

To start / stop the scanning process, we use these methods. They return a promise, which will be resolved if the command was successful (the scanning has started or stopped) or rejected otherwise (if there is no active ReaderDevice initialized or isn't connected).

启动扫描仪并扫描条形码后，扫描结果触发了cmbreader.event.ReadResultreceivedevent.

setSymbologyEnabled()

Once there is a connection to the Reader, we can enable symbologies by callingsetSymbologyEnabled()。It expects three params: a CMBReader.SYMBOLOGY which is the symbology to be enabled or disabled, a boolean for ON/OFF, and a String for the commandID for handling the command result.

cmb.setsymbology（cmbreader.symbology.qr，true，cmbreader.symbology_name.qr）;

This method triggers theCMBReader.EVENT.CommandCompletedevent, whose result contains thecommandIDstring from the third parameter, so that you know which commands have succeeded and which have failed in the event result.

Issymbology nobable()

To check if we have a symbol enabled, we useIssymbology nobable()。It takes two arguments: the CMBReader.SYMBOLOGY that we are checking, and acommandIDstring used for identifying the response. The result triggers theCMBReader.EVENT.CommandCompleted事件，其中包含commandIDstring from the second parameter, so that you know which commands have succeeded and which have failed in the event result.

cmb.isSymbologyEnabled(CMBReader.SYMBOLOGY.QR, CMBReader.SYMBOLOGY_NAME.QR);

setlightson（）

/ * @return（promise）{状态：布尔值，如果成功执行命令err：string，则为true，如果状态false false不会为null} */

如果我们想启用闪光灯，我们可以使用setlightson（）。It expects one argument boolean and returns a promise.

isLightsOn()

/* @return (promise) { status : boolean, true if lights are on, false otherwise err : string , in case of error (e.g. reader not initialized) } */

We can check the lights status with isLightsOn(), which returns a promise.

getConnectionState()

/** @return A promise that resolves with the CMBReader.CONNECTION_STATE value of the current reader device */

If you need to get the current connection state,getConnectionState()can be used

cmb.getConnectionState（）。然后（function（connectionState）{if（connectionState == cmbreader.connection_state.connection）{// reader已连接}}）;