License Methods

license

A property that stores the license.

@property (nonatomic, nonnull) NSString* license;

initWithLicense

Initializes DynamsoftBarcodeReader with a license.

- (instancetype _Nonnull)initWithLicense:(NSString* _Nonnull)license;

Parameters

[in] license The license key.

Return Value

The instance of DynamsoftBarcodeReader.

Code Snippet

Objective-C:

DynamsoftBarcodeReader *barcodeReader;
barcodeReader = [[DynamsoftBarcodeReader alloc] initWithLicense:@"t0260NwAAAHV***************"];

Swift:

let barcodeReader = DynamsoftBarcodeReader.init(license: "t0260NwAAAHV***************")

initWithLicenseFromServer

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

- (instancetype _Nonnull)initWithLicenseFromServer:(NSString* _Nullable)licenseSeServer licenseKey:(NSString* _Nonnull)licenseKey verificationDelegate:(id _Nullable)connectionDelegate;

Parameters

[in] licenseSeServer The name/IP of the license server.
[in] licenseKey The license key.
[in,out] connectionDelegate The delegate to handle callback when license server returns.

Return Value

The instance of DynamsoftBarcodeReader.

Code Snippet

Objective-C:

DynamsoftBarcodeReader *barcodeReader;
barcodeReader = [[DynamsoftBarcodeReader alloc] initWithLicenseFromServer:@"" licenseKey:@"C087****" verificationDelegate:self];

- (void)licenseVerificationCallback:(bool)isSuccess error:(NSError * _Nullable)error
{
    NSNumber* boolNumber = [NSNumber numberWithBool:isSuccess];
    dispatch_async(dispatch_get_main_queue(), ^{
    [self->verificationReceiver performSelector:self->verificationCallback withObject:boolNumber withObject:error];
    });
}

Swift:

let barcodeReader = DynamsoftBarcodeReader(licenseFromServer: "", licenseKey: "C087****", verificationDelegate: self)

func licenseVerificationCallback(_ isSuccess: Bool, error: Error?)
{
    let boolNumber = NSNumber(value: isSuccess)
    DispatchQueue.main.async{
        self.verificationReceiver?.perform(self.verificationCallback!, with: boolNumber, with: error)
    }
}

outputLicenseToString

Output the license content as an encrypted string from the license server to be used for offline license verification.

- (NSString *_Nullable)outputLicenseToString:(NSError* _Nullable * _Nullable)error;

Parameters

[in,out] error Input a pointer to an error object. If an error occurs, this pointer is set to an actual error object containing the error information. You may specify nil for this parameter if you do not want the error information.

Return Value

The output string which stores the contents of license.

Code Snippet

Objective-C:

DynamsoftBarcodeReader *barcodeReader;
barcodeReader = [[DynamsoftBarcodeReader alloc] initWithLicenseFromServer:@"" licenseKey:@"C087****" verificationDelegate:self];
NSError __autoreleasing * _Nullable error;
[barcodeReader outputLicenseToString:&error];

Swift:

let error: NSError? = NSError()
let barcodeReader = DynamsoftBarcodeReader(licenseFromServer: "", licenseKey: "C087****", verificationDelegate: self)
let licenseString = barcodeReader.outputLicense(error: &error)

initLicenseFromDLS

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

- (instancetype _Nonnull)initLicenseFromDLS:(iDMDLSConnectionParameters* _Nullable)dlsConnectionParameters verificationDelegate:(id _Nullable)connectionDelegate;

Parameters

[in] dlsConnectionParameters The struct DMDLSConnectionParameters with customized settings.
[in,out] connectionDelegate The delegate to handle callback when license server returns.

Return Value

The instance of DynamsoftBarcodeReader.

Code Snippet

Objective-C:

DynamsoftBarcodeReader *barcodeReader;
iDMDLSConnectionParameters* dls = [[iDMDLSConnectionParameters alloc] init];
dls.organizationID = @"200001";
dls.sessionPassword = @"******";
barcodeReader = [[DynamsoftBarcodeReader alloc] initLicenseFromDLS:dls verificationDelegate:self];
- (void)DLSLicenseVerificationCallback:(bool)isSuccess error:(NSError * _Nullable)error
{
        //TODO add your code for license verification
}

Swift:

let dls = iDMDLSConnectionParameters()
dls.organizationID = "200001"
dls.sessionPassword = "******"
let barcodeReader = DynamsoftBarcodeReader(licenseFromDLS: dls, verificationDelegate: self)
func DLSLicenseVerificationCallback(_ isSuccess: Bool, error: Error?)
{
    print("isSucc : \(isSuccess) error : \(String(describing: error))")
}

initLicenseFromLTS

Deprecated. Please use initLicenseFromDLS instead.