Releases: BlinkID/blinkid-ios
v5.0.2
-
Updates and additions:
- new options in
MBBlinkIdOverlaySettings
:- option to disable displaying of "Document Not Supported" dialog when
MBBlinkIdRecognizer
orMBBlinkIdCombinedRecognizer
is used in combination with other recognizers - use methodshowNotSupportedDialog
- option to configure back side scanning timeout - use
backSideScanningTimeout
- option to disable displaying of "Document Not Supported" dialog when
- new options in
-
Minor API changes:
- methods
pauseScanning
andresumeScanningAndResetState
inMBRecognizerRunnerViewController
do not return anymoreBOOL
- use
isScanningPaused
to check if scanning is paused
- use
- methods
-
Bugfixes:
- fixed issue where recognizer's result state would not be the same as recognizer's runner state after finished scanning
- fixed issue when pressing immediately close button on overlay view controllers would freeze for couple of seconds SDK
v5.0.1
- Updates and fixes:
- Added missing option to remove Microblink branding on
MBBlinkIdOverlayViewController
- contact help.microblink.com. - Fixed turning on flashlight in our overlay view controllers on iOS 13.1.3
- Added missing option to remove Microblink branding on
v5.0.0
BlinkID v5 Release Announcement
We are very proud to announce BlinkID v5, the latest upgrade of our most popular product. BlinkID v5 is our first product powered entirely by machine learning.
Highlights in the BlinkID v5 Release
BlinkID v5 introduces improvements in the speed and accuracy of scanning and data extraction, and you will find:
- Best-in-class card detection.
- Automatic classification of different document types (no need to preselect the country or document type).
- Innovative and seamless UX with real-time instructions for the users.
- Data matching – we match the expiry date, DOB, date of issue, and document number captured from the front side with the data from the barcode or MRZ on the back.
Besides the new features listed above, we have worked on the improved performance of several other document components:
- Scanning of all documents with MRZ (IDs, passports, travel visas), or PDF417 barcodes.
- Scanning and data extraction of the front side of US driver’s licenses and IDs (horizontal).
- Capturing cropped face image supported even on vertical documents, passports and travel visas.
- Capturing document image.
Integration improvements
One of the main benefits that BlinkID v5 will bring is scalability and faster support for new document types.
- The integration of the mobile SDK will be significantly easier and faster.
- Mobile SDK build size will be much smaller.
How to get started and plan your upgrade?
BlinkID v5 mobile SDK release is currently available for native platforms.
- It’s advisable to get familiar with the range of supported document types. We will keep adding support for new documents and regularly update the list on Github.
- If currently supported document types are not yet supported in BlinkID v5 please follow future releases.
- To upgrade to BlinkID v5, you will need to obtain a new license key specifically for the document types that you require.
- Already licensed production keys will continue to work as usual, until you decide to upgrade.
- What if you require document types supported in the previous version (and not yet added in BlinkID v5) and another document type supported in BlinkID v5? That’s manageable, and in that case, we will create a custom build for you.
We strongly recommend checking the list of supported document types regularly. Please star and watch this repository, and take the time to test BlinkID v5 as much as possible.
Your opinion, especially on the performance and redesigned UX is very important for future developments. We would appreciate your feedback at [email protected].
Major API changes:
- removed all country specific recognizers
- `MBBlinkIdRecognizer` and `MBBlinkIdCombinedRecognizer` are recognizers that classify and extract data from all country specific recognizers available in 4.x.x versions
- available recognizers are:
- `BlinkIdRecognizer`
- `BlinkIdCombinedRecognizer`
- `MBPassportRecognizer`
- `MBVisaRecognizer`
- `MBDocumentFaceRecognizer`
- `MBMrtdRecognizer`
- `MBMrtdCombinedRecognizer`
- `MBUsdlRecognizer`
- `MBUsdlCombinedRecognizer`
- parsers and detectors are removed from this version onward
- Templating API is no longer supported
- `field by field` scanning feature is no longer supported
- Swift Module has been renamed from `MicroBlink` to `Microblink`
- this will cause Swift project to crash at compile time so please do `import Microblink` from now on
New features:
- updated `MBBlinkIdRecognizer` and `MBBlinkIdCombinedRecognizer` with new document types for different countries
- you can check [list of supported document types](https://github.com/BlinkID/blinkid-ios/blob/master/documentation/BlinkIDRecognizer.md)
Minor API changes:
- in combined recognizers results, `documentDataMatch` value is now returned as `MBDataMatchResult` enum with three possible values: `NotPerformed`, `Failed` and `Success`
v4.11.0
-
Updates and additions:
- added support for reading front and back side of Belgium ID - use
MBBelgiumIdFrontRecognizer
,MBBelgiumIdBackRecognizer
andMBelgiumCombinedRecognizer
- added support for reading all visa documents containing Machine Readable Zone - use
MBVisaRecognizer
- added support for reading front and back side of Belgium ID - use
-
Improvements in ID scanning performance:
- improved
MBMrtdRecognizer
:- added support for documents with non-binary gender specification (symbol X)
- improved
MBDocumentFaceRecognizer
:- improved scanning time (faster scan)
- added support for vertical IDs
- removed the
tryBothOrientations
option (improved scan in all directions is enabled by default)
- improved scanning time (faster scan) for
MBPassportRecognizer
- improved
v4.10.0
Major improvements for US documents
As announced on several occasions this year, we are very proud to present new features for scanning of the US identity cards and driver’s licenses.
- Data extraction from the front side of the US identity documents.
- Best-in-class card detection.
- Scanning and data extraction data from the barcode on the back side.
- Data matching – we match the extracted information captured from the front side with the information from the barcode on the back.
- Redesigned UX to make the process more intuitive for end users.
On top of the above-mentioned new features, existing ones, such as face image and document image extraction, are still available.
Important notes on the upcoming release:
- Existing features that you have already purchased can be used along with the new features.
- Existing license keys that cover US documents will work as usual, until you decide to update to the new features.
- In order to use the new features in your app, you need to obtain a new license key specifically for the document types that you require.
We invite you to follow the release and the documentation on Github and to try new features through our Developer Dashboard. Your opinion on this release, and especially on the redesigned UX is highly valuable to us. Please leave us feedback at [email protected].
Release notes
-
Updates and additions:
- added
MBBlinkIdRecognizer
for scanning front side of ID cards andMBBlinkIdCombinedRecognizer
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
andMBBlinkIdCombinedRecognizer
- other single side and combined document recognizers are also supported
- best suited for scanning with
- added
-
added support for reading back side of Nigerian Voter ID card - use
MBNigeriaVoterIdBackRecognizer
-
Improvements in ID scanning performance:
- improved
MBRomaniaIdFrontRecognizer
- now extracts
CNP
number
- now extracts
- improved
MBSloveniaIdFrontRecognizer
andMBloveniaCombinedRecognizer
:- return boolean flag which indicates whether date of expiry is permanent - use
dateOfExpiryPermanent
- return boolean flag which indicates whether date of expiry is permanent - use
- 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 numberMBMalaysiaIkadFrontRecognizer
- 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
andMBUnitedArabEmiratesIdBackRecognizer
MBUnitedArabEmiratesIdBackRecognizer
- optimized detection for black backgrounds
- glare detection is disabled by default for
- improved
-
Bugfixes:
- fixed bug in
MBBlinkCardOverlayViewController
which caused memory issues
- fixed bug in
v4.9.1
- Bugfixes:
- fixed bug in
MBDocumentFaceRecognizer
which caused that DPI settings has not been applied to dewarped image
- fixed bug in
v4.9.0
-
Updates and additions:
- added support for reading all passports with MRZ - use
MBPassportRecognizer
- added setting on
MBDocumentFaceRecognizer
for control over face image processor - usetryBothOrientations
- added result property on
MBGermanyCombinedRecognizerResult
to get full mrz string result - userawMrzString
- added support for reading all passports with MRZ - use
-
Improvements in ID scanning performance:
- added support for reading commercial code in two rows for
MBHongKongIdFrontRecognizer
- added support for
MBHongKongIdFrontRecognizer
2018 version - improved reading accuracy for the following recognizers (DeepOCR support):
MBMalaysiaIKadFrontRecognizer
- improved scanning time of all Malaysian ID front recognizers: MyKad, MyKAS, MyPR, MyTentera
- added support for reading commercial code in two rows for
-
Minor API changes:
partialRecognitionTimeout
inMBRecognizerCollection
default value has been changed to 0 which means no timeout will be reported in which partial scanning results will be returned to the user
-
Bugfixes:
- fixed issue with combining surnames in
MBGermanyCombinedRecognizer
's logic - fixed a validation issue for the gender field in
MBSloveniaCombinedRecognizer
- fixed DPI options on images are now correctly applied to dewarped image results in
MBDocumentFaceRecognizer
- fixed issue with combining surnames in
v4.8.0
Important notice on MRTD recognizer in the latest BlinkID SDK release (v 4.8.0.)
Please note that we have significantly improved accuracy for MRZ/MRTD scanning because now we switched to the newest OCR technology based on machine learning.
To be more precise, we measured and compared existing vs. new MRTD scanning. The new OCR system based on machine learning achieves 99.9% accuracy on the character level, which results with a 50% reduction in the error rate in MRZ extraction.
In order to use new MrtdRecognizer or MrtdCombinedRecognizer or to continue using any additional Recognizer for scanning any ID with the MRZ (machine readable zone) within the latest BlinkID SDK update, you must have a new license key. Before updating to the SDK version 4.8.0, please contact your account manager or send an email to [email protected] to obtain the new production license key.
Important notes:
- The MRTD scanning with the older BlinkID SDK versions (v 4.7.0 and below) will continue to work without any problems - until you decide to update.
- If you upgrade to the SDK version 4.8.0 without a new license key scanning of MRTD/MRZ documents will not work.
- Contact us at [email protected] to obtain a new license key if you plan to update your app with the latest release.
For any questions, you might have, we stand at your service.
-
Updates and additions:
- added support for reading front side of Brunei Military ID - use
MBBruneiMilitaryIdFrontRecognizer
- added support for reading back side of Brunei Military ID - use
MBBruneiMilitaryIdBackRecognizer
- added support for reading front side of Brunei Military ID - use
-
Minor API changes:
- all recognizers for Serbia have been removed from this version
- fields that are not deprecated anymore:
- Sweden DL - reference number
- Ireland DL - driver number
- Malaysia iKad - passport number
- Hong Kong ID - commercial code
- deprecated recocgnizer methods (they have been replaced with properties):
MBUsdlRecognizerResult
:getField:(MBUsdlKeys)usdlKey
optionalElements
- added new recognizer properties:
MBUsdlRecognizerResult
:firstName
lastName
fullName
address
dateOfBirth
dateOfIssue
dateOfExpiry
documentNumber
sex
restrictions
endorsements
vehicleClass
MBMrzResult
:sanitizedOpt1
sanitizedOpt2
sanitizedNationality
sanitizedIssuer
- renamed properties in
MBCzechiaCombinedRecognizerResult
:lastName
tosurname
firstName
togivenNames
identityCardNumber
todocumentNumber
address
topermanentStay
issuingAuthority
toautohority
personalIdentificationNumber
topersonalNumber
- renamed properties in
MBGermanyCombinedRecognizerResult
:lastName
tosurname
firstName
togivenNames
identityCardNumber
todocumentNumber
issuingAuthority
toautohority
eyeColour
tocolourOfEyes
- renamed properties in
MBJordanCombinedRecognizerResult
:issuer
toissuedBy
- renamed properties in
MBSlovakiaCombinedRecognizerResult
:identityCardNumber
todocumentNumber
issuingAuthority
toissuedBy
personalIdentificationNumber
topersonalNumber
- renamed properties in
MBRomaniaIdFrontRecognizerResult
:lastName
tosurname
identityCardNumber
todocumentNumber
nonMrzNationality
tonationality
nonMrzSex
tosex
validFrom
todateOfIssue
validUntil
todateOfExpiry
cardNumber
is now part ofMrzResult
asdocumentNumber
- renamed properties in
MBSloveniaCombinedRecognizerResult
:lastName
tosurname
firstName
togivenNames
identityCardNumber
todocumentNumber
address
topermanentStay
issuingAuthority
toadministrativeUnit
personalIdentificationNumber
topin
citizenship
tonationality
- renamed properties in
MBSloveniaIdBackRecognizerResult
:issuingAuthority
toadministrativeUnit
- renamed properties in
MBPolandCombinedRecognizerResult
:issuer
toissuedBy
- removed properties in
MBRomaniaIdFrontRecognizer
:idSeries
cnp
v4.7.0
-
Updates and additions:
- added support for reading front side of Brunei Temporary Residence Permit - use
MBBruneiTemporaryResidencePermitFrontRecognizer
- added support for reading back side of Brunei Temporary Residence Permit- use
MBBruneiTemporaryResidencePermitBackRecognizer
- added
MBBlinkCardOverlayViewController
to be used with BlinkCard recognizers
- added support for reading front side of Brunei Temporary Residence Permit - use
-
Improvements in ID scanning performance:
- improved reading accuracy for
MBSingaporeIdBackRecognizer
with stickers - enabled reading year-only dates of birth on Kuwait IDs
- all recognizers now reset their results on shake, except Combined recognizers
- improved reading accuracy for
-
Minor API changes:
MBPolandIdBackRecognizerResult
has propertymrzResult
containing the results- removed mrz image extraction from
MBMrtdRecognizer
andmrzImage
property inMBMrtdRecognizerResult
- removed mrz image extraction from
MBMrtdCombinedRecognizer
andmrzImage
property inMBMrtdCombinedRecognizerResult
- removed glare detection from
MBMrtdCombinedRecognizer
MBPaymentCardFrontRecognizer
,MBPaymentCardBackRecognizer
andMBPaymentCardCombinedRecognizer
have been replaced withMBBlinkCardRecognizer
MBElitePaymentCardFrontRecognizer
,MBElitePaymentCardBackRecognizer
andMBElitePaymentCardCombinedRecognizer
have been replaced withMBBlinkCardEliteRecognizer
- renamed
MicroBlink.framework
toMicroblink.framework
- renamed
MicroBlink.bundle
toMicroblink.bundle
-
Bugfixes:
MBMrtdRecognizer
result state is now properly invalidated after detection fails- templating recognizers no longer execute callbacks with
valid
state once they arevalid
on every frame even if nothing is 'detected'
v4.6.0
-
Updates and additions
- added support for reading front side of German Driver's License - use
MBGermanyDlFrontRecognizer
- added support for reading back side of Brunei ID - use
MBBruneiIdBackRecognizer
- added support for reading front side of Brunei Residence Permit - use
MBBruneiResidencePermitFrontRecognizer
- added support for reading back side of Brunei Residence Permit - use
MBBruneiResidencePermitBackRecognizer
- updated overlay view controllers with new icons for
close
andtorch
buttons - switched to using HTTPS in podspec for Cocoapods
- added support for reading front side of German Driver's License - use
-
Improvements in ID scanning performance
- improved reading accuracy for the following recognizers (DeepOCR support):
MBMalaysiaMyKadBackRecognizer
- improved reading accuracy for the following recognizers (DeepOCR support):
-
Minor API changes
- removed
sex
andsignatureImage
properties fromMBMalaysiaMyKadBackRecognizer
- renmaed
MBGermanyOldIdRecognizer
toMBGermanyIdOldRecognizer
- renamed properties in
MBCroatiaCombinedRecognizerResult
:identityCardNumber
todocumentNumber
address
toresidence
issuingAuthority
toissuedBy
personalIdentificationNumber
tooib
nonResident
todocumentForNonResident
- removed
mrzImage
fromMBMrtdCombinedRecognizer
andMBMrtdCombinedRecognizerResult
- renamed properties in
MBAustraliaDlFrontRecognizerResult
:name
tofullName
dateOfExpiry
tolicenceExpiry
- renamed
eyeColour
tocolourOfEyes
inMBGermanyIdBackRecognizerResult
- recognizers that are deprecated:
MBSerbiaIdBackRecognizer
andMBSerbiaIdBackRecognizerResult
MBSerbiaIdFrontRecognizer
andMBSerbiaIdFrontRecognizerResult
MBSerbiaCombinedRecognizer
andMBSerbiaCombinedRecognizerResult
- all properties that are deprecated for recognizers:
MBHongKongIdFrontRecognizerResult
:commercialCode
MBIndonesiaIdFrontRecognizerResult
:bloodType
district
kelDesa
rt
rw
MBNewZealandDlFrontRecognizerResult
:donorIndicator
cardVersion
MBMalaysiaMyKadBackRecognizerResult
:extendedNric
MBMexicoVoterIdFrontRecognizerResult
:electorKey
MBIrelandDlFrontRecognizerResult
:driverNumber
MBSwedenDlFrontRecognizerResult
:referenceNumber
MBMalaysiaIkadFrontRecognizerResult
:passportNumber
MBAustriaIdBackRecognizerResult
:principalResidence
height
eyeColour
MBAustriaPassportRecognizerResult
:height
MBGermanyIdBackRecognizerResult
:colourOfEyes
height
MBSwitzerlandIdBackRecognizerResult
:height
MBSwitzerlandPassportRecognizerResult
:height
MBSingaporeIdBackRecognizerResult
:bloodGroup
MBColombiaIdBackRecognizerResult
:bloodGroup
MBSwitzerlandPassportRecognizerResult
:height
MBPolandIdFrontRecognizerResult
:familyName
parentsGivenNames
MBMoroccoIdBackRecognizerResult
:fathersName
mothersName
MBRomaniaIdFrontRecognizerResult
:parentNames
- removed