Merge pull request #368 from BlinkID/jenkins/stable-build

Jenkins/stable build

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Release notes
 
+## 5.17.0
+​
+### Changes to BlinkID(Combined) Recognizer
+- Introduced the expanded DataMatch functionality for the BlinkID with the new result member called `dataMatchDetailedInfo`
+	- This result member will enable you to see for which field has been performed, or it did not, the DataMatch functionality. This is enabled for `dateOfBirth`, `documentNumber` and `dateOfExpiry`.
+	- For example, if the date of expiry is scanned from the front and back side of the document and values do not match, this method will return DataMatchResult: Failed.
+Result will be DataMatchResult: Success only if scanned values for all fields that are compared are the same. If data matching has not been performed, the result will be DataMatchResult: NotPerformed. This information is available for every of the three mentioned field values above.
+​
+- Fixed issues with scanning Argentina AlienID, where there were confusions with the regular ID. `ClassInfo` now correctly returns which ID type is present based on the barcode data.
+
 ## 5.16.1
 
 ### Fixes

Microblink.xcframework/Info.plist

@@ -18,7 +18,7 @@
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-maccatalyst</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>Microblink.framework</string>
 			<key>SupportedArchitectures</key>
@@ -29,11 +29,11 @@
 			<key>SupportedPlatform</key>
 			<string>ios</string>
 			<key>SupportedPlatformVariant</key>
-			<string>maccatalyst</string>
+			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64_x86_64-maccatalyst</string>
 			<key>LibraryPath</key>
 			<string>Microblink.framework</string>
 			<key>SupportedArchitectures</key>
@@ -44,15 +44,15 @@
 			<key>SupportedPlatform</key>
 			<string>ios</string>
 			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
+			<string>maccatalyst</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>
 	<string>XFWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.16.1</string>
+	<string>5.17.0</string>
 	<key>CFBundleVersion</key>
-	<string>5.16.1</string>
+	<string>5.17.0</string>
 	<key>XCFrameworkFormatVersion</key>
 	<string>1.0</string>
 </dict>

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBBlinkIdCombinedRecognizer.h

@@ -23,6 +23,7 @@
 #import "MBSignatureImage.h"
 #import "MBSignatureImageDpi.h"
 #import "MBEncodeSignatureImage.h"
+#import "MBCameraFrames.h"
 
 @protocol MBBlinkIdCombinedRecognizerDelegate;
 
@@ -32,7 +33,7 @@ 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, MBFaceImage, MBEncodeFaceImage, MBFaceImageDpi, MBFullDocumentImage, MBEncodeFullDocumentImage, MBFullDocumentImageDpi, MBFullDocumentImageExtensionFactors, MBSignatureImage, MBSignatureImageDpi, MBEncodeSignatureImage>
+@interface MBBlinkIdCombinedRecognizer : MBRecognizer<NSCopying, MBCombinedRecognizer, MBFaceImage, MBEncodeFaceImage, MBFaceImageDpi, MBFullDocumentImage, MBEncodeFullDocumentImage, MBFullDocumentImageDpi, MBFullDocumentImageExtensionFactors, MBSignatureImage, MBSignatureImageDpi, MBEncodeSignatureImage, MBCameraFrames>
 
 MB_INIT
 
@@ -138,14 +139,6 @@ MB_INIT
  */
 @property (nonatomic, assign) BOOL allowUncertainFrontSideScan;
 
-/**
- * Configure the recognizer to save the raw camera frames.
- * This significantly increases memory consumption.
- *
- * Default: NO
- */
-@property (nonatomic, assign) BOOL saveCameraFrames;
-
 /**
  * Configure the number of characters per field that are allowed to be inconsistent in data match.
  *

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBBlinkIdCombinedRecognizerResult.h

@@ -28,6 +28,7 @@
 
 #import "MBAgeResult.h"
 #import "MBDocumentExpirationCheckResult.h"
+#import "MBDataMatchDetailedInfo.h"
 
 NS_ASSUME_NONNULL_BEGIN
 
@@ -254,6 +255,11 @@ MB_INIT_UNAVAILABLE
  */
 @property (nonatomic, readonly, nullable) MBImage *barcodeCameraFrame;
 
+/**
+ * Detailed info on data match.
+ */
+@property (nonatomic, readonly, nullable) MBDataMatchDetailedInfo *dataMatchDetailedInfo;
+
 @end
 
 NS_ASSUME_NONNULL_END

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBBlinkIdRecognizer.h

@@ -21,6 +21,7 @@
 #import "MBSignatureImage.h"
 #import "MBSignatureImageDpi.h"
 #import "MBEncodeSignatureImage.h"
+#import "MBCameraFrames.h"
 
 @protocol MBBlinkIdRecognizerDelegate;
 
@@ -30,7 +31,7 @@ NS_ASSUME_NONNULL_BEGIN
 * The Blink ID Recognizer is used for scanning Blink ID.
 */
 MB_CLASS_AVAILABLE_IOS(8.0) MB_FINAL
