Merge pull request #247 from BlinkID/jenkins/master-build

Jenkins/master build

CHANGELOG.md

@@ -1,5 +1,37 @@
 # Release notes
 
+## 4.10.0
+
+- Updates and additions:
+    - added `MBBlinkIdRecognizer` for scanning front side of ID cards and `MBBlinkIdCombinedRecognizer` for combined scanning of front and back side of ID cards
+        - for now, these recognizers classify and extract data from **87** different classes of **United States driver's licenses** (front and back side)
+        - in the upcoming releases, we are planning to add support for more document types from different countries
+    - completely new UX for scanning ID cards with scan overlay view controller: `MBBlinkIdOverlayViewController`:
+        -  best suited for scanning with `MBBlinkIdRecognizer` and `MBBlinkIdCombinedRecognizer`
+        - other single side and combined document recognizers are also supported
+- added support for reading back side of Nigerian Voter ID card - use `MBNigeriaVoterIdBackRecognizer`
+
+- Improvements in ID scanning performance:
+    - improved `MBRomaniaIdFrontRecognizer`
+        - now extracts `CNP` number
+    - improved `MBSloveniaIdFrontRecognizer` and `MBloveniaCombinedRecognizer`:
+        - return boolean flag which indicates whether **date of expiry** is permanent - use `dateOfExpiryPermanent`
+    - improved `MBGermanyPassportRecognizer`:
+        - better passport classification
+    - improved `MBColombiaIdFrontRecognizer`:
+        - support for document number in format 1-3-3
+    - improved `MBSlovakiaIdFrontRecognizer`:
+        - support for German letters
+    - Malaysia:
+        - `MBMalaysiaMyTenteraFrontRecognizer` supports 6-digit army number
+        - `MBMalaysiaIkadFrontRecognizer` - better extraction of the following fields (DeepOCR support): date of birth, sector, employer, address and date of expiry
+    - United Arab Emirates:
+        - glare detection is disabled by default for `MBUnitedArabEmiratesIdFrontRecognizer` and `MBUnitedArabEmiratesIdBackRecognizer` 
+        - `MBUnitedArabEmiratesIdBackRecognizer` - optimized detection for black backgrounds
+
+- Bugfixes:
+    - fixed bug in `MBBlinkCardOverlayViewController` which caused memory issues
+
 ## 4.9.1
 
 - Bugfixes:

Microblink.bundle/en.strings

@@ -21,3 +21,18 @@
 "photopay_front_splash_verification_document" = "Document front side";
 "photopay_back_splash_verification_document" = "Document back side";
 "photopay_done_splash_verification_document" = "Document scanning done";
+
+"blinkid_generic_message" = "Scan the front side of a document";
+"blinkid_not_supported_title" = "Document not recognized";
+"blinkid_not_supported_message" = "Scan the front side of a supported document.";
+"blinkid_not_supported_action" = "Retry";
+
+"blinkid_sides_dont_match_title" = "Sides don't match";
+"blinkid_sides_dont_match_message" = "Please start the scanning process over.";
+
+"blinkid_first_side_scanned_message" = "Flip the card";
+
+"blinkid_too_near_error_message" = "Move farther";
+"blinkid_too_far_error_message" = "Move closer";
+"blinkid_scan_unsuccessful_error_title" = "Scan unsuccessful";
+"blinkid_scan_unsuccessful_error_message" = "Unable to read the document. Please try again.";

Microblink.bundle/hr.strings

