How to set full license in version 8.x

Different methods are used for setting trial and full license keys. In our demo or sample applications, we use .InitLicense() or .ProductKeys to set trial license keys.

For the purchased version, you need to use initLicenseFromLTS() to the set the Handshake Codes for your licenses.

You can set the license by following the steps below:

1. Activate the license
2. Configure the license (optional)
3. Set the license in the code

Activate the license

Once you purchase a full license from our online store, you can find your license information at Customer Portal.

To activate the license, click “Please first activate the license”.

On the next page, set an Alias for your license or leave the default Alias and click the “Activate” button.

Read more on What is an Alias

On the following popup window, click the “OK” button.

Then you can see the message “Activate Success! You can start configuring your license now”. Click “start configuring your license” to continue.

You can repeat the above steps to activate other license keys.

Configure the license (optional)

After the license is activated, the Handshake Code will be generated automatically. Read more on What is a Handshake Code.

Basically, you can skip the step. But if you would like to edit the Handshake Codes for the license or view the statistics of a handshake code, please refer to how to manage the handshake code.

Set the license in the code

Code snippet in JavaScript:

    Dynamsoft.DBR.BarcodeReader.handshakeCode = "DynamsoftID-CustomCode";// Please replace the handshakeCode with your own
    Dynamsoft.DBR.BarcodeReader.sessionPassword = "The-Password-You-Set";
    let reader = await Dynamsoft.DBR.BarcodeReader.createInstance();

Code snippet in C:

   char errorBuf[512];
   DMLTSConnectionParameters paramters;
   DBR_InitLTSConnectionParameters(&paramters);
   paramters.handshakeCode = "handshakeCode"; // Please replace the handshakeCode with your own
   DBR_InitLicenseFromLTS(&paramters, errorBuf, 512);

Code snippet in C++:

   int iRet = -1;
   char szErrorMsg[256];
   DM_LTSConnectionParameters ltspar;    
   CBarcodeReader::InitLTSConnectionParameters(&ltspar);
   ltspar.handshakeCode = "200***001-1000*****"; // Please replace the handshakeCode with your own
   iRet = CBarcodeReader::InitLicenseFromLTS(&ltspar, szErrorMsg, 256);
   
   if (iRet != DBR_OK)
    {
        printf("Error code: %d. Error message: %s\n", iRet, szErrorMsg);
        return -1;
    }

Code snippet in C#:

   DMLTSConnectionParameters ltspar = BarcodeReader.InitLTSConnectionParameters();           
   ltspar.HandshakeCode = "200***001-1000*****"; // Please replace the handshakeCode with your own
   EnumErrorCode iRet = BarcodeReader.InitLicenseFromLTS(ltspar, out strErrorMSG);

Code snippet in Java:

   DMLTSConnectionParameters ltspar = BarcodeReader.initLTSConnectionParameters();
   ltspar.handshakeCode = "200***001-1000*****"; // Please replace the handshakeCode with your own
   ltspar.deploymentType = EnumDMDeploymentType.DM_DT_DESKTOP; // Please replace the deploymentType with your own
   BarcodeReader.initLicenseFromLTS(ltspar);

Code snippet in iOS (Objective-C):

   iDMLTSConnectionParameters* lts = [[iDMLTSConnectionParameters alloc] init];
   lts.handshakeCode = @"handshakeCode"; // Please replace the handshakeCode with your own
   _dbr = [[DynamsoftBarcodeReader alloc] initLicenseFromLTS:lts verificationDelegate:self];
- (void)LTSLicenseVerificationCallback:(bool)isSuccess error:(NSError * _Nullable)error
{
    NSNumber* boolNumber = [NSNumber numberWithBool:isSuccess];
    dispatch_async(dispatch_get_main_queue(), ^{
    [self->m_verificationReceiver performSelector:self->m_verificationCallback withObject:boolNumber withObject:error];
        NSLog(@"ifsuccess : %@",boolNumber);
        NSLog(@"error code: %ld:",(long)error.code);
        NSLog(@"errormsg : %@",error.userInfo);
        //UIImage *image =[UIImage imageNamed:@"AllSupportedBarcodeTypes.bmp"];
        //NSError* errormsg = nil;
        //NSArray* readResult = [_dbr decodeImage:image withTemplate:@"" error:&errormsg];
    });
}

Code snippet in iOS(Swift):

  let lts = iDMLTSConnectionParameters();
  lts.handshakeCode = "*****-hs-****";
  lts.sessionPassword = "******";
  barcodeReader = DynamsoftBarcodeReader(licenseFromLTS: lts, verificationDelegate: self)
  func ltsLicenseVerificationCallback(_ isSuccess: Bool, error: Error?)
  {
     //TODO add your code for license verification
  }

Code snippet in Android:

   DBRLTSLicenseVerificationListener ltsListener = new DBRLTSLicenseVerificationListener() {
      @Override
      public void LTSLicenseVerificationCallback(boolean success, Exception error) {
      }
   };
   DMLTSConnectionParameters parameters = new DMLTSConnectionParameters();
   parameters.handshakeCode = "200***001-1000*****"; // Please replace the handshakeCode with your own
   dbr.initLicenseFromLTS(parameters,ltsListener);

Code snippet in Python:

 reader = BarcodeReader()
 connection_paras = reader.init_lts_connection_parameters()
 # Please replace the handshakeCode with your own
 connection_paras.handshake_code = "200***001-1000*****"
 try:
     error = reader.init_licesne_from_lts(connection_paras)
     if error[0] != EnumErrorCode.DBR_OK:
         print(error[1])
 except BarcodeReaderError as bre:
     print(bre)

Code snippet in Xamarin: Please refer to this article.

If you run into any issues, please contact Dynamsoft Support.