iOS – Camera ID Scanning SDK

 IDScan offers two SDKs for iOS. This page focuses on the Camera ID Scanning SDK, which allows an iOS application to capture information from the 2D Barcode on a Driver’s License or ID using the iPhone or iPad camera (5 Megapixels or better).

---

Implementation – top

1. 1. 1. 1. Add BarcodeScanner.framework to your project
            

1. 1. 1. 1. Add BarcodeScanner.framework in Embedded Binaries

1. 1. 1. 1. Add ScannerViewController
            

1. 1. 1. 1. Developers should send an email to [email protected] with their app’s Bundle ID in order to receive your “cameraKey”. Make sure you provide your order number if you ready to upgrade from trial to production.

1. 1. 1. 1. To register the library use [scanner registerCode:@"cameraKey"];
            

1. 1. 1. 1. To get the result from the image utilize NSString* result = [scanner scanGrayscaleImage: frameBuffer Width: width Height: height Encoding:1]; Use NSStringEncoding to choose encoding.
            

1. 1. 1. 1. If you plan to customize the camera interface , in the method (void) CustomeOverlay for all elements apply [self.view bringSubviewToFront:elementName];
            

1. 1. 1. 1. To parse the scanned information into a readable format, use the iOS ID Parsing SDK.

In you Swift project you should follow the same way, as in the Objective-C:

1. 1. 1. 1. Add BarcodeScanner.framework and our camera class (ScannerViewController) to you project

1. 1. 1. 1. Add you personal camera key Value to User Defaults (for example in the didFinishLaunchingWithOptions: method )

            let settings = UserDefaults.standard
            let key = "" //your key
            settings.set(key, forKey: "cameraKey")
            settings.synchronize()

1. 1. 1. 1. Make you own class and Inheritance it from ScannerViewController,  add a “Close” button to your Camera view controller (don’t forget move the button to the front)

             class SwiftViewController: ScannerViewController {
              override func viewWillAppear(_ animated: Bool) {
               super.viewWillAppear(animated)
               let rect : CGRect = CGRect(x: 20, y: 20, width: 100, height: 30)
               let close: UIButton = UIButton(frame: rect)
               close.setTitle("Close", for: .normal)
               close.backgroundColor = UIColor.darkGray
               close.addTarget(self, action: #selector(closeBtn), for: .touchUpInside)
               self.view.addSubview(close)
               self.view.bringSubview(toFront: close)
              }
             }

If you want to make you own Camera Class from scratch you should do this:

1. 1. 1. 1. Import BarcodeScanner.framework to you project

import  BarcodeScanner

2. 2. 2. 2. Make instance of scanner

var scanner = Barcode2DScanner()

3. 3. 3. 3. Register camera with you key (for example from UserDefaults)

scanner.registerCode(UserDefaults.standard.string(forKey: "cameraKey"))

4. 4. 4. 4. Call scanGrayscaleImage(pp_image: width: height:) method from instance:

var result = scanner.scanGrayscaleImage(UnsafeMutablePointer!, width: Int32, height: Int32)

pp_image – Pointer of grayscale image, describing array of pixels capacity. Capacity = width*length.

Swift implementation of our framework you can download HERE.

---

How to Activate – top

IDScan.net offers licensing model based on app’s Bundle ID. You can email us your bundle ID to obtain a trial development key.

Copy your application Bundle ID and email to [email protected] 

IDScan.net will issue you a unique Serial number/Registration Key for this Bundle ID

There are two ways to apply the serial number.

1. 1. 1. 1. During design time, paste the serial number in the file dlpSerial.txt in XCode. The file should contain only the serial number. See the screenshot below:

2. 2. 2. 2. To allow the end user to enter the serial, do it programmatically – by applying the method (yourserial = generated string)

[[NSUserDefaults standardUserDefaults] setValue:yourserial forKey:@"cameraKey"];

Click on “Enter DLP serial” to enter serial key.

3. 3. 3. 3. When using both the Camera Scanning SDK and the ID Parsing SDK, you will need to activate both SDKs separately, which you can do by adding another button for the end user with this code:
            [[NSUserDefaults standardUserDefaults] setValue:yourserial forKey:@"DriverLicenseParserCurrentSerial"];
            or by adding this code to the viewDidLoad method or your main view, which will allow you to put the Camera SDK key in the first line of dlpSerial.txt and the ID Parsing SDK key in the second line:

    NSCharacterSet *newLineCharSet = [NSCharacterSet newlineCharacterSet];
    NSUserDefaults *settings = [NSUserDefaults standardUserDefaults];
    NSString *path = [[NSBundle mainBundle] pathForResource:@"dlpSerial" ofType:@"txt"];
    NSString *keyFile = [NSString stringWithContentsOfFile:path encoding:NSWindowsCP1252StringEncoding error:NULL];
    NSArray *keyLines = [keyFile componentsSeparatedByCharactersInSet:newLineCharSet];
    [settings setObject:keyLines[0] forKey:@"cameraKey"];
    [settings synchronize];
    [[NSUserDefaults standardUserDefaults] setObject:keyLines[1] forKey:@"DriverLicenseParserCurrentSerial"];