@@ -0,0 +1,39 @@
+/* 
+  en.strings
+  BlinkOCR
+
+  Created by Jura on 12/03/15.
+  Copyright (c) 2015 MicroBlink. All rights reserved.
+*/
+
+"photopay_close" = "Cancel";
+"photopay_light_on" = "Light";
+"photopay_light_off" = "Light";
+"photopay_camera_permission_denied" = "{font:@Medium}%@{/font} does not have permission to use the camera.\n\nPlease go to:\n• {font:@Medium}Settings{/font}\n• {font:@Medium}%@{/font}\n• Make sure that {font:@Medium}Camera{/font} is enabled";
+"photopay_id_position_tooltip" = "Position ID card in this Frame";
+"photopay_glare_status" = "Slightly move ID to eliminate glare.";
+"blink_card_front_message" = "Scan the front side.";
+"blink_card_back_message" = "Scan the back side.";
+"blink_card_done_message" = "Done scanning.";
+
+"photopay_front_verification_document" = "Place the front side of the document in the frame and wait for automatic scan.";
+"photopay_back_verification_document" = "Place the back side of the document in the frame and wait for automatic scan.";
+"photopay_front_splash_verification_document" = "Document front side";
+"photopay_back_splash_verification_document" = "Document back side";
+"photopay_done_splash_verification_document" = "Document scanning done";
+
+"blinkid_generic_message" = "Skenirajte prednju stranu dokumenta";
+"blinkid_not_supported_title" = "Nepoznat dokument";
+"blinkid_not_supported_message" = "Ponovite skeniranje prednje strane podržanog dokumenta.";
+"blinkid_not_supported_action" = "U redu";
+
+"blinkid_sides_dont_match_title" = "Podaci se ne podudaraju";
+"blinkid_sides_dont_match_message" = "Molimo ponovno skenirajte prednju i stražnju stranu istog dokumenta.";
+
+"blinkid_first_side_scanned_message" = "Okrenite dokument";
+
+"blinkid_too_near_error_message" = "Udaljite dokument";
+"blinkid_too_far_error_message" = "Približite dokument";
+"blinkid_scan_unsuccessful_error_title" = "Skeniranje nije uspjelo";
+"blinkid_scan_unsuccessful_error_message" = "Dokument nije moguće očitati. Molimo pokušajte ponovno.";
+

Microblink.framework/Headers/MBAustriaIdFrontRecognizer.h

@@ -5,7 +5,6 @@
 //  Created by Dino Gustin on 22/05/2018.
 //
 
-#import "MBLegacyRecognizer.h"
 #import "MBAustriaIdFrontRecognizerResult.h"
 
 #import <Foundation/Foundation.h>

Microblink.framework/Headers/MBBlinkIDEntities.h

@@ -91,6 +91,12 @@
 #import "MBEudlRecognizer.h"
 #import "MBEudlRecognizerResult.h"
 
+// Generic
+#import "MBBlinkIdRecognizer.h"
+#import "MBBlinkIdRecognizerResult.h"
+#import "MBBlinkIdCombinedRecognizer.h"
+#import "MBBlinkIdCombinedRecognizerResult.h"
+
 // Germany
 #import "MBGermanyIdBackRecognizer.h"
 #import "MBGermanyIdBackRecognizerResult.h"
@@ -173,6 +179,10 @@
 #import "MBNewZealandDlFrontRecognizer.h"
 #import "MBNewZealandDlFrontRecognizerResult.h"
 
+// Nigeria
+#import "MBNigeriaVoterIdBackRecognizer.h"
+#import "MBNigeriaVoterIdBackRecognizerResult.h"
+
 // Passport
 #import "MBPassportRecognizer.h"
 #import "MBPassportRecognizerResult.h"

Microblink.framework/Headers/MBBlinkIDUIComponents.h

@@ -12,14 +12,19 @@
 // Overlay delegates
 #import "MBDocumentOverlayViewControllerDelegate.h"
 #import "MBDocumentVerificationOverlayViewControllerDelegate.h"
+#import "MBBlinkIdOverlayViewControllerDelegate.h"
 
 // Overlays
 #import "MBDocumentOverlayViewController.h"
 #import "MBDocumentOverlaySettings.h"
 #import "MBDocumentVerificationOverlayViewController.h"
 #import "MBDocumentVerificationOverlaySettings.h"
+#import "MBBlinkIdOverlayViewController.h"
+#import "MBBlinkIdOverlaySettings.h"
 
 // Overlay subviews
 #import "MBDocumentSubview.h"
 #import "MBDocumentVerificationSubview.h"
 #import "MBDocumentVerificationInstructionsSubview.h"
