Merge pull request #56 from BlinkID/release/5.8.0

Release/5.8.0

Binding/Android/AndroidBinding.csproj

@@ -15,17 +15,18 @@
     <MonoAndroidAssetsPrefix>Assets</MonoAndroidAssetsPrefix>
     <AndroidClassParser>class-parse</AndroidClassParser>
     <PackageId>BlinkID.Android.Binding</PackageId>
-    <PackageVersion>5.7.1</PackageVersion>
+    <PackageVersion>5.8.0</PackageVersion>
     <Authors>Microblink</Authors>
     <Owners>Microblink</Owners>
     <PackageProjectUrl>https://github.com/blinkid/blinkid-xamarin</PackageProjectUrl>
-    <PackageReleaseNotes>Updated to BlinkID Android SDK v5.7.0
+    <PackageReleaseNotes>Updated to BlinkID Android SDK v5.8.0
 
-https://github.com/BlinkID/blinkid-android/releases/tag/v5.7.0</PackageReleaseNotes>
+https://github.com/BlinkID/blinkid-android/releases/tag/v5.8.0</PackageReleaseNotes>
     <Summary>A small, but powerful ID scanning library - native Android SDK binding package.</Summary>
     <Title>BlinkID</Title>
     <Description>A small, but powerful ID scanning library - native Android SDK binding package.</Description>
     <PackOnBuild>true</PackOnBuild>
+    <ReleaseVersion>4.0.0</ReleaseVersion>
   </PropertyGroup>
   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
     <DebugSymbols>true</DebugSymbols>

Binding/Android/Transforms/Metadata.xml

@@ -34,4 +34,6 @@
 
     <remove-node path="/api/package[@name='com.microblink.fragment']/class[@name='RecognizerRunnerFragment']/method[@name='onRequestPermissionsResult' and count(parameter)=3 and parameter[1][@type='int'] and parameter[2][@type='java.lang.String[]'] and parameter[3][@type='int[]']]" />
 
+    <remove-node path="/api/package[@name='com.microblink.licence']/class[@name!='InvalidLicenceKeyException' and @name!='LicenceKeyException' and @name!='LicenceLockedException' and @name!='NetworkRequiredException' and @name!='RemoteLicenceCheckException']" />
+
 </metadata>

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Android/BlinkID.Forms.Android.csproj

@@ -14,7 +14,7 @@
     <MonoAndroidResourcePrefix>Resources</MonoAndroidResourcePrefix>
     <MonoAndroidAssetsPrefix>Assets</MonoAndroidAssetsPrefix>
     <PackageId>BlinkID.Forms.Android</PackageId>
-    <PackageVersion>5.7.1</PackageVersion>
+    <PackageVersion>5.8.0</PackageVersion>
     <Authors>Microblink</Authors>
     <Owners>Microblink</Owners>
     <PackageProjectUrl>https://github.com/blinkid/blinkid-xamarin</PackageProjectUrl>
@@ -23,9 +23,9 @@
     <Description>A small, but powerful ID scanning library - Android implementation for Xamarin Forms.</Description>
     <ReleaseVersion>4.0.0</ReleaseVersion>
     <PackOnBuild>true</PackOnBuild>
-    <PackageReleaseNotes>Updated for BlinkID Android SDK v5.7.0
+    <PackageReleaseNotes>Updated for BlinkID Android SDK v5.8.0
 
-https://github.com/BlinkID/blinkid-android/releases/tag/v5.7.0</PackageReleaseNotes>
+https://github.com/BlinkID/blinkid-android/releases/tag/v5.8.0</PackageReleaseNotes>
     <!-- Workaround for build error  -->
     <DesignTimeBuild>false</DesignTimeBuild>
   </PropertyGroup>

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Android/Overlays/Implementations/BlinkIdOverlaySettings.cs

