# Setup Accura OCR ## **To initialize sdk on app start:** ``` import AccuraOCR var accuraCameraWrapper: AccuraCameraWrapper? = nil var arrCountryList = NSMutableArray() accuraCameraWrapper = AccuraCameraWrapper.init() let sdkModel = accuraCameraWrapper.loadEngine(your PathForDirectories) if (sdkModel.i > 0) { // if sdkModel.isOCREnable then get card data if (sdkModel.isOCREnable) let countryListStr = self.videoCameraWrapper?.getOCRList(); if (countryListStr != null) { for i in countryListStr!{ self.arrCountryList.add(i) } } } } arrCountryList to get value(forKey: "card_name") //get card Name arrCountryList to get value(forKey: "country_id") //get country id arrCountryList to get value(forKey: "card_id") //get card id ``` *** ### **Optional: Load License File Dynamically** If you prefer to place the license file dynamically, you can use the following function. This method allows you to specify the license file path at runtime ``` let documentDirectory = NSSearchPathForDirectoriesInDomains(.documentDirectory, .userDomainMask, true)[0] as String let sdkModel = accuraCameraWrapper?.loadEngine("Your License Path", documentDirectory: documentDirectory) ``` * Note:- For a demo of dynamic licensing, please refer to the branch "dynamic\_license\_demo". ### **Update filters config like below.** Call this function after initialize sdk if license is valid(sdkModel.i > 0) * Set Blur Percentage to allow blur on document ``` // 0 for clean document and 100 for Blurry document self.accuraCameraWrapper?.setBlurPercentage(60/*blurPercentage*/) ``` * Set Blur Face Percentage to allow blur on detected Face ``` // 0 for clean face and 100 for Blurry face accuraCameraWrapper?.setFaceBlurPercentage(80/*faceBlurPercentage*/) ``` * Set Glare Percentage to detect Glare on document ``` // Set min and max percentage for glare accuraCameraWrapper?.setGlarePercentage(6/*minPercentage*/, 98/*maxPercentage*/) ``` * Set Photo Copy to allow photocopy document or not ``` // Set allow photocopy document or not accuraCameraWrapper?.setCheckPhotoCopy(false/*isCheckPhotoCopy*/) ``` * Set Hologram detection to verify the hologram on the face ``` // true to check hologram on face accuraCameraWrapper?.setHologramDetection(true/*isDetectHologram*/) ``` * Set Low Light Tolerance to allow lighting to detect documant ``` // 0 for full dark document and 100 for full bright document accuraCameraWrapper?.setLowLightTolerance(10/*lowlighttolerance*/) ``` * Set motion threshold to detect motion on camera document ``` // 1 - allows 1% motion on document and // 100 - it can not detect motion and allow document to scan. accuraCameraWrapper?.setMotionThreshold(25/*setMotionThreshold*/) ``` * Sets camera Facing front or back camera ``` accuraCameraWrapper?.setCameraFacing(.CAMERA_FACING_BACK) ``` * Flip camera ``` accuraCameraWrapper?.switchCamera() ``` * Set Front/Back Side Scan ``` accuraCameraWrapper?.cardSide(.FRONT_CARD_SCAN) ``` *** ## **Set CameraView** ``` import AccuraOCR import AVFoundation var accuraCameraWrapper: AccuraCameraWrapper? = nil override func viewDidLoad() { super.viewDidLoad() // initialize Camera for OCR,MRZ,DLplate and BankCard accuraCameraWrapper = AccuraCameraWrapper.init(delegate: self, andImageView: /*setImageView*/ _imageView, andLabelMsg: */setLable*/ lblOCRMsg, andurl: */your PathForDirectories*/ NSSearchPathForDirectoriesInDomains(.documentDirectory, .userDomainMask, true)[0] as String, cardId: /*setCardId*/ Int32(cardid!), countryID: /*setcountryid*/ Int32(countryid!), isScanOCR:/*Bool*/ isCheckScanOCR, andcardName:/*string*/ docName, andcardType: Int32(cardType/*2 = DLPlate And 3 = bankCard*/), andMRZDocType: /*SetMRZDocumentType*/ Int32(MRZDocType!/*0 = AllMRZ, 1 = PassportMRZ, 2 = IDMRZ, 3 = VisaMRZ*/)) //Set min frame for qatar ID card //call this function before start camera accuraCameraWrapper?.setMinFrameForValidate(3) // Supports only odd number values } override func viewDidAppear(_ animated: Bool) { super.viewDidAppear(animated) accuraCameraWrapper?.startCamera() } override func viewWillDisappear(_ animated: Bool) { accuraCameraWrapper?.stopCamera() accuraCameraWrapper?.closeOCR() accuraCameraWrapper = nil super.viewWillDisappear(animated) } extension ViewController: VideoCameraWrapperDelegate{ //it sets ViewLayer border according to card image func onUpdateLayout(_ frameSize: CGSize, borderRatio: Float) { frameSize:- get layer frame size borderRatio:- get layer ratio } func isBothSideAvailable(_ isBothAvailable: Bool) { accuraCameraWrapper?.cardSide(.FRONT_CARD_SCAN) } // it calls continues when detect frame from camera func processedImage(_ image: UIImage!) { image:- get camara image. } // it call when license key wrong or didnt get key.license file func recognizeFailed(_ message: String!) { message:- message is a set alert message. } // it calls when get front or back side image func matchedItem(_ image: UIImage!, isCardSide1 cs: Bool, isBack b: Bool, isFront f: Bool, imagePhoto imgp: UIImage!, imageResult: UIImage!) { if f == true to set frontside document Image. if f == false to set backside document Image. } // it calls when get OCR data func resultData(_ resultmodel: ResultModel!) { if isbothSideAvailable { accuraCameraWrapper?.cardSide(.BACK_CARD_SCAN) if(resultmodel.arrayocrBackSideDataKey.count > 0) { //Display Result } } else { //Display result } } // it calls when recieve error message func reco_msg(_ messageCode: String!) { var message = String() if messageCode == ACCURA_ERROR_CODE_MOTION { message = "Keep Document Steady"; } else if(messageCode == ACCURA_ERROR_CODE_DOCUMENT_IN_FRAME) { message = "Keep document in frame"; } else if(messageCode == ACCURA_ERROR_CODE_BRING_DOCUMENT_IN_FRAME) { message = "Bring card near to frame"; } else if(messageCode == ACCURA_ERROR_CODE_PROCESSING) { message = "Processing..."; } else if(messageCode == ACCURA_ERROR_CODE_BLUR_DOCUMENT) { message = "Blur detect in document"; } else if(messageCode == ACCURA_ERROR_CODE_FACE_BLUR) { message = "Blur detected over face"; } else if(messageCode == ACCURA_ERROR_CODE_GLARE_DOCUMENT) { message = "Glare detect in document"; } else if(messageCode == ACCURA_ERROR_CODE_HOLOGRAM) { message = "Hologram Detected"; } else if(messageCode == ACCURA_ERROR_CODE_DARK_DOCUMENT) { message = "Low lighting detected"; } else if(messageCode == ACCURA_ERROR_CODE_PHOTO_COPY_DOCUMENT) { message = "Can not accept Photo Copy Document"; } else if(messageCode == ACCURA_ERROR_CODE_FACE) { message = "Face not detected"; } else if(messageCode == ACCURA_ERROR_CODE_MRZ) { message = "MRZ not detected"; } else if(messageCode == ACCURA_ERROR_CODE_PASSPORT_MRZ) { message = "Passport MRZ not detected"; } else if(messageCode == ACCURA_ERROR_CODE_ID_MRZ) { message = "ID MRZ not detected" } else if(messageCode == ACCURA_ERROR_CODE_VISA_MRZ) { message = "Visa MRZ not detected" }else if(messageCode == ACCURA_ERROR_CODE_UPSIDE_DOWN_SIDE) { message = "Document is upside down. Place it properly" }else if(messageCode == ACCURA_ERROR_CODE_WRONG_SIDE) { message = "Scanning wrong side of Document" }else { message = message; } print(message) } } // it calls when update title messages func reco_titleMessage(_ messageCode: Int32) { var msg: String = "" switch messageCode { case SCAN_TITLE_OCR_FRONT: var frontMsg = "Scan Front side of "; frontMsg = frontMsg.appending(docName) msg = frontMsg break case SCAN_TITLE_OCR_BACK: var backMsg = "Scan Back side of "; backMsg = backMsg.appending(docName) msg = backMsg break case SCAN_TITLE_OCR: var backMsg = "Scan "; backMsg = backMsg.appending(docName) msg = backMsg break case SCAN_TITLE_MRZ_PDF417_FRONT: msg = "Scan Front Side of Document" break case SCAN_TITLE_MRZ_PDF417_BACK: msg = "Scan Back Side of Document" break case SCAN_TITLE_DLPLATE: msg = "Scan Number plate" break case SCAN_TITLE_BARCODE: msg = "Scan Barcode" break case SCAN_TITLE_BANKCARD: msg = "Scan BankCard" break default: break } print(msg) } ```