License Methods

Method	Description
`initLicense`	Reads product key and activate the SDK.
`initLicenseFromServer`	Initializes license and connect to the specified server for online verification.
`initLicenseFromLicenseContent`	Initializes license from the license content on client machine for offline verification.
`outputLicenseToString`	Outputs the license content to a string from the license server.
`initLTSConnectionParameters`	Initializes a DMLTSConnectionParameters struct with default values.
`initLicenseFromLTS`	Initializes the barcode reader license and connects to the specified server for online verification.
`getIdleInstancesCount`	Gets available instances count when charging by concurrent instances count.

initLicense

Reads product key and activates the SDK.

void com.dynamsoft.dbr.BarcodeReader.initLicense(String license) throws BarcodeReaderException

Parameters

license The product keys.

Exceptions

BarcodeReaderException

Code Snippet

BarcodeReader reader = new BarcodeReader();
reader.initLicense("t0260NwAAAHV***************");
reader.destroy();

initLicenseFromServer

Initializes the license and connects to the specified server for online verification.

void com.dynamsoft.dbr.BarcodeReader.initLicenseFromServer(String licenseServer, String licenseKey)	throws BarcodeReaderException

Parameters

licenseServer The URL of the license server.
licenseKey The license key.

Exceptions

BarcodeReaderException

Code Snippet

BarcodeReader reader = new BarcodeReader("t0260NwAAAHV***************");
reader.initLicenseFromServer("", "C087****");
reader.destroy();

initLicenseFromLicenseContent

Initializes barcode reader license from the license content on the client machine for offline verification.

void com.dynamsoft.dbr.BarcodeReader.initLicenseFromLicenseContent(String licenseKey, String licenseContent) throws BarcodeReaderException

Parameters

licenseKey The license key.
licenseContent An encrypted string representing the license content (quota, expiration date, barcode type, etc.) obtained from the method OutputLicenseToString.

Exceptions

BarcodeReaderException

Code Snippet

BarcodeReader reader = new BarcodeReader("t0260NwAAAHV***************");
reader.initLicenseFromLicenseContent("t0260NwAAAHV***************", "C087****");
reader.destroy();

outputLicenseToString

Outputs the license content as an encrypted string from the license server for offline license verification.

String com.dynamsoft.dbr.BarcodeReader.outputLicenseToString() throws BarcodeReaderException

Return value

The output string which stores the content of the license.

Exceptions

BarcodeReaderException

Remark

InitLicenseFromServer has to be successfully called before calling this method.

Code Snippet

BarcodeReader reader = new BarcodeReader("t0260NwAAAHV***************");
reader.initLicenseFromLicenseContent("t0260NwAAAHV***************", "C087****");
String licenseInfo = reader.outputLicenseToString();
reader.destroy();

initLTSConnectionParameters

Initializes a DMLTSConnectionParameters struct with default values.

static DMLTSConnectionParameters com.dynamsoft.dbr.BarcodeReader.initLTSConnectionParameters() throws BarcodeReaderException

Code Snippet

DMLTSConnectionParameters info = BarcodeReader.initLTSConnectionParameters();
info.handShakeCode = "*****-hs-****";
info.sessionPassword = "******";
BarcodeReader.initLicenseFromLTS(info);
BarcodeReader reader = new BarcodeReader();

initLicenseFromLTS

Initializes the barcode reader license and connects to the specified server for online verification.

static void com.dynamsoft.dbr.BarcodeReader.initLicenseFromLTS(DMLTSConnectionParameters ltsInfo) throws BarcodeReaderException

Parameters

ltsInfo: The struct DMLTSConnectionParameters with customized settings.

Code Snippet

DMLTSConnectionParameters info = BarcodeReader.initLTSConnectionParameters();
info.handShakeCode = "*****-hs-****";
info.sessionPassword = "******";
BarcodeReader.initLicenseFromLTS(info);
BarcodeReader reader = new BarcodeReader();

getIdleInstancesCount

Gets the count of available instances when charging by concurrent instances count.

static int com.dynamsoft.dbr.BarcodeReader.getIdleInstancesCount()

Return value

Returns available instances count.

Code Snippet

//...
int count = BarcodeReader.getIdleInstancesCount();
if(count > 0)
{
  //create instance and process further
}
else 
{
  //waiting for available instances 
}