+#import "MBCameraReticle.h"
+#import "MBErrorReticle.h"

Microblink.framework/Headers/MBBlinkIdCombinedRecognizer.h

@@ -0,0 +1,58 @@
+//
+//  MBBlinkIdCombinedRecognizer.h
+//  MicroblinkDev
+//
+//  Created by Jura Skrlec on 18/06/2019.
+//
+
+#import "MBRecognizer.h"
+#import "MBBlinkIdCombinedRecognizerResult.h"
+
+#import "MBCombinedRecognizer.h"
+#import "MBDigitalSignature.h"
+
+#import "MBFaceImage.h"
+#import "MBEncodeFaceImage.h"
+#import "MBFaceImageDpi.h"
+#import "MBFullDocumentImage.h"
+#import "MBEncodeFullDocumentImage.h"
+#import "MBFullDocumentImageDpi.h"
+#import "MBFullDocumentImageExtensionFactors.h"
+
+@protocol MBBlinkIdCombinedRecognizerDelegate;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Recognizer which can scan front and back side of the United States driver license.
+ */
+MB_CLASS_AVAILABLE_IOS(8.0) MB_FINAL
+@interface MBBlinkIdCombinedRecognizer : MBRecognizer<NSCopying, MBCombinedRecognizer, MBDigitalSignature, MBFaceImage, MBEncodeFaceImage, MBFaceImageDpi, MBFullDocumentImage, MBEncodeFullDocumentImage, MBFullDocumentImageDpi, MBFullDocumentImageExtensionFactors>
+
+MB_INIT
+
+/**
+ * Result of scanning BlinkIDCombinedRecognizer
+ */
+@property (nonatomic, strong, readonly) MBBlinkIdCombinedRecognizerResult *result;
+
+/**
+ * Called with dewarped full document image
+ */
+- (void)setDewarpedImageDelegate:(nullable id<MBBlinkIdCombinedRecognizerDelegate>)delegate;
+
+/**
+ * Called when document is not supported
+ */
+- (void)setClassifierDelegate:(nullable id<MBBlinkIdCombinedRecognizerDelegate>)delegate;
+
+@end
+
+@protocol MBBlinkIdCombinedRecognizerDelegate <NSObject>
+@optional
+- (void)onCombinedImageAvailable:(nullable MBImage *)dewarpedImage;
+- (void)onCombinedDocumentSupportStatus:(BOOL)isDocumentSupported;
+@end
+
+
+NS_ASSUME_NONNULL_END

Microblink.framework/Headers/MBBlinkIdCombinedRecognizerResult.h