-@interface MBBlinkIdRecognizer : MBRecognizer <NSCopying, MBFaceImage, MBEncodeFaceImage, MBFaceImageDpi, MBFullDocumentImage, MBEncodeFullDocumentImage, MBFullDocumentImageDpi, MBFullDocumentImageExtensionFactors,  MBSignatureImage, MBSignatureImageDpi, MBEncodeSignatureImage>
+@interface MBBlinkIdRecognizer : MBRecognizer <NSCopying, MBFaceImage, MBEncodeFaceImage, MBFaceImageDpi, MBFullDocumentImage, MBEncodeFullDocumentImage, MBFullDocumentImageDpi, MBFullDocumentImageExtensionFactors,  MBSignatureImage, MBSignatureImageDpi, MBEncodeSignatureImage, MBCameraFrames>
 
 MB_INIT
 
@@ -121,14 +122,6 @@ MB_INIT
  */
 @property (nonatomic, assign) BOOL scanCroppedDocumentImage;
 
-/**
- * Configure the recognizer to save the raw camera frames.
- * This significantly increases memory consumption.
- *
- * Default: NO
- */
-@property (nonatomic, assign) BOOL saveCameraFrames;
-
 @end
 
 @protocol MBBlinkIdRecognizerDelegate <NSObject>

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBCameraFrames.h

@@ -0,0 +1,25 @@
+//
+//  MBCameraFrames.h
+//  BlinkShowcaseDev
+//
+//  Created by Mijo Gracanin on 04.04.2022..
+//
+
+#ifndef MBCameraFrames_h
+#define MBCameraFrames_h
+
+@protocol MBCameraFrames
+
+@required
+
+/**
+ * Configure the recognizer to save the raw camera frames.
+ * This significantly increases memory consumption.
+ *
+ * Default: NO
+ */
+@property (nonatomic, assign) BOOL saveCameraFrames;
+
+@end
+
+#endif /* MBCameraFrames_h */

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBCameraSettings.h

@@ -130,6 +130,14 @@ MB_CLASS_AVAILABLE_IOS(8.0)
  */
 @property (nonatomic) BOOL cameraMirroredVertically;
 
+/**
+ * Set the back side preview camera layer zoom factor. 1.0 means there is no zoom, 2.0 double the zoom - preview layer is 2x zoomed than video output.
+ * Valid ranges are [1.0, 2.0] - rounded to nearest two decimals. Setting previewZoomScale out of valid ranges throws an exception.
+ *
+ * Default: 1.0
+ */
+@property (nonatomic) CGFloat previewZoomScale;
+
 /**
  * Designated initializer. Initializes the object with default settings (see above for defaults)
  *

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBCryptoUploader.h

@@ -0,0 +1,63 @@
+//
+//  MBCryptoUploader.h
+//  BlinkID-app
+//
+//  Created by Luka Zuanovic MB on 28/03/2017.
+//  Copyright © 2017 Microblink. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface MBCryptoUploader : NSObject
+
+/**
+ Sets name of all encrypted data that will be uploaded henceforth.
+ @warning This method must be invoked at least once or no data will ever be uploaded.
+
+ @param dataName Name of the uploaded data. Cannot be nil nor empty.
+ */
+- (void)setDataNameForFutureUploads:(nonnull NSString *)dataName;
+
+/**
+ Method used to upload an encrypted image.
+ This method will do nothing and return 0 should there be any exception while encrypting or uploading the data.
+
+ @param image Image to encrytpt and upload.
+ @param url where the image is uploaded
+ @return Total size (approximate) of the uploaded data.
+ */
+- (NSUInteger)uploadImage:(nonnull UIImage *)image url:(nonnull NSString *)url;
+
+/**
+ Method used to upload an encrypted image, metadata and encrypted secret metadata.
+ This method will do nothing and return 0 should there be any exception while encrypting or uploading the data.
+ 
+ @param image Image to encrypt and upload.
+ @param metadata Metadata to upload.
+ @param secretMetadata Metadata to encrypt and upload.
+ @param url where the image is uploaded
+ @return Total size (approximate) of the uploaded data.
+ */
+- (NSUInteger)uploadImage:(nonnull UIImage *)image metadata:(nullable NSString *)metadata secretMetadata:(nullable NSString *)secretMetadata url:(nonnull NSString *)url;
+
+/**
+ Method used to upload an encrypted image, metadata, encrypted secret metadata and other data.
+ This method will do nothing and return 0 should there be any exception while encrypting or uploading the data.
+
+ @param image Image to encrypt and upload.
+ @param metadata Metadata to upload.
+ @param secretMetadata Metadata to encrypt and upload.
+ @param data Data, in key value pairs, to upload.
+ @param url where the image is uploaded
+ @return Total size (approximate) of the uploaded data.
+ */
+- (NSUInteger)uploadImage:(nonnull UIImage *)image metadata:(nullable NSString *)metadata secretMetadata:(nullable NSString *)secretMetadata otherData:(nullable NSDictionary<NSString *, NSString *> *)data url:(nonnull NSString *)url;
+
+- (NSUInteger)uploadData:(NSData *)data metadata:(NSString *)metadata secretMetadata:(NSString *)secretMetadata otherData:(NSDictionary<NSString *, NSString *> *)otherData fileType:(NSString *)fileType url:(nonnull NSString *)url;
+
+NS_ASSUME_NONNULL_END
+
+@end

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBDataMatchDetailedInfo.h

