License Methods

Method	Description
`initLicense`	Initializes license key and activate the SDK.
`isInstanceValid`	Gets whether the instance is valid when charging by concurrent instances count.
`setDeviceFriendlyName`	Sets a human-readable name that identifies the device.
`setMaxConcurrentInstanceCount`	Sets the max concurrent instance count used for current device and process.
`getIdleInstancesCount`	`Deprecated`
`initLicenseFromServer`	`Deprecated`
`initLicenseFromLicenseContent`	`Deprecated`
`outputLicenseToString`	`Deprecated`
`initDLSConnectionParameters`	`Deprecated`
`initLicenseFromDLS`	`Deprecated`
`initLTSConnectionParameters`	`Deprecated`
`initLicenseFromLTS`	`Deprecated`

initLicense

Initializes license key and activates the SDK.

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

Parameters

license The product keys.

Exception

BarcodeReaderException

Code Snippet

BarcodeReader.initLicense("YOUR-LICENSE-KEY");
BarcodeReader reader = new BarcodeReader();
// add further process

isInstanceValid

Gets whether the instance is valid when charging by concurrent instances count.

int com.dynamsoft.dbr.BarcodeReader.isInstanceValid()

Return Value

Returns an int value indicating whether the instance is valid for running on concurrent instance mode.

0: The instance is not valid for running on concurrent instance mode.
1: The instance is valid for running on concurrent instance mode.

Remarks

This method is meaningful only when using a license charged by concurrent instances count.

setDeviceFriendlyName

Sets a human-readable name that identifies the device.

static void com.dynamsoft.dbr.BarcodeReader.setDeviceFriendlyName(String name) throws BarcodeReaderException

Parameters

name The device alias.

Exception

BarcodeReaderException

Code Snippet

BarcodeReader.setDeviceFriendlyName("My-PC");
BarcodeReader.initLicense("YOUR-LICENSE-KEY");
BarcodeReader reader = new BarcodeReader();
// add further process

setMaxConcurrentInstanceCount

Sets the max concurrent instance count used for current device and process.

static void com.dynamsoft.dbr.BarcodeReader.setMaxConcurrentInstanceCount(int countForThisDevice, int countForThisProcess)

Parameters

[in] countForThisDevice The maximum number of concurrent instances that the current device can run.

[in] countForThisProcess The maximum number of concurrent instances that the current process can run.

Code Snippet

int countForThisDevice = 1; // The count value should be set based on your purchased license count
int countForThisProcess = 1; // The count value should be set based on your purchased license count
BarcodeReader.setMaxConcurrentInstanceCount(countForThisDevice, countForThisProcess);
BarcodeReader.initLicense("YOUR-LICENSE-KEY");
BarcodeReader reader = BarcodeReader.getInstance();
// If no instance is available right away, the application will wait until one becomes available
if(reader != null)
{
    // Add your code here to call decoding method, process barcode results and so on
    // ...
    // Recycle the instance to make it idle for other concurrent tasks
    reader.recycle();
}