@microblink/blinkid-react-native 7.2.0 → 7.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/android/.gradle/8.9/checksums/checksums.lock +0 -0
- package/android/.gradle/8.9/checksums/md5-checksums.bin +0 -0
- package/android/.gradle/8.9/checksums/sha1-checksums.bin +0 -0
- package/android/.gradle/8.9/fileHashes/fileHashes.lock +0 -0
- package/android/.gradle/buildOutputCleanup/buildOutputCleanup.lock +0 -0
- package/android/.gradle/buildOutputCleanup/cache.properties +1 -1
- package/android/build.gradle +1 -1
- package/android/src/main/java/com/microblink/blinkid/reactnative/BlinkIdDeserializationUtilities.kt +2 -1
- package/android/src/main/java/com/microblink/blinkid/reactnative/BlinkIdSerializationUtilities.kt +21 -3
- package/android/src/main/java/com/microblink/blinkid/reactnative/BlinkidReactNativeModule.kt +14 -2
- package/ios/BlinkIdDeserializationUtilities.swift +3 -0
- package/ios/BlinkIdSerializationUtilities.swift +151 -53
- package/ios/BlinkidReactNativeModule.swift +22 -3
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/BlinkID +0 -0
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Headers/BlinkID-Swift.h +24563 -16979
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Info.plist +0 -0
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios.abi.json +14027 -608
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios.private.swiftinterface +462 -14
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios.swiftdoc +0 -0
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios.swiftinterface +462 -14
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/PrivateHeaders/SwiftCxxBridge.hpp +1 -0
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/_CodeSignature/CodeResources +17 -17
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/conan.xcconfig +3 -3
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/BlinkID +0 -0
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Headers/BlinkID-Swift.h +49697 -34548
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Info.plist +0 -0
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios-simulator.abi.json +14027 -608
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface +462 -14
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios-simulator.swiftdoc +0 -0
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios-simulator.swiftinterface +462 -14
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/x86_64-apple-ios-simulator.abi.json +14027 -608
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface +462 -14
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/x86_64-apple-ios-simulator.swiftdoc +0 -0
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/x86_64-apple-ios-simulator.swiftinterface +462 -14
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/PrivateHeaders/SwiftCxxBridge.hpp +1 -0
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/_CodeSignature/CodeResources +27 -27
- package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/conan.xcconfig +3 -3
- package/ios/Frameworks/BlinkIDUX.xcframework/Info.plist +5 -5
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/BlinkIDUX +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/Assets.car +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/Info.plist +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/hr.lproj/Localizable.strings +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Info.plist +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios.abi.json +708 -193
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios.package.swiftinterface +28 -41
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios.private.swiftinterface +28 -41
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios.swiftdoc +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios.swiftinterface +28 -41
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/Assets.car +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/Info.plist +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/_CodeSignature/CodeDirectory +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/_CodeSignature/CodeRequirements-1 +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/_CodeSignature/CodeResources +6 -6
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/hr.lproj/Localizable.strings +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Info.plist +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios-simulator.abi.json +708 -193
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios-simulator.package.swiftinterface +28 -41
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface +28 -41
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios-simulator.swiftdoc +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios-simulator.swiftinterface +28 -41
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/x86_64-apple-ios-simulator.abi.json +708 -193
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/x86_64-apple-ios-simulator.package.swiftinterface +28 -41
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface +28 -41
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/x86_64-apple-ios-simulator.swiftdoc +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/x86_64-apple-ios-simulator.swiftinterface +28 -41
- package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/_CodeSignature/CodeResources +1 -1
- package/lib/module/NativeBlinkidReactNative.js +4 -4
- package/lib/module/NativeBlinkidReactNative.js.map +1 -1
- package/lib/module/blinkIdResult.js +34 -1
- package/lib/module/blinkIdResult.js.map +1 -1
- package/lib/module/blinkIdSettings.js +272 -259
- package/lib/module/blinkIdSettings.js.map +1 -1
- package/lib/module/blinkIdUtilities.js +2 -2
- package/lib/module/index.js +19 -19
- package/lib/module/index.js.map +1 -1
- package/lib/module/types.js +30 -9
- package/lib/module/types.js.map +1 -1
- package/lib/typescript/src/NativeBlinkidReactNative.d.ts +1 -1
- package/lib/typescript/src/NativeBlinkidReactNative.d.ts.map +1 -1
- package/lib/typescript/src/blinkIdResult.d.ts +16 -1
- package/lib/typescript/src/blinkIdResult.d.ts.map +1 -1
- package/lib/typescript/src/blinkIdSettings.d.ts +193 -181
- package/lib/typescript/src/blinkIdSettings.d.ts.map +1 -1
- package/lib/typescript/src/index.d.ts +6 -6
- package/lib/typescript/src/index.d.ts.map +1 -1
- package/lib/typescript/src/types.d.ts +20 -1
- package/lib/typescript/src/types.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/NativeBlinkidReactNative.ts +25 -15
- package/src/blinkIdResult.ts +74 -74
- package/src/blinkIdSettings.ts +264 -250
- package/src/blinkIdUtilities.ts +4 -4
- package/src/index.tsx +56 -34
- package/src/types.ts +647 -688
- package/ios/Frameworks/BlinkIDUX.xcframework/_CodeSignature/CodeDirectory +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/_CodeSignature/CodeRequirements +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/_CodeSignature/CodeRequirements-1 +0 -0
- package/ios/Frameworks/BlinkIDUX.xcframework/_CodeSignature/CodeResources +0 -1575
- package/ios/Frameworks/BlinkIDUX.xcframework/_CodeSignature/CodeSignature +0 -0
package/src/blinkIdSettings.ts
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
import {
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
} from
|
|
2
|
+
DetectionLevel,
|
|
3
|
+
AnonymizationMode,
|
|
4
|
+
ScanningMode,
|
|
5
|
+
DocumentRules,
|
|
6
|
+
DocumentAnonymizationSettings,
|
|
7
|
+
RecognitionModeFilter,
|
|
8
|
+
} from "./types";
|
|
9
9
|
|
|
10
10
|
/**
|
|
11
11
|
* Settings for the initialization of the BlinkID SDK.
|
|
12
|
-
*
|
|
12
|
+
*
|
|
13
13
|
*/
|
|
14
14
|
export class BlinkIdSdkSettings {
|
|
15
15
|
/**
|
|
16
16
|
* License key for the native SDK.
|
|
17
|
-
*
|
|
17
|
+
*
|
|
18
18
|
*/
|
|
19
19
|
licenseKey: string;
|
|
20
20
|
|
|
@@ -26,23 +26,23 @@ export class BlinkIdSdkSettings {
|
|
|
26
26
|
/**
|
|
27
27
|
* Whether resources required for on-device image processing should be downloaded and cached
|
|
28
28
|
* on first initialization of the SDK.
|
|
29
|
-
*
|
|
29
|
+
*
|
|
30
30
|
* If set to false, you need to package all the required
|
|
31
31
|
* resources in your application's assets.
|
|
32
|
-
*
|
|
32
|
+
*
|
|
33
33
|
*/
|
|
34
34
|
downloadResources?: boolean;
|
|
35
35
|
|
|
36
36
|
/**
|
|
37
37
|
* If resources are to be downloaded, the following is the URL where the resources are hosted.
|
|
38
|
-
*
|
|
38
|
+
*
|
|
39
39
|
* URL: `"https://models.cdn.microblink.com/resources"`
|
|
40
40
|
*/
|
|
41
41
|
resourceDownloadUrl?: string;
|
|
42
42
|
|
|
43
43
|
/**
|
|
44
44
|
* Local folder name where resources will be downloaded and cached.
|
|
45
|
-
*
|
|
45
|
+
*
|
|
46
46
|
* If resources are being downloaded, this defines the name of the folder within your
|
|
47
47
|
* application's cache folder where resources will be cached.
|
|
48
48
|
*/
|
|
@@ -50,28 +50,42 @@ export class BlinkIdSdkSettings {
|
|
|
50
50
|
|
|
51
51
|
/**
|
|
52
52
|
* If resources downloading is disabled, this defines the bundle of your app where the resources reside.
|
|
53
|
-
*
|
|
53
|
+
*
|
|
54
54
|
*/
|
|
55
55
|
bundleURL?: string;
|
|
56
56
|
|
|
57
57
|
/**
|
|
58
58
|
* Timeout settings for resource downloads.
|
|
59
|
-
*
|
|
60
|
-
*/
|
|
59
|
+
*
|
|
60
|
+
*/
|
|
61
61
|
resourceRequestTimeout?: number;
|
|
62
|
+
/**
|
|
63
|
+
* Set a custom HTTPS URL to be used as a proxy for Ping and license checks.
|
|
64
|
+
* The proxy URL will be applied only if the license has the appropriate rights.
|
|
65
|
+
*
|
|
66
|
+
* The URL must use the HTTPS protocol. Example: https://your-proxy.com/
|
|
67
|
+
*
|
|
68
|
+
* If this value is defined, SDK initialization will not be successful in the following cases:
|
|
69
|
+
* - if the URL does not use HTTPS or if the URL is invalid
|
|
70
|
+
* - if the license does not allow proxy usage
|
|
71
|
+
*
|
|
72
|
+
*/
|
|
73
|
+
microblinkProxyURL?: string;
|
|
62
74
|
|
|
63
75
|
/**
|
|
64
|
-
*
|
|
65
|
-
* Settings for the initialization of the BlinkID SDK.
|
|
66
|
-
*/
|
|
76
|
+
*
|
|
77
|
+
* Settings for the initialization of the BlinkID SDK.
|
|
78
|
+
*/
|
|
67
79
|
constructor(
|
|
68
|
-
licenseKey: string,
|
|
69
|
-
licensee?: string,
|
|
70
|
-
downloadResources?: boolean,
|
|
80
|
+
licenseKey: string,
|
|
81
|
+
licensee?: string,
|
|
82
|
+
downloadResources?: boolean,
|
|
71
83
|
resourceDownloadUrl?: string,
|
|
72
84
|
resourceLocalFolder?: string,
|
|
73
85
|
bundleURL?: string,
|
|
74
|
-
resourceRequestTimeout?: number
|
|
86
|
+
resourceRequestTimeout?: number,
|
|
87
|
+
microblinkProxyURL?: string
|
|
88
|
+
) {
|
|
75
89
|
this.licenseKey = licenseKey;
|
|
76
90
|
this.licensee = licensee;
|
|
77
91
|
this.downloadResources = downloadResources;
|
|
@@ -79,12 +93,13 @@ export class BlinkIdSdkSettings {
|
|
|
79
93
|
this.resourceLocalFolder = resourceLocalFolder;
|
|
80
94
|
this.bundleURL = bundleURL;
|
|
81
95
|
this.resourceRequestTimeout = resourceRequestTimeout;
|
|
96
|
+
this.microblinkProxyURL = microblinkProxyURL;
|
|
82
97
|
}
|
|
83
98
|
}
|
|
84
99
|
|
|
85
100
|
/**
|
|
86
101
|
* Represents the configuration settings for a scanning session.
|
|
87
|
-
*
|
|
102
|
+
*
|
|
88
103
|
* This class holds the settings related to the resources initialization,
|
|
89
104
|
* scanning mode, and specific scanning configurations that define how the scanning
|
|
90
105
|
* session should behave.
|
|
@@ -92,31 +107,31 @@ export class BlinkIdSdkSettings {
|
|
|
92
107
|
export class BlinkIdSessionSettings {
|
|
93
108
|
/**
|
|
94
109
|
* The scanning mode to be used during the scanning session.
|
|
95
|
-
*
|
|
110
|
+
*
|
|
96
111
|
* Specifies whether the scanning is for a single side of a document or multiple
|
|
97
112
|
* sides, as defined in {@link ScanningMode}. The default is set to `automatic`, which
|
|
98
113
|
* automatically determines the number of sides to scan.
|
|
99
|
-
*
|
|
114
|
+
*
|
|
100
115
|
*/
|
|
101
116
|
scanningMode: ScanningMode;
|
|
102
117
|
|
|
103
|
-
/**
|
|
118
|
+
/**
|
|
104
119
|
* The specific scanning settings for the scanning session.
|
|
105
120
|
*
|
|
106
121
|
* Defines various parameters that control the scanning process.
|
|
107
|
-
*/
|
|
122
|
+
*/
|
|
108
123
|
scanningSettings: BlinkIdScanningSettings;
|
|
109
124
|
|
|
110
|
-
/**
|
|
125
|
+
/**
|
|
111
126
|
* Duration in seconds before scanning step times out and is cancelled.
|
|
112
|
-
*
|
|
127
|
+
*
|
|
113
128
|
* If less than zero, scanning will not time out.
|
|
114
129
|
* Defaults to 15000 (miliseconds)
|
|
115
|
-
*/
|
|
130
|
+
*/
|
|
116
131
|
stepTimeoutDuration: number;
|
|
117
132
|
|
|
118
|
-
/**
|
|
119
|
-
*
|
|
133
|
+
/**
|
|
134
|
+
*
|
|
120
135
|
* Represents the configuration settings for a scanning session.
|
|
121
136
|
*
|
|
122
137
|
* This class holds the settings related to the resources initialization,
|
|
@@ -132,282 +147,282 @@ export class BlinkIdSessionSettings {
|
|
|
132
147
|
|
|
133
148
|
/**
|
|
134
149
|
* Represents the configurable settings for scanning a document.
|
|
135
|
-
*
|
|
150
|
+
*
|
|
136
151
|
* This class defines various parameters and policies related to the scanning
|
|
137
152
|
* process, including image quality handling, data extraction and anonymization,
|
|
138
153
|
* along with options for frame processing and image extraction.
|
|
139
|
-
*
|
|
140
|
-
* */
|
|
154
|
+
*
|
|
155
|
+
* */
|
|
141
156
|
export class BlinkIdScanningSettings {
|
|
142
157
|
/**
|
|
143
158
|
* The level of blur detection in the document image.
|
|
144
|
-
*
|
|
159
|
+
*
|
|
145
160
|
* Defines the severity of blur detected in the document image, as defined
|
|
146
161
|
* in [DetectionLevel]. Values range from `off` (detection NotAvailable) to higher
|
|
147
162
|
* levels of blur detection.
|
|
148
|
-
*
|
|
163
|
+
*
|
|
149
164
|
* `low` – less sensitive to blur; if something is detected as blur, it is almost certainly actual blur,
|
|
150
165
|
* but some amount of blur may not be detected at all.
|
|
151
166
|
* `high` – highly sensitive to blur; it may detect as blur even something that only resembles blur.
|
|
152
|
-
*
|
|
153
|
-
* Default: {@link DetectionLevel.Mid}
|
|
154
|
-
* */
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
/**
|
|
158
|
-
* Indicates whether images with blur in the document image should be skipped.
|
|
159
|
-
*
|
|
160
|
-
* A value of `true` means images with detected blur will be excluded from further processing to prevent blurred images from being used
|
|
161
|
-
* - If blurDetectionLevel = `off` - blurred images will be processed
|
|
162
|
-
* - If blur is detected `ProcessingStatus` will be `ImagePreprocessingFailed` and blur will be reported in the `ProcessResult`
|
|
163
|
-
* A value of `false` means images with detected blur will not be excluded from further processing
|
|
164
|
-
* - If blurDetectionLevel != `off` - even if blur is detected, the image will be processed and blur will be reported in the `ProcessResult`.
|
|
165
|
-
*
|
|
166
|
-
* Default: `true`
|
|
167
|
-
*/
|
|
168
|
-
skipImagesWithBlur: boolean
|
|
167
|
+
*
|
|
168
|
+
* Default: {@link DetectionLevel.Mid}
|
|
169
|
+
* */
|
|
170
|
+
blurDetectionLevel: DetectionLevel;
|
|
169
171
|
|
|
170
|
-
/**
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
172
|
+
/**
|
|
173
|
+
* Indicates whether images with blur in the document image should be skipped.
|
|
174
|
+
*
|
|
175
|
+
* A value of `true` means images with detected blur will be excluded from further processing to prevent blurred images from being used
|
|
176
|
+
* - If blurDetectionLevel = `off` - blurred images will be processed
|
|
177
|
+
* - If blur is detected `ProcessingStatus` will be `ImagePreprocessingFailed` and blur will be reported in the `ProcessResult`
|
|
178
|
+
* A value of `false` means images with detected blur will not be excluded from further processing
|
|
179
|
+
* - If blurDetectionLevel != `off` - even if blur is detected, the image will be processed and blur will be reported in the `ProcessResult`.
|
|
180
|
+
*
|
|
181
|
+
* Default: `true`
|
|
182
|
+
*/
|
|
183
|
+
skipImagesWithBlur: boolean;
|
|
184
|
+
|
|
185
|
+
/**
|
|
186
|
+
* The level of glare detection in the document image.
|
|
187
|
+
*
|
|
188
|
+
* Defines the severity of glare detected in the document image, as defined in [DetectionLevel].
|
|
189
|
+
* Values range from `off` (detection NotAvailable) to higher levels of glare detection.
|
|
190
|
+
* `low` – less sensitive to glare; if something is detected as glare, it is almost certainly actual glare,
|
|
191
|
+
* but some amount of glare may not be detected at all.
|
|
192
|
+
* `high` – highly sensitive to glare; it may detect as glare even something that only resembles glare.
|
|
193
|
+
*
|
|
194
|
+
* Default: {@link DetectionLevel.Mid}
|
|
180
195
|
*/
|
|
181
196
|
glareDetectionLevel: DetectionLevel;
|
|
182
197
|
|
|
183
198
|
/**
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
199
|
+
* Indicates whether images with glare in the document image should be skipped.
|
|
200
|
+
*
|
|
201
|
+
* A value of `true` means images with detected glare will be excluded from further processing to prevent glared images from being used
|
|
202
|
+
* - If glareDetectionLevel = `off` - glared images will be processed
|
|
203
|
+
* - If glare is detected `ProcessingStatus` will be `ImagePreprocessingFailed` and glare will be reported in the `ProcessResult`
|
|
204
|
+
* A value of `false` means images with detected glare will not be excluded from further processing
|
|
205
|
+
* - If glareDetectionLevel != `off` - even if glare is detected, the image will be processed and glare will be reported in the `ProcessResult`
|
|
206
|
+
*
|
|
207
|
+
* Default: `true`
|
|
208
|
+
*/
|
|
194
209
|
skipImagesWithGlare: boolean;
|
|
195
210
|
|
|
196
211
|
/**
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
212
|
+
* The level of allowed detected tilt of the document in the image.
|
|
213
|
+
*
|
|
214
|
+
* Defines the severity of allowed detected tilt of the document in the image, as defined in [DetectionLevel].
|
|
215
|
+
* Values range from `off` (detection NotAvailable) to higher levels of allowed tilt.
|
|
216
|
+
* `low` – less sensitive to tilt.
|
|
217
|
+
* `high` – highly sensitive to tilt.
|
|
218
|
+
*
|
|
219
|
+
* Default: {@link DetectionLevel.off}
|
|
205
220
|
*/
|
|
206
221
|
tiltDetectionLevel: DetectionLevel;
|
|
207
222
|
|
|
208
223
|
/**
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
224
|
+
* Indicates whether images with inadequate lighting conditions should be rejected.
|
|
225
|
+
*
|
|
226
|
+
* Inadequate lighting conditions are represented as either `TooBright` or `TooDark` document images,
|
|
227
|
+
* as defined in the `ImageAnalysisLightingStatus` enum.
|
|
228
|
+
* A value of `true` means images with inadequate lighting conditions will be excluded from further processing to prevent images with
|
|
229
|
+
* inadequate lighting from being used
|
|
230
|
+
* - If inadequate light conditions are detected `ProcessingStatus` will be `ImagePreprocessingFailed` and lighting status will be
|
|
231
|
+
* reported in the `ProcessResult`.
|
|
232
|
+
*
|
|
233
|
+
* Default: `true`
|
|
219
234
|
*/
|
|
220
235
|
skipImagesWithInadequateLightingConditions: boolean;
|
|
221
236
|
|
|
222
|
-
/**
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
237
|
+
/**
|
|
238
|
+
* Indicates whether images occluded by hand should be rejected.
|
|
239
|
+
*
|
|
240
|
+
* A value of `true` means images occluded by hand will be excluded from further processing to prevent occluded images from being used
|
|
241
|
+
* - If hand occlusion is detected `ProcessingStatus` will be `ImagePreprocessingFailed` and hand occlusion status will be reported
|
|
242
|
+
* in the `ProcessResult`
|
|
243
|
+
* This setting is applicable only if `scanCroppedDocumentImage` = false.
|
|
244
|
+
*
|
|
245
|
+
* Default: `true`
|
|
231
246
|
*/
|
|
232
247
|
skipImagesOccludedByHand: boolean;
|
|
233
248
|
|
|
234
|
-
/**
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
249
|
+
/**
|
|
250
|
+
* Indicates whether the aggregation of data from multiple images is enabled.
|
|
251
|
+
*
|
|
252
|
+
* Disabling this setting will yield higher-quality captured images, but it may slow down the scanning process due to the additional
|
|
253
|
+
* effort required to find the optimal image.
|
|
254
|
+
* Enabling this setting will simplify the extraction process, but the extracted data will be aggregated from multiple images instead
|
|
255
|
+
* of being sourced from a single image.
|
|
256
|
+
* This only applies to images from Video input image source - for images from Photo source, setting will be ignored.
|
|
257
|
+
*
|
|
258
|
+
* Default: `true`
|
|
244
259
|
*/
|
|
245
260
|
combineResultsFromMultipleInputImages: boolean;
|
|
246
261
|
|
|
247
262
|
/**
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
263
|
+
* Enables barcode recognition to proceed even if the initial VIZ extraction fails.
|
|
264
|
+
*
|
|
265
|
+
* If the barcode recognition is successful, recognition will still end in a valid state.
|
|
266
|
+
* This setting is applicable only to images from Photo source.
|
|
267
|
+
* For multi-side scanning, it is permitted only for the back side.
|
|
268
|
+
*
|
|
269
|
+
* Default: `false`
|
|
255
270
|
*/
|
|
256
271
|
enableBarcodeScanOnly: boolean;
|
|
257
272
|
|
|
258
|
-
/**
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
273
|
+
/**
|
|
274
|
+
* Defines custom rules for specific document class.
|
|
275
|
+
*
|
|
276
|
+
* When defining [DocumentRules], [DocumentFilter] is optionally set to specify the document to which the rule applies, and a `fields` with
|
|
277
|
+
* the appropriate `alphabetType` should be specified as mandatory for that document.
|
|
278
|
+
* If a `fields` is set to a field that is optional for that document or does not exist on it, all fields on the document become optional.
|
|
279
|
+
* If a `fields` is set to a field with an incorrect alphabetType, all fields on the document become optional.
|
|
280
|
+
* If a `fields` is set to a field that doesn’t exist in the internal rules, that rule is ignored.
|
|
281
|
+
* When adding multiple `fields`, any field that does not match our rules is ignored. Only fields that comply with our rules are set as mandatory.
|
|
282
|
+
* If the documentFilter fields `country`, `region`, or `type` are set to `null`, all supported values for those fields will be considered.
|
|
283
|
+
* For example, if `country = null`, the rule will apply to all supported countries in BlinkID.
|
|
284
|
+
*
|
|
285
|
+
* By default, document fields are validated using internal rules that define mandatory fields for the scanned document class. This setting allows
|
|
286
|
+
* users to narrow down our internal rules on mandatory fields. All undefined fields will become optional. It is not possible to mark fields as
|
|
287
|
+
* mandatory if they cannot theoretically appear on the document.
|
|
288
|
+
* The more detailed document filter will have priority over the other.
|
|
289
|
+
*
|
|
290
|
+
* See {@link DocumentRules} for more detailed information.
|
|
276
291
|
*/
|
|
277
292
|
customDocumentRules?: DocumentRules[];
|
|
278
293
|
|
|
279
|
-
/**
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
294
|
+
/**
|
|
295
|
+
* The mode of anonymization applied to the document.
|
|
296
|
+
*
|
|
297
|
+
* Redact specific fields based on requirements or laws regarding a specific document.
|
|
298
|
+
* Data can be redacted from the image, the result or both.
|
|
299
|
+
*
|
|
300
|
+
* Default: {@link AnonymizationMode.fullResult}
|
|
286
301
|
*/
|
|
287
302
|
anonymizationMode: AnonymizationMode;
|
|
288
303
|
|
|
289
|
-
/**
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
304
|
+
/**
|
|
305
|
+
* Redact fields for specific document class.
|
|
306
|
+
*
|
|
307
|
+
* Fields specified by requirements or laws for a specific document will be redacted regardless of this setting.
|
|
308
|
+
* Based on anonymizationMode setting, data will be redacted from the image, the result or both.
|
|
309
|
+
*
|
|
310
|
+
* See {@link DocumentAnonymizationSettings} for more information.
|
|
296
311
|
*/
|
|
297
312
|
customDocumentAnonymizationSettings?: DocumentAnonymizationSettings[];
|
|
298
|
-
/**
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
313
|
+
/**
|
|
314
|
+
* Indicates whether input images should be returned.
|
|
315
|
+
*
|
|
316
|
+
* Save the input images at the moment of the data extraction or timeout.
|
|
317
|
+
* This significantly increases memory consumption. The scanning performance is not affected.
|
|
318
|
+
*
|
|
319
|
+
* Default: `false`
|
|
305
320
|
*/
|
|
306
321
|
returnInputImages: boolean;
|
|
307
322
|
|
|
308
|
-
/**
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
323
|
+
/**
|
|
324
|
+
* Process only cropped document images.
|
|
325
|
+
* Requires the input image to consist solely of the cropped document image with perspective correction applied.
|
|
326
|
+
* This only applies to images from Photo input image source - for images from Video input image source, setting will be ignored.
|
|
327
|
+
*
|
|
328
|
+
* Default: `false`
|
|
314
329
|
*/
|
|
315
330
|
scanCroppedDocumentImage: boolean;
|
|
316
331
|
|
|
317
|
-
/**
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
332
|
+
/**
|
|
333
|
+
* The filter for recognition modes.
|
|
334
|
+
*
|
|
335
|
+
* Specifies which recognition modes are enabled during the scanning process, with a default value of true to enable all modes.
|
|
336
|
+
* [RecognitionModeFilter] is used to enable/disable recognition of specific document groups.
|
|
337
|
+
*
|
|
338
|
+
* This setting is experimental and it will be removed in upcoming releases.
|
|
339
|
+
*
|
|
340
|
+
* By default all modes are enabled (set to `true`).
|
|
326
341
|
*/
|
|
327
342
|
recognitionModeFilter: RecognitionModeFilter;
|
|
328
343
|
|
|
329
|
-
/**
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
344
|
+
/**
|
|
345
|
+
* Indicates whether character validation is enabled.
|
|
346
|
+
*
|
|
347
|
+
* Allow only results containing expected characters for a given field.
|
|
348
|
+
* Each field is validated against a set of rules.
|
|
349
|
+
* All fields have to be successfully validated in order to successfully scan a document.
|
|
350
|
+
* Setting is used to improve scanning accuracy.
|
|
351
|
+
* If set to `true`, when an invalid character is detected `ProcessingStatus.InvalidCharactersFound` is returned.
|
|
352
|
+
*
|
|
353
|
+
* Default: `true`
|
|
339
354
|
*/
|
|
340
355
|
enableCharacterValidation: boolean;
|
|
341
356
|
|
|
342
|
-
/**
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
357
|
+
/**
|
|
358
|
+
* Defines the minimum required margin (in percentage) between the edge of the input image and the document.
|
|
359
|
+
*
|
|
360
|
+
* The setting is applicable only when using images from Video source.
|
|
361
|
+
* The setting is not applicable if `scanCroppedDocumentImage = true` (it will be ignored).
|
|
362
|
+
* This setting is implemented to comply with regulations in certain countries that mandate documents
|
|
363
|
+
* to be stored with adequate margins in the image.
|
|
364
|
+
*
|
|
365
|
+
* Default: `0.02` (also recommended value)
|
|
351
366
|
*/
|
|
352
367
|
inputImageMargin: number;
|
|
353
368
|
|
|
354
|
-
/**
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
369
|
+
/**
|
|
370
|
+
* Indicates whether backside of unsupported document should be scanned also.
|
|
371
|
+
*
|
|
372
|
+
* By default, back side of the document will not be scanned if only the front side is supported for a specific
|
|
373
|
+
* document.
|
|
374
|
+
*
|
|
375
|
+
* Default: `false`
|
|
361
376
|
*/
|
|
362
377
|
scanUnsupportedBack: boolean;
|
|
363
378
|
|
|
364
|
-
/**
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
379
|
+
/**
|
|
380
|
+
* Indicates whether scanning can continue to the next side despite an uncertain front-side scan.
|
|
381
|
+
*
|
|
382
|
+
* This only applies to images from Photo input image source - for images from Video source, setting will be
|
|
383
|
+
* ignored.
|
|
384
|
+
*
|
|
385
|
+
* Default: `false`
|
|
386
|
+
*/
|
|
372
387
|
allowUncertainFrontSideScan: boolean;
|
|
373
388
|
|
|
374
|
-
/**
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
389
|
+
/**
|
|
390
|
+
* The maximum allowed mismatches per field during data matching.
|
|
391
|
+
*
|
|
392
|
+
* Configures the maximum number of characters per field that can be inconsistent during data matching.
|
|
393
|
+
* By defualt, no mismatches are allowed.
|
|
394
|
+
*
|
|
395
|
+
* Default: `0`
|
|
396
|
+
*/
|
|
382
397
|
maxAllowedMismatchesPerField: number;
|
|
383
398
|
|
|
384
|
-
/**
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
399
|
+
/**
|
|
400
|
+
* Indicates whether only the passport data page should be scanned.
|
|
401
|
+
*
|
|
402
|
+
* Scan only the data page ( page containing MRZ ) of the passport.
|
|
403
|
+
* If set to `false`, it will be required to scan the second page of certain passports.
|
|
404
|
+
*
|
|
405
|
+
* Default: `true`
|
|
391
406
|
*/
|
|
392
407
|
scanPassportDataPageOnly: boolean;
|
|
393
408
|
|
|
394
|
-
/**
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
409
|
+
/**
|
|
410
|
+
* Configures the image processing settings during the scanning process.
|
|
411
|
+
*
|
|
412
|
+
* Allows customization of cropped image handling, such as dotsPerInch, extensions, and
|
|
413
|
+
* whether images should be returned for the document, face or signature regions.
|
|
414
|
+
*
|
|
415
|
+
* See {@link CroppedImageSettings} for more information.
|
|
401
416
|
*/
|
|
402
417
|
croppedImageSettings: CroppedImageSettings;
|
|
403
418
|
|
|
404
|
-
/**
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
419
|
+
/**
|
|
420
|
+
* Represents the configurable settings for scanning a document.
|
|
421
|
+
*
|
|
422
|
+
* This class defines various parameters and policies related to the scanning
|
|
423
|
+
* process, including image quality handling, data extraction and anonymization,
|
|
424
|
+
* along with options for frame processing and image extraction.
|
|
425
|
+
*/
|
|
411
426
|
constructor() {
|
|
412
427
|
this.blurDetectionLevel = DetectionLevel.Mid;
|
|
413
428
|
this.skipImagesWithBlur = true;
|
|
@@ -435,22 +450,21 @@ export class BlinkIdScanningSettings {
|
|
|
435
450
|
/**
|
|
436
451
|
* Allows customization of various aspects of the UI
|
|
437
452
|
* used during the scanning process.
|
|
438
|
-
*
|
|
453
|
+
*
|
|
439
454
|
*/
|
|
440
455
|
export class BlinkIdUiSettings {
|
|
441
|
-
|
|
442
456
|
/**
|
|
443
457
|
* A boolean indicating whether to show a help button
|
|
444
458
|
* and enable help screens during the scanning session.
|
|
445
|
-
*
|
|
459
|
+
*
|
|
446
460
|
* Default: `true`
|
|
447
461
|
*/
|
|
448
|
-
showHelpButton: boolean
|
|
462
|
+
showHelpButton: boolean;
|
|
449
463
|
|
|
450
464
|
/**
|
|
451
465
|
* A boolean indicating whether to show an onboarding dialog
|
|
452
466
|
* at the beginning of the scanning session.
|
|
453
|
-
*
|
|
467
|
+
*
|
|
454
468
|
* Default: `true`
|
|
455
469
|
*/
|
|
456
470
|
showOnboardingDialog: boolean;
|
|
@@ -463,47 +477,47 @@ export class BlinkIdUiSettings {
|
|
|
463
477
|
|
|
464
478
|
/**
|
|
465
479
|
* Represents the image cropping settings.
|
|
466
|
-
*
|
|
480
|
+
*
|
|
467
481
|
*/
|
|
468
482
|
export class CroppedImageSettings {
|
|
469
483
|
/**
|
|
470
484
|
* The DPI value for the cropped image.
|
|
471
|
-
*
|
|
485
|
+
*
|
|
472
486
|
* Default: `250`
|
|
473
487
|
*/
|
|
474
488
|
dotsPerInch: number;
|
|
475
489
|
|
|
476
490
|
/**
|
|
477
491
|
* The extension factor for the cropped image.
|
|
478
|
-
*
|
|
492
|
+
*
|
|
479
493
|
* Default: `0`
|
|
480
494
|
*/
|
|
481
495
|
extensionFactor: number;
|
|
482
496
|
|
|
483
497
|
/**
|
|
484
498
|
* Indicates whether the document image should be returned.
|
|
485
|
-
*
|
|
499
|
+
*
|
|
486
500
|
* Default: `false`
|
|
487
501
|
*/
|
|
488
502
|
returnDocumentImage: boolean;
|
|
489
503
|
|
|
490
504
|
/**
|
|
491
505
|
* Indicates whether the face image should be returned.
|
|
492
|
-
*
|
|
506
|
+
*
|
|
493
507
|
* Default: `false`
|
|
494
508
|
*/
|
|
495
509
|
returnFaceImage: boolean;
|
|
496
510
|
|
|
497
511
|
/**
|
|
498
512
|
* Indicates whether the signature image should be returned.
|
|
499
|
-
*
|
|
513
|
+
*
|
|
500
514
|
* Default: `false`
|
|
501
515
|
*/
|
|
502
|
-
returnSignatureImage: boolean
|
|
516
|
+
returnSignatureImage: boolean;
|
|
503
517
|
|
|
504
518
|
/**
|
|
505
519
|
* Represents the image cropping settings.
|
|
506
|
-
*
|
|
520
|
+
*
|
|
507
521
|
*/
|
|
508
522
|
constructor() {
|
|
509
523
|
this.dotsPerInch = 250;
|
|
@@ -512,4 +526,4 @@ export class CroppedImageSettings {
|
|
|
512
526
|
this.returnFaceImage = false;
|
|
513
527
|
this.returnSignatureImage = false;
|
|
514
528
|
}
|
|
515
|
-
}
|
|
529
|
+
}
|