@@ -0,0 +1,54 @@
+//
+//  MBDataMatchDetailedInfo.hpp
+//  BlinkShowcaseDev
+//
+//  Created by Mijo Gracanin on 02.06.2022..
+//
+
+#import <Foundation/Foundation.h>
+#import "MBMicroblinkDefines.h"
+#import "MBCombinedRecognizerResult.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+MB_CLASS_AVAILABLE_IOS(9.0)
+@interface MBDataMatchDetailedInfo : NSObject
+
+/**
+ * Returns result of the data matching algorithm for scanned parts/sides of the document.
+ * For example if date of expiry is scanned from the front and back side
+ * of the document and values do not match, this method will return {@link DataMatchResult#Failed}.
+ * Result will be {@link DataMatchResult#Success} only if scanned values for all fields that are
+ * compared are the same. If data matching has not been performed, result will be
+ * {@link DataMatchResult#NotPerformed}.
+ *
+ * @return result of the data matching algorithm for scanned parts/sides of the document.
+ */
+- (MBDataMatchResult) getDataMatchResult;
+
+/**
+ * The result of data match on date of birth field.
+ *
+ * @return result of the data matching algorithm for date of birth field.
+ */
+- (MBDataMatchResult) getDateOfBirth;
+
+/**
+ * The result of data match on date of expiry field.
+ *
+ * @return result of the data matching algorithm for date of expiry field.
+ */
+- (MBDataMatchResult) getDateOfExpiry;
+/**
+ * The result of data match on document number field.
+ *
+ * @return result of the data matching algorithm for document number field.
+ */
+- (MBDataMatchResult) getDocumentNumber;
+
+
+- (instancetype)init NS_UNAVAILABLE;
+
+@end
+
+NS_ASSUME_NONNULL_END

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBGeometry.h

@@ -119,6 +119,8 @@ void CGRectClosestTwoCornerPoints(CGRect rect, CGPoint point, CGPoint *point1, C
 // the rectangle. Returns NULL_POINT if no interseciton is found.
 CGPoint CGLineIntersectsRectAtPoint(CGRect rect, CGLine line);
 
+// Transforms point from one rect to another.
+CGPoint CGTransformedPointToDestination(CGPoint point, CGRect originalRect, CGRect destinationRect);
 
 #pragma mark - Arcs
 

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBImage.h

@@ -1,5 +1,5 @@
 //
-//  PPImage.h
+//  MBImage.h
 //  BlinkIdFramework
 //
 //  Created by Dino on 25/02/16.

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBPointDetectorSubview.h

@@ -17,4 +17,9 @@
  */
 - (void)detectionFinishedWithDisplayablePoints:(MBDisplayablePointsDetection *)displayablePointsDetection;
 
+/**
+ * This method should be called when MBDisplayablePointsDetection is obtained and points need to be drawn/redrawn with camera preview zoom enabled by setting previewZoomScale property on cameraSettings.
+ */
+- (void)detectionFinishedWithDisplayablePoints:(MBDisplayablePointsDetection *)displayablePointsDetection originalRectangle:(CGRect)originalRect relativeRectangle:(CGRect)relativeRectangle;
+
 @end

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBQuadDetectorSubview.h

@@ -17,4 +17,9 @@
  */
 - (void)detectionFinishedWithDisplayableQuad:(MBDisplayableQuadDetection *)displayableQuadDetection;
 
+/**
+ * This method should be called when MBDisplayableQuadDetection is obtained and quad need to be drawn/redrawn with camera preview zoom enabled by setting previewZoomScale property on cameraSettings.
+ */
+- (void)detectionFinishedWithDisplayableQuad:(MBDisplayableQuadDetection *)displayableQuadDetection originalRectangle:(CGRect)originalRect relativeRectangle:(CGRect)relativeRectangle;
+
 @end

Microblink.xcframework/ios-arm64/Microblink.framework/Headers/MBRecognizer.h

@@ -11,7 +11,9 @@
 #import "MBEntity.h"
 #import "MBRecognizerResult.h"
 
+#if MB_RESULT_JSONIZATION
 @class MBSignedPayload;
+#endif
 
 NS_ASSUME_NONNULL_BEGIN
 
@@ -28,12 +30,14 @@ MB_CLASS_AVAILABLE_IOS(8.0)
 
 - (UIInterfaceOrientationMask)getOptimalHudOrientation;
 
+#if MB_RESULT_JSONIZATION
 /**
  * Returns the signed JSON representation of this entity's current state as a MBSignedPayload.
  *
  * @return signed JSON representation of this entity's current state.
  */
 - (MBSignedPayload *)toSignedJson;
+#endif
 
 @end