@@ -19,6 +19,7 @@ public override UISettings NativeUISettings {
 
                 concreteUISettings.SetDocumentDataMatchRequired(RequireDocumentSidesDataMatch);
                 concreteUISettings.SetShowNotSupportedDialog(ShowNotSupportedDialog);
+                concreteUISettings.SetShowFlashlightWarning(ShowFlashlightWarning);
                 concreteUISettings.SetBackSideScanningTimeoutMs(BackSideScanningTimeoutMilliseconds);
 
                 var overlayStringsBuilder = new ReticleOverlayStrings.Builder(Android.App.Application.Context);
@@ -96,6 +97,8 @@ public override UISettings NativeUISettings {
 
         public bool ShowNotSupportedDialog { get; set; } = true;
 
+        public bool ShowFlashlightWarning { get; set; } = true;
+
         public long BackSideScanningTimeoutMilliseconds { get; set; } = 17000;
 
         public BlinkIdOverlaySettings(IRecognizerCollection recognizerCollection)

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Android/Recognizers/Implementations/BlinkIdCombinedRecognizer.cs

@@ -87,12 +87,24 @@ public bool ReturnFullDocumentImage
             set => nativeRecognizer.SetReturnFullDocumentImage(value);
         }
 
+        public bool ReturnSignatureImage 
+        { 
+            get => nativeRecognizer.ShouldReturnSignatureImage(); 
+            set => nativeRecognizer.SetReturnSignatureImage(value);
+        }
+
         public bool SignResult 
         { 
             get => nativeRecognizer.ShouldSignResult(); 
             set => nativeRecognizer.SetSignResult(value);
         }
 
+        public uint SignatureImageDpi 
+        { 
+            get => (uint)nativeRecognizer.SignatureImageDpi; 
+            set => nativeRecognizer.SignatureImageDpi = (int)value;
+        }
+
         public bool SkipUnsupportedBack 
         { 
             get => nativeRecognizer.ShouldSkipUnsupportedBack(); 
@@ -158,5 +170,6 @@ internal BlinkIdCombinedRecognizerResult(Com.Microblink.Entities.Recognizers.Bli
         public string ResidentialStatus => nativeResult.ResidentialStatus;
         public bool ScanningFirstSideDone => nativeResult.IsScanningFirstSideDone;
         public string Sex => nativeResult.Sex;
+        public Xamarin.Forms.ImageSource SignatureImage => nativeResult.SignatureImage != null ? Utils.ConvertAndroidBitmap(nativeResult.SignatureImage.ConvertToBitmap()) : null;
     }
 }

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Android/Recognizers/Implementations/BlinkIdRecognizer.cs

@@ -87,6 +87,18 @@ public bool ReturnFullDocumentImage
             set => nativeRecognizer.SetReturnFullDocumentImage(value);
         }
 
+        public bool ReturnSignatureImage 
+        { 
+            get => nativeRecognizer.ShouldReturnSignatureImage(); 
+            set => nativeRecognizer.SetReturnSignatureImage(value);
+        }
+
+        public uint SignatureImageDpi 
+        { 
+            get => (uint)nativeRecognizer.SignatureImageDpi; 
+            set => nativeRecognizer.SignatureImageDpi = (int)value;
+        }
+
         public bool ValidateResultCharacters 
         { 
             get => nativeRecognizer.ShouldValidateResultCharacters(); 
@@ -138,6 +150,7 @@ internal BlinkIdRecognizerResult(Com.Microblink.Entities.Recognizers.Blinkid.Gen
         public string Religion => nativeResult.Religion;
         public string ResidentialStatus => nativeResult.ResidentialStatus;
         public string Sex => nativeResult.Sex;
+        public Xamarin.Forms.ImageSource SignatureImage => nativeResult.SignatureImage != null ? Utils.ConvertAndroidBitmap(nativeResult.SignatureImage.ConvertToBitmap()) : null;
         public IVizResult VizResult => new VizResult(nativeResult.VizResult);
     }
 }

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Android/Recognizers/Implementations/IdBarcodeRecognizer.cs