@@ -0,0 +1,83 @@
+//
+//  MBBlinkIdCombinedRecognizerResult.h
+//  MicroblinkDev
+//
+//  Created by Jura Skrlec on 18/06/2019.
+//
+
+#import "MBRecognizerResult.h"
+#import "MBDateResult.h"
+
+#import "MBCombinedRecognizerResult.h"
+#import "MBDigitalSignatureResult.h"
+
+#import "MBFaceImageResult.h"
+#import "MBEncodedFaceImageResult.h"
+#import "MBFullDocumentImageResult.h"
+#import "MBEncodedFullDocumentImageResult.h"
+
+#import "MBDriverLicenseDetailedInfo.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Recognizer which can scan front and back side of the United States driver license.
+ */
+MB_CLASS_AVAILABLE_IOS(8.0)
+@interface MBBlinkIdCombinedRecognizerResult : MBRecognizerResult<NSCopying, MBCombinedRecognizerResult, MBDigitalSignatureResult, MBFaceImageResult, MBEncodedFaceImageResult, MBFullDocumentImageResult, MBEncodedFullDocumentImageResult>
+
+MB_INIT_UNAVAILABLE
+
+/**
+ * The address of the document owner.
+ */
+@property (nonatomic, readonly, nullable) NSString *address;
+
+/**
+ * The date of birth of the document owner.
+ */
+@property (nonatomic, readonly, nullable) MBDateResult *dateOfBirth;
+
+/**
+ * The date of expiry of the document.
+ */
+@property (nonatomic, readonly, nullable) MBDateResult *dateOfExpiry;
+
+/**
+ * The date of issue of the document.
+ */
+@property (nonatomic, readonly, nullable) MBDateResult *dateOfIssue;
+
+/**
+ * The document number.
+ */
+@property (nonatomic, readonly, nullable) NSString *documentNumber;
+
+/**
+ * The first name of the document owner.
+ */
+@property (nonatomic, readonly, nullable) NSString *firstName;
+
+/**
+ * The full name of the document owner.
+ */
+@property (nonatomic, readonly, nullable) NSString *fullName;
+
+/**
+ * The last name of the document owner.
+ */
+@property (nonatomic, readonly, nullable) NSString *lastName;
+
+/**
+ * The sex of the document owner.
+ */
+@property (nonatomic, readonly, nullable) NSString *sex;
+
+/**
+ * The driver license detailed info.
+ */
+@property (nonatomic, readonly, nullable) MBDriverLicenseDetailedInfo *driverLicenseDetailedInfo;
+
+@end
+
+NS_ASSUME_NONNULL_END

Microblink.framework/Headers/MBBlinkIdOverlaySettings.h

@@ -0,0 +1,34 @@
+//
+//  MBBlinkIdOverlaySettings.h
+//  MicroblinkDev
+//
+//  Created by Jura Skrlec on 03/06/2019.
+//
+
+#import "MBBaseOverlaySettings.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Settings class containing parameters for BlinkId UI
+ */
+MB_CLASS_AVAILABLE_IOS(8.0)
+@interface MBBlinkIdOverlaySettings : MBBaseOverlaySettings
+
+/**
+ * If YES, MBBlinkIdCombinedRecognizer will check if sides do match when scanning is finished
+ *
+ * Default: YES
+ */
+@property(nonatomic, assign) BOOL requireDocumentSidesDataMatch;
+
+/**
+ * Designated initializer. Initializes the object with default settings.
+ *
+ *  @return object initialized with default values.
+ */
+- (instancetype)init NS_DESIGNATED_INITIALIZER;
+
+@end
+
+NS_ASSUME_NONNULL_END

Microblink.framework/Headers/MBBlinkIdOverlayViewController.h

@@ -0,0 +1,46 @@
+//
+//  MBBlinkIdOverlayViewController.h
+//  MicroblinkDev
+//
+//  Created by Jura Skrlec on 03/06/2019.
+//
+
+#import "MBBaseOverlayViewController.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@protocol MBBlinkIdOverlayViewControllerDelegate;
+
+@class MBBlinkIdOverlaySettings;
+@class MBRecognizerCollection;
+
+/**
+ * Default version of overlay view controller with modern design.
+ */
+MB_CLASS_AVAILABLE_IOS(8.0) MB_FINAL
+@interface MBBlinkIdOverlayViewController : MBBaseOverlayViewController
+
+/**
+ * Common BlinkId UI settings
+ */
+@property (nonatomic, readonly) MBBlinkIdOverlaySettings *settings;
+
+/**
+ * Delegate
+ */
+@property (nonatomic, weak, readonly) id<MBBlinkIdOverlayViewControllerDelegate> delegate;
+
+/**
+ * Designated intializer.
+ *
+ *  @param settings MBBlinkIdOverlaySettings object
+ *
+ *  @param recognizerCollection MBRecognizerCollection object
+ *
+ *  @return initialized overlayViewController
+ */
+- (instancetype)initWithSettings:(MBBlinkIdOverlaySettings *)settings recognizerCollection:(MBRecognizerCollection *)recognizerCollection delegate:(nonnull id<MBBlinkIdOverlayViewControllerDelegate>)delegate;
+
+@end
+
+NS_ASSUME_NONNULL_END