@@ -51,6 +51,7 @@ internal IdBarcodeRecognizerResult(Com.Microblink.Entities.Recognizers.Blinkid.I
         public string Jurisdiction => nativeResult.Jurisdiction;
         public string LastName => nativeResult.LastName;
         public string MaritalStatus => nativeResult.MaritalStatus;
+        public string MiddleName => nativeResult.MiddleName;
         public string Nationality => nativeResult.Nationality;
         public string PersonalIdNumber => nativeResult.PersonalIdNumber;
         public string PlaceOfBirth => nativeResult.PlaceOfBirth;

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Android/Recognizers/Implementations/UsdlCombinedRecognizer.cs

@@ -79,6 +79,10 @@ public string GetField(UsdlKeys key)
 
         public string FullName => nativeResult.FullName;
 
+        public string MiddleName => nativeResult.MiddleName;
+
+        public string NameSuffix => nativeResult.NameSuffix;
+
         public string Address => nativeResult.Address;
 
         public string DocumentNumber => nativeResult.DocumentNumber;

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Android/Recognizers/Implementations/UsdlRecognizer.cs

@@ -54,6 +54,10 @@ public string GetField(UsdlKeys key)
 
         public string FullName => nativeResult.FullName;
 
+        public string MiddleName => nativeResult.MiddleName;
+
+        public string NameSuffix => nativeResult.NameSuffix;
+
         public string Address => nativeResult.Address;
 
         public string Street => nativeResult.Street;

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Android/Recognizers/Types/BlinkIDTypes.cs

@@ -169,6 +169,8 @@ public BarcodeResult(Com.Microblink.Entities.Recognizers.Blinkid.Generic.Barcode
 
         public string FullName => nativeBarcodeResult.FullName;
 
+        public string MiddleName => nativeBarcodeResult.MiddleName;
+
         public string AdditionalNameInformation => nativeBarcodeResult.AdditionalNameInformation;
 
         public string Address => nativeBarcodeResult.Address;

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Core/BlinkID.Forms.Core.csproj

@@ -4,11 +4,11 @@
     <TargetFramework>netstandard1.0</TargetFramework>
     <PackOnBuild>true</PackOnBuild>
     <PackageId>BlinkID.Forms.Core</PackageId>
-    <PackageVersion>5.7.1</PackageVersion>
+    <PackageVersion>5.8.0</PackageVersion>
     <Authors>Microblink</Authors>
     <Owners>Microblink</Owners>
     <PackageProjectUrl>https://github.com/blinkid/blinkid-xamarin</PackageProjectUrl>
-    <PackageReleaseNotes>Updated for BlinkID Android and iOS SDKs v5.7.0</PackageReleaseNotes>
+    <PackageReleaseNotes>Updated for BlinkID Android and iOS SDKs v5.8.0</PackageReleaseNotes>
     <Summary>A small, but powerful ID scanning library - abstractions library for Xamarin Forms.</Summary>
     <Title>BlinkID</Title>
     <Description>A small, but powerful ID scanning library - abstractions library for Xamarin Forms.</Description>

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Core/Overlays/Concrete/IBlinkIdOverlaySettings.cs

@@ -75,6 +75,11 @@ public interface IBlinkIdOverlaySettings : IOverlaySettings
         /// </summary>
         bool ShowNotSupportedDialog { get; set; }
         /// <summary>
+        /// Defines whether glare  warning will be displayed when user turn on a flashlight
+        /// Default true
+        /// </summary>
+        bool ShowFlashlightWarning { get; set; }
+        /// <summary>
         /// Option to configure back side scanning timeout.
         /// Default 17000.
         /// </summary>

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Core/Recognizers/Concrete/IBlinkIdCombinedRecognizer.cs

@@ -112,6 +112,15 @@ public interface IBlinkIdCombinedRecognizer : IRecognizer
         /// </summary>
         bool ReturnFullDocumentImage { get; set; }
 
+        /// <summary>
+        /// Sets whether signature image from ID card should be extracted.
+        /// 
+        ///  
+        ///
+        /// By default, this is set to 'false'
+        /// </summary>
+        bool ReturnSignatureImage { get; set; }
+
         /// <summary>
         /// Whether or not recognition result should be signed.
         /// 
@@ -121,6 +130,16 @@ public interface IBlinkIdCombinedRecognizer : IRecognizer
         /// </summary>
         bool SignResult { get; set; }
 
+        /// <summary>
+        /// Property for setting DPI for signature images
+        /// Valid ranges are [100,400]. Setting DPI out of valid ranges throws an exception
+        /// 
+        ///  
+        ///
+        /// By default, this is set to '250'
+        /// </summary>
+        uint SignatureImageDpi { get; set; }
+
         /// <summary>
         /// Skip back side capture and processing step when back side of the document is not supported
         /// 
@@ -379,5 +398,10 @@ public interface IBlinkIdCombinedRecognizerResult : IRecognizerResult {
         /// </summary>
         string Sex { get; }
 
+        /// <summary>
+        /// image of the signature if enabled with returnSignatureImage property. 
+        /// </summary>
+        Xamarin.Forms.ImageSource SignatureImage { get; }
+
     }
 }

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Core/Recognizers/Concrete/IBlinkIdRecognizer.cs

@@ -112,6 +112,25 @@ public interface IBlinkIdRecognizer : IRecognizer
         /// </summary>
         bool ReturnFullDocumentImage { get; set; }
 
+        /// <summary>
+        /// Sets whether signature image from ID card should be extracted.
+        /// 
+        ///  
+        ///
+        /// By default, this is set to 'false'
+        /// </summary>
+        bool ReturnSignatureImage { get; set; }
+
+        /// <summary>
+        /// Property for setting DPI for signature images
+        /// Valid ranges are [100,400]. Setting DPI out of valid ranges throws an exception
+        /// 
+        ///  
+        ///
+        /// By default, this is set to '250'
+        /// </summary>
+        uint SignatureImageDpi { get; set; }
+
         /// <summary>
         /// Defines whether result characters validatation is performed.
         /// If a result member contains invalid character, the result state cannot be valid
@@ -317,6 +336,11 @@ public interface IBlinkIdRecognizerResult : IRecognizerResult {
         /// </summary>
         string Sex { get; }
 
+        /// <summary>
+        /// image of the signature if enabled with returnSignatureImage property. 
+        /// </summary>
+        Xamarin.Forms.ImageSource SignatureImage { get; }
+
         /// <summary>
         /// Defines the data extracted from the visual inspection zone 
         /// </summary>

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Core/Recognizers/Concrete/IIdBarcodeRecognizer.cs

@@ -130,6 +130,11 @@ public interface IIdBarcodeRecognizerResult : IRecognizerResult {
         /// </summary>
         string MaritalStatus { get; }
 
+        /// <summary>
+        /// The middle name of the document owner. 
+        /// </summary>
+        string MiddleName { get; }
+
         /// <summary>
         /// The nationality of the documet owner. 
         /// </summary>

Binding/Forms/BlinkID.Forms/BlinkID.Forms.Core/Recognizers/Concrete/IUsdlCombinedRecognizer.cs

@@ -33,7 +33,7 @@ public interface IUsdlCombinedRecognizer : IRecognizer
         /// Default value is <c>[0.0, 0.0, 0.0, 0.0]</c>
         /// </summary>
         IImageExtensionFactors FullDocumentImageExtensionFactors { get; set; }
-        
+
         /// <summary>
         /// Gets or sets the minimum number of stable detections required for detection to be successful.
         /// Default value is <c>6</c>
@@ -66,13 +66,13 @@ public interface IUsdlCombinedRecognizer : IRecognizer
     public interface IUsdlCombinedRecognizerResult : IRecognizerResult
     {
         /// <summary>
-        /// Gets the digital signature of the recognition result. Available only if enabled with SignResult property. 
+        /// Gets the digital signature of the recognition result. Available only if enabled with SignResult property.
         /// </summary>
         /// <value>The digital signature.</value>
         byte[] DigitalSignature { get; }
 
         /// <summary>
-        /// Gets the version of the digital signature. Available only if enabled with signResult property. 
+        /// Gets the version of the digital signature. Available only if enabled with signResult property.
         /// </summary>
         /// <value>The digital signature version.</value>
         uint DigitalSignatureVersion { get; }
@@ -81,32 +81,32 @@ public interface IUsdlCombinedRecognizerResult : IRecognizerResult
         /// Returns true if data from scanned parts/sides of the document match,
         /// false otherwise. 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 false. Result will
-        /// be true only if scanned values for all fields that are compared are the same. 
+        /// be true only if scanned values for all fields that are compared are the same.
         /// </summary>
         /// <value><c>true</c> if document data match; otherwise, <c>false</c>.</value>
         DataMatchResult DocumentDataMatch { get; }
 
         /// <summary>
-        /// Gets the face image from the document if enabled with ReturnFaceImage property. 
+        /// Gets the face image from the document if enabled with ReturnFaceImage property.
         /// </summary>
         /// <value>The face image.</value>
         Xamarin.Forms.ImageSource FaceImage { get; }
 
         /// <summary>
-        /// Gets the full document image if enabled with returnFullDocumentImage property. 
+        /// Gets the full document image if enabled with returnFullDocumentImage property.
         /// </summary>
         /// <value>The full document image.</value>
         Xamarin.Forms.ImageSource FullDocumentImage { get; }
 
         /// <summary>
         /// Returns true if recognizer has finished scanning first side and is now scanning back side,
-        /// false if it's still scanning first side. 
+        /// false if it's still scanning first side.
         /// </summary>
         /// <value><c>true</c> if scanning first side done; otherwise, <c>false</c>.</value>
         bool ScanningFirstSideDone { get; }
 
         /// <summary>
-        /// Gets a value indicating whether this result is uncertain, i.e. if scanned barcode 
+        /// Gets a value indicating whether this result is uncertain, i.e. if scanned barcode
         /// was incomplete (i.e. (has parts of it missing).
         /// </summary>
         /// <value><c>true</c> if uncertain; otherwise, <c>false</c>.</value>
@@ -149,6 +149,11 @@ public interface IUsdlCombinedRecognizerResult : IRecognizerResult
         /// </summary>
         string FirstName { get; }
 
+        /// <summary>
+        /// The middle name of the United States driver license owner.
+        /// </summary>
+        string MiddleName { get; }
+
         /// <summary>
         /// The last name of the United States driver license owner.
         /// </summary>
@@ -159,6 +164,11 @@ public interface IUsdlCombinedRecognizerResult : IRecognizerResult
         /// </summary>
         string FullName { get; }
 
+        /// <summary>
+        /// The name suffix of the United States driver license owner.
+        /// </summary>
+        string NameSuffix { get; }
+
         /// <summary>
         /// The full address of the United States driver license owner.
         /// </summary>