Changelog
tip
For additional details about the API, please refer to our API reference documentation.
.NET - Version 7.1.1 (3 Nov 2025)β
Androidβ
- π New:
- Barcode Scanner:
- Barcode configurations for 1D barcode types have a new field
MinimumNumberOfRequiredFramesWithEqualRecognitionResultthat requires this number of frames on which the barcode has to be detected.
- Barcode configurations for 1D barcode types have a new field
- Check Scanner:
- We now extract the field after the account number on US checks. The name in the result is
CheckNumber. Note that this name is only based on common usage and not on any enforced standard.
- We now extract the field after the account number on US checks. The name in the result is
- Barcode Scanner:
- π Improvements:
- Check Scanner:
- Updated the documentation for US check field.
- Improved the handling of scanning results when the detection mode
DetectAndCropDocumentis set.
- Check Scanner:
- π Bug fixes:
- Document Scanner:
- Fixed an issue with an empty
DocumentQualitywhenAcknowledgementModewas set toBadQuality. - Fixed a bug where the usage guidance wouldn't display properly on screen startup.
- Fixed the image size on the review screen when in horizontal layout.
- Fixed an issue with an empty
- Check Scanner:
- Fixed a bug in the implementation of the US check standard which lead to rejection of valid checks.
- General:
- Fixed 16 KB page size support for the TFLite native library.
- Document Scanner:
- β οΈ Breaking changes:
- Barcode Scanner:
- The field
MinConfirmationsStandaloneEANinBarcodeAccumulationConfigurationwas moved and renamed to the fieldMinimumNumberOfRequiredFramesWithEqualRecognitionResultExtensionlessinBarcodeFormatUpcEanConfiguration.
- The field
- Barcode Scanner:
- π Under the hood:
- Updated the native Android SDK to Android Document SDK 7.1.2.
iOSβ
- π New:
- Barcode Scanner:
- Barcode configurations for 1D barcode types have a new field
MinimumNumberOfRequiredFramesWithEqualRecognitionResultthat requires this number of frames on which the barcode has to be detected.
- Barcode configurations for 1D barcode types have a new field
- Check Scanner:
- We now extract the field after the account number on US checks. The name in the result is
CheckNumber. Note that this name is only based on common usage and not on any enforced standard. - Added a new function
ForResult(SBSDKCheckScannerViewController controller, SBSDKCheckScanningResult result)toSBSDKCheckScannerViewControllerDelegate.
- We now extract the field after the account number on US checks. The name in the result is
- Barcode Scanner:
- π Improvements:
- Check Scanner:
- Updated the documentation for US check field.
- Improved the handling of scanning results when the detection mode
DetectAndCropDocumentis set.
- Check Scanner:
- π Bug fixes:
- Document Scanner:
- Fixed a bug in RTU-UI that did not always crop images from the photo library.
- Check Scanner:
- Fixed a bug in the implementation of the US check standard which lead to rejection of valid checks.
- General:
- Fixed a bug in the RTU-UI that prevented the proper display of the view finder in landscape mode.
- Document Scanner:
- β οΈ Breaking changes:
- Barcode Scanner:
- The field
MinConfirmationsStandaloneEANinSBSDKBarcodeAccumulationConfigurationwas moved and renamed to the fieldMinimumNumberOfRequiredFramesWithEqualRecognitionResultExtensionlessinSBSDKBarcodeFormatUpcEanConfiguration.
- The field
- Barcode Scanner:
- Changed
SBSDKCheckScannerViewControllerDelegatefunctionDidScanCheck(SBSDKCheckScannerViewController controller, SBSDKCheckScanningResult result)toDidScanCheck(SBSDKCheckScannerViewController controller, SBSDKCheckScanningResult result, bool isHighRes).
- Changed
- Barcode Scanner:
- π Under the hood:
- Updated the native iOS SDK to iOS Document SDK 7.1.4.
.NET - Version 7.1.0 (11 Sep 2025)β
Androidβ
- π New:
- Document Scanner:
ContourDetectorfeature was renamed toDocumentScannerand has a more advanced configuration and scanning API. SeeDocumentScanner.- RTU-UI v2: Added an auto-rotate document option. The document will now be automatically rotated based on the text orientation detected by the Document Quality Analyzer. See
CameraScreenConfiguration.AutoRotateImages. - RTU-UI v2: Added parameter
DocumentScanningFlow.ShowReviewScreenOnStartthat allows showing the Review Screen immediately if the scanner is opened with an existent document ID. E.g. document edit mode. - RTU-UI v2: Added an option to automatically navigate to the Review Screen after each scan. Use
DocumentScanningFlow.Screens.Camera.OpenReviewAfterEachScan = true. - RTU-UI v2: Added an option to open either the first or the last page when the Review Screen is opened. Use
DocumentScanningFlow.Screens.Review.ShowLastPageWhenAdding = true. - Introduced advanced generation settings for PDFs and TIFFs.
- Added a new document detection status
OkButTooDark. - Added setters for
UseCaseResolutionSizelimits for Preview and Analyzer use-cases inScanbotCameraXView. SeeScanbotCameraXView.SetPreviewFrameResolutionLimit(limit: UseCaseResolutionSize)andScanbotCameraXView#setAnalyzerFrameResolutionLimit(limit: UseCaseResolutionSize).
- Document Quality Analyzer:
- Advanced configuration of Document Quality Analyzer. See
DocumentQualityAnalyzerConfiguration. - Can now return the orientation of the document in steps of 90 degrees. Enabled by setting
DocumentQualityAnalyzerConfiguration.DetectOrientationto true. - Optionally return
QualityHeatmapas a part of theDocumentQualityAnalyzerResult. - Added an option to limit the input image size. If it is bigger, then the image will be resized.
- Added support for an advanced on-image scanning configuration
DocumentQualityAnalyzercall.
- Advanced configuration of Document Quality Analyzer. See
- Credit Card Scanner:
- Introduced a new beta feature: Credit Card Scanner, capable of detecting credit cards and extracting data from them. See
CreditCardScanner. - Introduced a new Credit Card Scanner RTU-UI v2 component. See
CreditCardScannerActivity.
- Introduced a new beta feature: Credit Card Scanner, capable of detecting credit cards and extracting data from them. See
- MRZ Scanner:
- Advanced configuration of MRZ Scanner. See
MrzScannerConfiguration. - New RTU UI v2 is now available for MRZ Scanner. See
MrzScannerActivity. - Added support for non-ICAO conformant machine readable zones on US border crossing cards.
- Added properties to
MrzScannerConfigurationthat allow to set if crops should be returned.
- Advanced configuration of MRZ Scanner. See
- Text Pattern Scanner:
- Feature was renamed from Generic Text Recognizer to Text Pattern Scanner and has a more advanced configuration and scanning API. See
TextPatternScanner. - New RTU UI v2 is now available for Text Pattern Scanner. See
TextPatternScannerActivity.
- Feature was renamed from Generic Text Recognizer to Text Pattern Scanner and has a more advanced configuration and scanning API. See
- VIN Scanner:
- RTU-UI v2: Added a brand-new, redesigned VIN Scanner. Use
IO.Scanbot.Sdk.Ui_v2.Vin.VinScannerActivity. - Added a new property
ExtractVINFromBarcodeinVinScannerConfigurationthat allows VIN data extraction from barcodes (for RTU UI v1 screen).
- RTU-UI v2: Added a brand-new, redesigned VIN Scanner. Use
- Document Data Extractor (Previously: Generic Document Recognizer):
- RTU-UI v2: Added a brand-new, redesigned Document Data Extractor. Use
IO.Scanbot.Sdk.Ui_v2.Documentdata.DocumentDataExtractorActivityto start the new scanner. - Introduced a Document Verification API including document semantics verification capabilities. Use the new
VerifyDocument(documentParts: List<GenericDocument>)method. - Added support for multiple new document types:
- ID Cards from Brazil, Hong Kong, Macao, and China.
- Chinese Entry and Exit Permits.
- Returns the issuing series of German ID Cards as part of the returned document as the
Seriesfield. - Now supports the front side of many more EU driver's licenses.
- Partial support for parsing of German addresses. For respective ID cards, address parsing can be enabled via a new
DeAddressParserConfiguration. Parsed addresses are stored as child documents. - Feature was renamed from Generic Document Recognizer to Document Data Extractor and has a more advanced configuration and scanning API. See
DocumentDataExtractor. - Now supports fallback to extraction of only the MRZ on unsupported documents.
- Added support for German driver qualification card.
- Document field validation now supports two additional statuses:
InferredandIgnored. - Generic document fields now support
ParsedDataattributes for standardized data (ISO 8601 dates, ISO 3166-1 countries, "Male"/"Female" gender). SeeFieldParsedData. - Added support for an advanced on-image scanning configuration for:
DocumentDataExtractor,HealthInsuranceCardScanner,MedicalCertificateScanner,MrzScanner, andCheckScanner.
- RTU-UI v2: Added a brand-new, redesigned Document Data Extractor. Use
- Health Insurance Card (EHIC) Scanner:
- Advanced configuration of Health Insurance Card Scanner. See
EuropeanHealthInsuranceCardRecognizerConfiguration.
- Advanced configuration of Health Insurance Card Scanner. See
- Check Scanner:
- RTU-UI v2: Added a brand-new, redesigned Check Scanner. Use
IO.Scanbot.Sdk.Ui_v2.Check.CheckScannerActivity. - Feature was renamed to Check Scanner and has a more advanced configuration and scanning API. See
CheckScanner. - Added possibility of returning cropped document.
- RTU-UI v2: Added a brand-new, redesigned Check Scanner. Use
- Medical Certificate Scanner:
- Feature was renamed to Medical Certificate Scanner and has a more advanced configuration and scanning API. See
MedicalCertificateScanner.
- Feature was renamed to Medical Certificate Scanner and has a more advanced configuration and scanning API. See
- Barcode Scanner:
- Added support for barcode types Pharma Code, Pharma Code Two Track and PZN (Pharmazentralnummer).
- Added support for the HIBC barcode document format.
- Added support for an advanced on-image scanning configuration for
ScanFromBitmapcall. - Added ability to configure common barcode properties via
BarcodeFormatCommonConfiguration. - Added
MinimumSizeScoreto barcode configurations;BarcodeItemhas a newSizeScorefield. Barcodes withSizeScore < MinimumSizeScoreare ignored. RTU-UI v2 also supportsMinimumSizeScore. - Introduced
StrictModefor certain barcode configurators (QR Code,Micro QR Code,rMQR Code,PDF417,MicroPDF417andgs1Composite). - Added the ability to return the barcode image in the resulting object via
BarcodeScannerConfiguration.ReturnBarcodeImage. - Added new engine modes
NextGenFarDistance(optimized for scanning from far distances) andNextGenLowPowerFarDistance(optimized for scanning from far on low-power devices). - Barcode scanning results have been enhanced with more detailed information, including
SizeScore. SeeBarcodeItem. - Added new predefined subsets of barcode formats (1D, 2D, Postal, Pharma, etc.). Old sets removed. See
BarcodeFormats. - Simplified configuration of Barcode Scanner RTU UI v2. See
BarcodeScannerConfiguration. - Added an ability to filter out all unaccepted barcode document formats in
BarcodeDocumentParser. - Added a flag
AddAdditionalQuietZonetoBarcodeFormatConfigurationBasefor scanning sharp crops of a barcode. - Added
ExtendedQuadandExtendedQuadNormalizedfields to theBarcodeItemclass to represent extended quads for 1D barcodes. BarcodeItemhas a new fieldRawBytesEncodingsthat contains the precise character encoding information ofRawBytes.BarcodeItemhas a new fieldStructuredAppendInfofor messages split across multiple barcodes.BarcodeScannerConfigurationhas a new fieldAccumulationConfigwhich allows the accumulation of barcodes over multiple frames in live mode.BarcodeItemhas a new fieldGlobalIndexto identify a barcode across multiple frames.- RTU-UI v2: Added
SelectedZoomFactor: Doublemetadata field inBarcodeScannerUiResultwith the value that the user used to scan the barcode.
- General:
- .NET: Added support for .NET 9 SDK, in addition to .NET 8 SDK.
- Added a new property
KeepScreenOnin all RTU-UI v2 scanner screen configurations to keep the device screen awake while scanning. - Cropped images returned as part of the scanner results are now represented as image references (
ImageRef). - Image Processor can now be created with an
ImageRefobject. SeeImageProcessor(imageRef: ImageRef). - The
ResultAccumulationConfigurationnow supports a newConfirmationMethodfield. - Document Data Extractor, Medical Certificate Scanner and Check Scanner now return document detection results.
- Added source OCR Page as an optional input parameter to PDF Generator.
- Added an option to limit the analyzer FPS processing for
DocumentScannerView,BarcodeScannerViewandBarcodeScanAndCountView. See more inICameraViewConfiguration.SetAnalyzerFpsLimit(fps: Float)method. - Added support for 16KB page size.
- Document Scanner:
- π Improvements:
- Document Scanner:
- Added
OkOrientationMismatchstatus, returned when screen and document orientations don't match. Can be ignored via configuration. - Exposed
AcceptedAspectRatioScoreandAspectRatiosin the scanner configuration. - Improved the Document Scanner RTU-UI v2 acknowledgment's bad image quality hint by adding the ability to present up to 5 lines.
- Increased performance for Document Scanner algorithms.
- Added
- Document Quality Analyzer:
- Guarantee the same document quality score for 90 degrees rotated images.
- Speed improvements. Note: document quality scores may slightly change for the same input images when compared to the previous version of the DoQA(Document Quality Analyzer).
- OCR Engine:
- Improved handling of special characters like umlauts when frame accumulation is used.
- Added source OCR Page as an optional input parameter to PDF Generator.
- Image Processing:
- New Image Processor preset
BinarizationFilterPreset.Preset5for documents with barcodes.
- New Image Processor preset
- MRZ Scanner:
- For pre-2022 Costa Rican passports, ID Number is returned as
DocumentNumberand Sequence Number asPersonalNumberin MRZ fields. - On US border crossing permits, the document number is now returned in the correct field.
- Dates in MRZ now also support
parsedDatacorrectly.
- For pre-2022 Costa Rican passports, ID Number is returned as
- Text Pattern Scanner:
- Improved performance with the same quality (quantized model).
- General speed improvements.
- Now supports XNNPACK for faster inference.
- VIN Scanner:
- Validation of VINs implements the full ISO 3779 standard, reducing false positives.
- Document Data Extractor (Previously: GenericDocumentRecognizer):
- Digits can no longer be recognized as part of given names or surnames.
- Higher accuracy for document classification.
- General speed improvements.
- Now detects whether a document is in focus and only starts the heavy recognition pipeline when image quality is suitable.
- Can now detect glare in images. Fields obstructed by glare will be returned with a validation status of
Obstructed. - Classification for documents with MRZ is more stable.
- Added normalization before date recognition.
- More consistent usage of common field types.
- Improved maiden name processing for
DePassportandDeIdCard. - Now also supports the new German ID card format issued starting 2024.
- Check Scanner:
- If image cropping is enabled and is successful, check recognition is performed on the crop instead of the original image.
- Medical Certificate Scanner:
- Date recognition in Medical Certificate forms is now based on the Scanbot OCR Engine and shows significant quality improvements.
- Barcode Scanner:
- By default, Code 93 now includes check digits in the result. To disable this and restore the previous behavior, set
stripCheckDigits = true. - Significant speed-up in live mode on very large input resolutions.
- Improved quiet zone checks for
ITF,Code 11,MSI Plessey,IATA 2 of 5,Industrial 2 of 5, andCode 25. - Improved the false positive rate for
ITFbarcodes. - Added the option to ignore barcodes that do not decode to one of the accepted document formats for Barcode Scanner RTU-UI v2 (
BarcodeScannerConfiguration.OnlyAcceptDocuments). - Added support for
MaximumTextLengthconstraint onCode 11,Code 39,Code 93,Code 128, andCodabarbarcode formats. - All Barcode AR overlays are now based on
ExtendedQuads. - Boarding pass document parser now supports up to version 8 of the IATA-BCBP standard.
- vCard document parser was improved.
- GS1 Composite codes are now processed faster in Scan from Image mode.
- Improved handling of back action with multiple dialogs and bottom sheets.
- By default, Code 93 now includes check digits in the result. To disable this and restore the previous behavior, set
- General:
- Improved
ScanbotCameraXViewpreview size selection strategy for square screens. - Improved the algorithm of high performance cores computation as the old one didn't work correctly on some devices (e.g. Pixel 9 Pro).
- Integrated Android Performance Hint Session. This significantly improves multithreading performance for some scanners (e.g. Credit Card Scanner and Barcode Scanner) on devices that support the Hint Session (e.g. Pixel 9 Pro and Samsung S24 Ultra).
- PDF Generator with OCR layer now handles non-ASCII characters correctly.
- Improved
- Document Scanner:
- π Bug Fixes:
- Document Scanner and Image Processing:
- RTU-UI v2: Fixed an issue where the last scanned page's preview would not update on a specific layout configuration.
- RTU-UI v2: Fixed an issue where the start of the activity without initializing the Scanbot SDK was leading to an application crash.
- RTU-UI v2: Auto-rotation is now applied only if the document was found in the snapped image.
- RTU-UI v1: Fixed insets for the shutter button when the app is built with
target_sdk >= 35. - Fixed Document Scanner point sorting.
- Fixed Document Quality Analyzer crash when
MaxImageSizewas 0. - Fixed Document Quality Analyzer patch size when
MinFraction= 1. - Fixed Document Scanner
FillPolygonColor(not filled by default) for RTU-UI v1. - Fixed Document Scanner/Finder User Guidance default background for RTU-UI v1.
- Fixed Document Scanner shutter button default color for RTU-UI v1.
- PDF Generator properly handles no-schema URIs.
- TIFF Generator: fixed JPEG/Deflate support and URI schema handling.
- Clamped parametric filters radius to 127.
- In Document Scanner RTU-UI v2,
PageSnapFeedbackNone()no longer prevents auto-transition to review screen at max pages limit. - Cropping Screen RTU-UI v2 status bar light/dark mode now correctly applied.
- Cropping Screen RTU-UI v2 now returns result instead of canceling if no changes were made.
- Cropping View: Fixed an issue with a broken layout after screen rotation without recreating the view.
- Fixed person-number extraction crash and simplified logic.
- Fixed
content://type uri handling forPdfGenerator,TiffGenerator, andOcrEngine. - Document Scanner RTU UI v2: fixed the screen behavior on multiple manual snaps in "single page" mode.
- Document Scanner RTU UI v2: fixed an issue where autofocus failed during the autosnap event.
- Document Data Extractor (Previously: GenericDocumentRecognizer):
- Fixed Document Data Extractor bug determining validation status when fields excluded.
- Fixed Document Data Extractor incorrect handling of Driver License expiry date validation.
- Fixed Document Data Extractor merging of
MaidenNameandSurnameon some German ID cards. - Resolved Document Data Extractor high peak memory consumption issue.
- Fixed an issue causing
nullto be returned as a confidence of empty fields.
- Text Pattern Scanner (Previously: Text Data Scanner):
- Fixed Text Pattern Scanner incorrect output for Unicode symbols.
- Check Scanner:
- Fixed Check Scanner User Guidance default background (was absent) for RTU-UI v1.
- Medical Certificate Scanner:
- Fixed Medical Certificate Scanner User Guidance default background (was absent) for RTU-UI v1.
- MRZ Scanner:
- Fixed MRZ Scanner crash when MRZ fallback was enabled and no text on document was detected.
- Scanning from still images now correctly returns
MrzScannerResult.Successas true.
- Barcode Scanner:
- Fixed returned results for all types of
UpcEanExtensionBehavior. - Fixed checksum for
Code 39barcode format. - Fixed an overflow when decoding
Micro Qr Codewith wrong bits in numeric mode. - Fixed
MinimumTextLengthforITFbarcode format (checked symbols instead of text length). - Fixed sorting of quad points for four-state/postal barcode types.
- In
Code 11barcodes with 10 data digits, whenChecksumis enabled andStripCheckDigitsis true, scanner now correctly strips both check digits. FindAndPickScanningMode.SheetContent.BarcodeItemImageVisiblein RTU-UI v2 now correctly applies visibility.- Fixed quad when flag
BarcodeFormatConfigurationBase.AddAdditionalQuietZoneis enabled. - The carrier identifier for MaxiCode mode 3 might be encoded by using different codewords. Now, all possible codewords are checked.
- vCard document parser now correctly processes the
FNkey asFormattedName. - RTU-UI v2: Fixed a crash with barcode launcher initialization when the SDK was not yet initialized.
- Fixed an issue where the
ExtractedDocumentwas not being generated for GS1 HandlingDecodeStructureandDecodeFull. - Barcode Scanner RTU UI v2: fixed an issue where the back button navigation did not work.
- Fixed returned results for all types of
- General:
- Fixed the resolution strategy for a square preview for
ScanbotCameraXView(Internal View for the scanners). - Fixed a crash when adding/removing frameHandlers in
ScanbotCameraXin a concurrency race condition. - Fixed screen insets for Android API 35 with forced edge-to-edge mode by opting out for RTU-UI v1 screens.
- In RTU-UI v2, modal dialog no longer appears below status bar.
- RTU-UI v2: Fixed handling of the back actions for modal dialogs.
- Accessibility content for action buttons in RTU-UI v2 now properly applied.
- Fixed a bug when
CameraTakePictureCallback.OnTakePictureRequested()wasn't called properly at the corresponding event. - Fixed an issue with the black preview in
ScanbotCameraXViewwhen the camera selected a square resolution on some Samsung and Xiaomi devices.
- Fixed the resolution strategy for a square preview for
- Document Scanner and Image Processing:
- β οΈ Breaking changes:
- Package Structure:
- In v7.1.0, the packaging structure has changed. Unlike v6.1.0, your application project must now also reference the
ScanbotSDK.NETpackage directly. Transitive references are no longer sufficient, because native Android SDK assets are delivered through a shared reference mechanism to avoid doubling package size.
- In v7.1.0, the packaging structure has changed. Unlike v6.1.0, your application project must now also reference the
- Native Library Update:
- Android: The Android SDK is now packaged with multiple
.aarfiles, split by module (previously provided as a single combined.aar).- Note: Please clear your projectβs build cache completely when upgrading from a previous
ScanbotSDKversion to prevent potential conflicts.
- Note: Please clear your projectβs build cache completely when upgrading from a previous
- Android: The Android SDK is now packaged with multiple
- General API structure:
ContourDetectorfeature renamed toDocumentScanner. Document Scanner moved toIO.Scanbot.Sdk.Documentpackage.- Generic Document Recognizer feature renamed to
DocumentDataExtractor. - Generic Text Recognizer feature renamed to
TextPatternScanner. - Medical Certificate Recognizer feature renamed to
MedicalCertificateScanner. - Check Recognizer feature renamed to
CheckScanner. MRZScannerclass renamed toMrzScanner.- TIFF Writer feature renamed to
TiffGenerator. AllWrite*()methods renamed toGenerateFrom*(). - For all classic components (scanners) methods like
Scan[recognize]WithFinderOverlay()are renamed toScan[Recognize]InArea(). - For Document Data Extractor classic component all
Recognizemethods are renamed toExtractFrom[input_type](). - For Document Quality Analyzer all methods
AnalyzeIn*()are renamed toAnalyzeOn*(). - Removed class
IO.Scanbot.Sdk.Ui_v2.Common.Mappers.AspectRatio, useIO.Scanbot.Sdk.Common.AspectRatio. - Removed Result Repositories mechanism for most RTU UI screens.
- Moved all logic related to PDF with OCR from OCR Engine to PDF Generator. See
PdfGenerator.GenerateWithOcr*(). - Removed class
ImageProcessor.ImageRotation. UseIO.Scanbot.Sdk.Core.ImageRotation.
- Feature removal:
- Removed deprecated License Plate Scanner feature.
- Removed deprecated Text Orientation Scanner. Use
DocumentQualityAnalyzerinstead.
- Result type changes:
- Changed result APIs for Barcode Scanner (RTU-UI v2:
BarcodeScannerUiResult), Check Scanner (CheckScanningResult), Health Insurance Card Scanner (EuropeanHealthInsuranceCardRecognitionResult), MRZ Scanner (MrzScannerResult), Medical Certificate Scanner (MedicalCertificateScanningResult), VIN Scanner (VinScannerResult), Document Scanner (DocumentDetectionResult), Text Pattern Scanner (TextPatternScannerResult).
- Changed result APIs for Barcode Scanner (RTU-UI v2:
- Configuration object changes:
- Removed old configuration APIs for Barcode Scanner, Check Scanner, Document Quality Analyzer, Health Insurance Card Scanner, MRZ Scanner, Document Data Extractor, Text Pattern Scanner, Medical Certificate Scanner, VIN Scanner, and PDF Generator. Use new configuration mechanisms.
- Renamed enum
MSIPlesseyChecksumAlgorithmtoMsiPlesseyChecksumAlgorithm. - Replaced
AcceptedDocumentFormatsinBarcodeScannerConfigurationwithExtractedDocumentFormatsandOnlyAcceptDocumentsflag.
- Document Scanner:
- Changed engine mode API representation:
LegacyforEdgeBased,MlforMlBased. SeeDocumentScannerEngineMode. - RTU-UI v2:
Screens.Camera.CameraConfiguration.IgnoreBadAspectRatioparameter renamed toIgnoreOrientationMistmatch. - RTU-UI v2:
AcceptedSizeScoreandAcceptedAngleScorerange changed from0..1to0..100. - RTU-UI v2: Detection parameters moved from
Screens.Camera.CameraConfigurationtoScreens.Camera.ScannerParameters. - All detected lines in results represented by new
LineSegmentFloatclass.
- Changed engine mode API representation:
- Document Quality Analyzer:
- Removed
NoDocumentstatus fromDocumentQualityenum.
- Removed
- Text Pattern Scanner:
- Changed interfaces of Text Pattern Validation and Clean callbacks. Use new
ContentValidator.
- Changed interfaces of Text Pattern Validation and Clean callbacks. Use new
- Document Data Extractor (Previously: GenericDocumentRecognizer):
- Removed the legacy RTU-UI Document Data Extractor. Use RTU-UI v2 instead.
- Removed
ShouldRecognizeproperty fromExtract*()methods. Use newDocumentDataExtractionMode. - By default, only German documents are now enabled for scanning. Previously, all supported documents were enabled.
DeDriverLicenseFrontandDeDriverLicenseBackare renamed toEuropeanDriverLicenseFrontandEuropeanDriverLicenseBackrespectively.
- VIN Scanner:
- VIN Scanner RTU-UI v1: Changed
TextPatternScannerResultresult type toVinScannerResult.
- VIN Scanner RTU-UI v1: Changed
- Barcode Scanner:
- All Barcode Formats are represented by
IO.Scanbot.Sdk.Barcode.BarcodeFormatenum. Other barcode format enums removed. - Replaced class
IO.Scanbot.Barcodescanner.Model.BarcodeTypewithIO.Scanbot.Sdk.Barcode.BarcodeFormat. - Barcode Document Format is represented by
IO.Scanbot.Sdk.Barcode.BarcodeDocumentFormatenum. - RTU-UI v2: Refactored
BarcodesExtensionFilterenum, synchronized withUpcEanExtensionBehaviorenum from Barcode Scanner Classic component API. BarcodePolygonsView.BarcodeItemViewBinder.BindView(): Added an additional property withTextViewStyle.
- All Barcode Formats are represented by
- RTU-UI v1:
- RTU-UI v1: All screens now expect
RGBAvalues for HEX string when parsing configuration from JSON. - RTU-UI v1 Barcode: Refactored screen result structure. Removed ability to set Barcode Image Generation type in screen config.
- RTU-UI v1: All screens now expect
- General: Removed
ScanbotSdkInitializer.UseCameraXRtuUi().
- Package Structure:
- β οΈ Deprecations:
- Marked Document Scanner, Finder Document Scanner, MRZ Scanner and Text Pattern Scanner RTU UI v1 screens as deprecated. Please use the corresponding RTU UI v2 screens.
- π Under the hood:
- Updated the native Android SDK to Android Document SDK 7.1.1.
- The Android SDK is now packaged with multiple
.aarfiles, split by module (previously provided as a single combined.aar). - Updated Compile Sdk to 35.
- Android Jetpack Compose updated to 1.7.8.
- Upgraded nlohmann::json to 3.11.3.
- Updated xsimd version to 13.2.0.
- Updated xtensor version to 0.26.0-scanbot.
- Updated xtl version to 0.8.0.
- Upgraded yaml-cpp to 0.8.
- Upgrade OpenCV to 4.10.
- Updated Boost C++ version to 1.88.0.
- Updated spdlog version to 1.15.2.
- Added flatbuffers 2.0.6.
- Added 3rd party PdfiumAndroid library.
iOSβ
- π New:
- Document Scanner:
DocumentDetectorwas renamed toDocumentScannerand has a more advanced configuration and scanning API. SeeSBSDKDocumentScanner.- RTU-UI v2: Added the auto-rotate document option. The document will now be automatically rotated based on the text orientation detected by the Document Quality Analyzer. See
SBSDKUI2CameraScreenConfiguration.AutoRotateImages. - Introduced advanced generation settings for PDFs and TIFFs (via
SBSDKPDFConfigurationandSBSDKTIFFGeneratorParameters). - Added a new document detection status
OkButTooDark. Returned when a document is detected under poor lighting conditions. - Ability to set the bad aspect ratio hint of the Document Scanner. See
SBSDKDocumentScannerStatusTextConfiguration.TextHintBadAspectRatio. - Image Processor can be initialized with
SBSDKImageRef,UIImage, orImageURL. New methods to apply filters, crop, rotate, and resize. SeeSBSDKImageProcessor. - Added advanced configuration to the PDF Generator. See
SBSDKPDFConfiguration. Introduced new OCR configuration:SBSDKPDFGenerator.OcrConfiguration. - Added property
ShowReviewScreenOnStarttoSBSDKUI2DocumentScanningFlow. If enabled, the scanner automatically navigates to the Review Screen when the flow starts. - Added property
OpenReviewAfterEachScantoSBSDKUI2CameraScreenConfiguration. If enabled, the Review Screen is opened after each addition of a new page. - Added property
ShowLastPageWhenAddingtoSBSDKUI2ReviewScreenConfiguration. If enabled, the Review Screen will be opened showing the last page. - Added property
DocumentPreviewImageSizeLimitinSBSDKDocumentPageto limit the size of the document preview image.
- Document Quality Analyzer:
- Added advanced APIs in Document quality analyzer feature. See
SBSDKDocumentQualityAnalyzer,SBSDKDocumentQualityAnalyzerConfiguration, andSBSDKDocumentQualityAnalyzerResult. - Can now also return the orientation of the document in steps of 90 degrees. Enabled by setting
SBSDKDocumentQualityAnalyzerConfiguration.DetectOrientationto true. - Optionally,
QualityHeatmapis returned as a part of theSBSDKDocumentQualityAnalyzerResult. - Added support for an advanced on-image scanning configuration
SBSDKDocumentQualityAnalyzer.Analyze(image:)call.
- Added advanced APIs in Document quality analyzer feature. See
- Credit Card Scanner:
- Introduced a new beta feature: Credit Card Scanner, capable of detecting credit cards and extracting data from them. See
SBSDKCreditCardScanner. - New RTU UI v2 component for Credit Card Scanner. See
SBSDKUI2CreditCardScannerViewController.
- Introduced a new beta feature: Credit Card Scanner, capable of detecting credit cards and extracting data from them. See
- MRZ Scanner:
- Added advanced configuration to the MRZ Scanner. See
SBSDKMRZScannerConfiguration. - New RTU UI v2 is now available for MRZ Scanner. See
SBSDKUI2MRZScannerViewController. - Added support for non-ICAO conformant machine readable zones on US border crossing cards.
- Added advanced configuration to the MRZ Scanner. See
- Text Pattern Scanner:
- Feature was renamed from Generic Text Recognizer to Text Pattern Scanner and has more advanced configuration and scanning API. See
SBSDKTextPatternScanner. - New RTU UI v2 is now available for Text Pattern Scanner. See
SBSDKUI2TextPatternScannerViewController.
- Feature was renamed from Generic Text Recognizer to Text Pattern Scanner and has more advanced configuration and scanning API. See
- VIN Scanner:
- Added a new property
ExtractVINFromBarcodeinSBSDKUIVINScannerBehaviorConfigurationthat allows VIN data extraction from barcodes (for RTU UI v1).
- Added a new property
- Document Data Extractor (Previously: Generic Document Recognizer):
- RTU-UI v2: Added a brand-new, redesigned Document Data Extractor. See
SBSDKUI2DocumentDataExtractorViewController. - Feature was renamed from Generic Document Recognizer to Document Data Extractor and has a more advanced configuration and scanning API. See
SBSDKDocumentDataExtractor. - Introduced a Document Verification API including document semantics verification capabilities. Use the new
VerifyDocumentWithDocumentParts(SBSDKGenericDocument[] documentParts)method inSBSDKDocumentDataExtractor. - Added support for multiple new document types:
- ID Cards from Brazil, Hong Kong, Macao, and China.
- Chinese Entry and Exit Permits.
- Returns the issuing series of German ID Cards as part of the returned document as the
Seriesfield. - Now supports the front side of many more EU driver's licenses.
- Partial support for parsing of German addresses. For respective ID cards, address parsing can be enabled via a new
SBSDKDeAddressParserConfiguration. Parsed addresses are stored as child documents. - Now supports fallback to extraction of only the MRZ on unsupported documents by using the config
SBSDKMRZDocumentType.Unknown. - Added support for German driver qualification card.
- Document field validation now supports two additional statuses:
InferredandIgnored. SeeSBSDKGenericDocumentFieldValidationStatus. - Generic document fields now support
ParsedDataattributes for standardized data (ISO 8601 dates, ISO 3166-1 countries, "Male"/"Female" gender). SeeSBSDKGenericDocumentFieldParsedData. - Added support for an advanced on-image scanning configuration for:
DocumentDataExtractor,HealthInsuranceCardScanner,MedicalCertificateScanner,MrzScanner, andCheckScanner.
- RTU-UI v2: Added a brand-new, redesigned Document Data Extractor. See
- Health Insurance Card (EHIC) Scanner:
- Added advanced configuration to the Health Insurance Card Recognizer. See
SBSDKEuropeanHealthInsuranceCardRecognizerConfiguration.
- Added advanced configuration to the Health Insurance Card Recognizer. See
- Check Scanner:
- Feature was renamed to Check Scanner and now has more advanced configuration and scanning API. See
SBSDKCheckScanner. - Ability to configure Check Scanner Classic UI using
SBSDKCheckScannerViewController.SetConfiguration(_:).
- Feature was renamed to Check Scanner and now has more advanced configuration and scanning API. See
- Medical Certificate Scanner:
- Feature was renamed to Medical Certificate Scanner and has more advanced configuration and scanning API. See
SBSDKMedicalCertificateScanner. - Introduced a new method to scan a medical certificate from frames. See
SBSDKMedicalCertificateScanner.ScanFromImage(from:parameters:).
- Feature was renamed to Medical Certificate Scanner and has more advanced configuration and scanning API. See
- Barcode Scanner:
- Added support for barcode types Pharma Code, Pharma Code Two Track and PZN (Pharmazentralnummer).
- Added support for the HIBC barcode document format.
- Added support for an advanced on-image scanning configuration for
SBSDKBarcodeScanner.ScanFromImage(from:useLiveMode:)call. - Added ability to configure common barcode properties via
SBSDKBarcodeFormatCommonConfiguration. - Added
MinimumSizeScoreto barcode configurations;SBSDKBarcodeItemhas newSizeScore. Barcodes withSizeScore < MinimumSizeScoreare ignored. - Introduced
StrictModefor certain barcode configurators (QR Code,Micro QR Code,rMQR Code,PDF417,MicroPDF417andgs1Composite). - Added the ability to return the barcode image in the resulting object via
SBSDKUI2BarcodeScannerConfiguration.ReturnBarcodeImageproperty. - Added new engine modes
NextGenLowPower,NextGenFarDistanceandNextGenLowPowerFarDistance. SeeSBSDKBarcodeScannerEngineMode. - Barcode scanning results have been enhanced with more detailed information. See
SBSDKBarcodeItem. - Added new predefined subsets of barcode formats (1D, 2D, Postal, Pharma, etc.). Old sets removed(
SBSDKBarcodeTypes). SeeSBSDKBarcodeFormat,SBSDKBarcodeFormats. - Ability to initialize Barcode Scanner using new constructor
SBSDKBarcodeScanner(formats:, extractedDocumentFormats:). - Introduced new property
OptimizeOverlaystoSBSDKBarcodeScanner. - Ability to configure Barcode Scanner Classic UI and Scan-and-Count Classic UI using
SetConfiguration(_:). - Ability to get
ExtractedDocumentFormatsfromSBSDKBarcodeDocumentParser. - Ability to know when a barcode was last detected using
SBSDKBarcodeScannerAccumulatingResult.DateOfLastDetection.
- General:
- .NET: Added support for .NET 9 SDK, in addition to .NET 8 SDK.
- Added property
HardwareButtonsEnabledtoSBSDKUI2CameraConfiguration. If enabled, it allows zooming using the camera control button (iPhone 16 series). - Added property
FpsLimittoSBSDKUI2CameraConfigurationandSBSDKUI2DocumentScannerCameraConfigurationto limit the rate of detections per second in normal performance mode. - Added property
DidEndZoomHandlertoSBSDKZoomingImageScrollView. - Added analytics support with new classes:
SBSDKAnalyticsManager,SBSDKAnalyticsEvent,SBSDKAnalyticsFeature,SBSDKAnalyticsCategory,SBSDKAnalyticsEventName,SBSDKAnalyticsEventFactory, andSBSDKAnalyticsSubscriberfor tracking and managing SDK usage analytics. - Added support for an advanced on-image scanning configuration for:
SBSDKDocumentDataExtractor,SBSDKHealthInsuranceCardRecognizer,SBSDKMedicalCertificateScanner,SBSDKMRZScanner, andSBSDKCheckScanner. - Added property
HardwareButtonsEnabledtoSBSDKBaseScannerViewController(all Classic UI) to toggle volume button behavior. If set tofalseit restores the original volume button behavior. - Added properties
CameraSessionKeepAliveTimeoutandAnimateCameraOverlaytoSBSDKBaseScannerGeneralConfiguration. - Added properties
SessionDidChangeHandlerandIsSessionRunningtoSBSDKBaseScannerViewController. - Added functions
PauseandResumetoSBSDKBaseScannerViewController. - Cropped images returned as part of the scanner results are now represented as image references (
SBSDKImageRef), convertible toUIImage. - Ability to additionally process frames before main scanner via
SBSDKBaseScannerViewController.AdditionalFrameProcessorproperty. - Introduced
SBSDKUI2PermanentViewFinderConfigurationfor always visible view finder. - Document Data Extractor, Medical Certificate Scanner and Check Scanner now return document detection results (
SBSDKDocumentDetectionResult). - Added new enum case
PhototoSBSDKVideoFrameResolution. - Added property
IsInterruptedtoSBSDKCameraSessionto indicate if the camera session was interrupted by the system.
- Document Scanner:
- π Improvements:
- Document Scanner:
- Added
OkButOrientationMismatchstatus, returned when screen and document orientations don't match. Can be disabled by settingIgnoreOrientationMismatchto True. SeeSBSDKDocumentDetectionStatusandSBSDKDocumentScannerParameters. - Improved the Document Scanner RTU-UI v2 acknowledgment's bad image hint by adding the ability to present up to 5 lines.
- Improved performance when editing
SBSDKScannedPageand in the RTU-UI v2 Document Scanner Review Screen. - Improved captured image quality when using the Document Scanner Classic UI or RTU-UI (v1 and v2).
- Improved the user guidance in the Document Scanner RTU-UI v2 to support longer text entries.
- PDF Generator with OCR layer now handles non-ASCII characters correctly.
- Improved landscape-orientation layout of RTU-UI v2 screens.
- Increased performance for Document Scanner algorithms.
- The zoomed page view in the Document Scanner RTU-UI v2 Review Screen now closes when you finish zooming while being below the minimum zoom value.
- Rebalanced the internally used photo capture settings to better match the photo quality prioritization modes. The mode speed is now significantly faster, the mode balanced is a bit faster, and the mode quality is a bit slower with the best possible image quality.
- Added
- Document Quality Analyzer (DoQA):
- Guarantee the same document quality score for 90 degrees rotated images.
- Speed improvements. Note: document quality scores may slightly change for the same input images when compared to the previous version of the DoQA.
- Image Processing:
- New Image Processor preset
BinarizationFilterPreset.Preset5for documents with barcodes.
- New Image Processor preset
- Text Pattern Scanner:
- Improved performance with the same quality.
- VIN Scanner:
- Validation of VINs implements the full ISO 3779 standard, reducing false positives.
- Document Data Extractor (DDE):
- Digits can no longer be recognized as part of given names or surnames.
- Higher accuracy for document classification.
- Barcode Scanner:
- By default, Code 93 now includes check digits in the result. To disable this and restore the previous behavior, set
StripCheckDigits = true. - Significant speed-up in live mode on very large input resolutions.
- Improved barcode detection for various barcode types.
- More robust QR code recognition (timing patterns, alignment, artistic QR codes).
- QR codes with non-square finder patterns and embedded in adversarial backgrounds can now be recognized.
- Improved quiet zone checks for
ITF,Code 11,MSI Plessey,IATA 2 of 5,Industrial 2 of 5, andCode 25. - Improved the false positive rate for
ITF. - Added the option to ignore barcodes that do not decode to one of the accepted document formats for Barcode Scanner RTU-UI v2. See
SBSDKBarcodeScannerConfiguration.OnlyAcceptDocumentsproperty. - Improved performance when scanning four-state postal barcodes (i.e.
Australia Post,Japanese Post,RM4SCC,Royal TNT PostandUSPS Intelligent Mail). - Improved the recognition of
PDF417barcodes. - Improved the barcode scanner to better recognize
QRcodes if the top left finder pattern is corrupted (up to QR code version size 20). - Classic Component: Fixed an issue where quickly stopping and starting the camera session of any scanner screen could lead to a crash or unpredictable behavior.
- By default, Code 93 now includes check digits in the result. To disable this and restore the previous behavior, set
- The camera permission screen will now appear if camera access is restricted in all RTU-UI screens.
- Document Scanner:
- π Bug Fixes:
- Document Scanner:
- Fixed processing of still images of an indexed color space model in all scanners, Document Quality Analyzer, and PDF and TIFF generators.
- Fixed a UI bug in the Document Scanner Classic UI where
Accepteddocument'sFillColorwas not being removed when theAutoSnapProgressFillColorwas being shown. - Fixed a UI bug in the Document Scanner RTU-UI v2 where the bar buttons were not properly grayed out when in disabled state.
- Fixed a bug in the TIFF generator that prevented the creation of JPEG-encoded colored TIFF files.
- Fixed a bug in RTU-UI v2 Document Scanner where the document could not be captured in auto snap mode when
EnabledInAutoSnappingModewas set to false inSBSDKUI2ShutterButton. - Fixed a bug in RTU-UI v2 Document Scanner where auto rotation was applied if no document was detected.
- Fixed a memory leak when dealing with grayscale images.
- Fixed an issue on simulators where the shutter button was missing in the RTU-UI Document Scanner.
- Image Editing:
- Fixed a rare crash when the screen orientation changed.
- PDF Image Extractor:
- Fixed wrong orientation of extracted images when the PDF page had a transform applied.
- Document Quality Analyzer:
- Fixed quality estimation for rotated images.
- Storage Crypting:
- Fixed data corruption issues in AES encryption/decryption that could result in corrupted or partially corrupted files.
- Barcode Scanner:
- Fixed returned results for all types of
SBSDKUpcEanExtensionBehavior. - Fixed the checksum of the
Code 39barcode format. - Fixed a bug in the Barcode Scanner RTU-UI v2 where the flip camera button was not resetting the widest camera available if chosen.
- Fixed a bug in
SBSDKBarcodeScannerViewControllerthat could lead to a crash when embedded within aUIViewControllerRepresentable. - Fixed a bug in the AR Barcode Scan and Count where the scanner would be stuck if there was no barcode detected.
- Fixed a UI bug in the Barcode Scanner RTU-UI v2 where the sheet button overlapped with the action bar.
- Fixed an issue where the
ExtractedDocumentwas not being generated for GS1 HandlingDecodeStructureandDecodeFull.
- Fixed returned results for all types of
- General:
- Fixed a bug with scanned documents cloning when using per-file encryption.
- Document Scanner:
- β οΈ Breaking changes:
- Package Structure:
- In v7.1.0, the packaging structure has changed. Unlike v6.1.0, your application project must now also reference the
ScanbotSDK.NETpackage directly. Transitive references are no longer sufficient, because native iOS SDK assets are delivered through a shared reference mechanism to avoid doubling package size.
- In v7.1.0, the packaging structure has changed. Unlike v6.1.0, your application project must now also reference the
- Native Library Update:
- iOS: The iOS SDK is now included as an
.xcframework(previously provided as a.framework).- Note: Please remove the
RuntimeIdentifierconditions for device(arm64) and simulator(x86) from the project(.csproj) file.
- Note: Please remove the
- iOS: The iOS SDK is now included as an
- General API structure & naming:
- Extensive renaming of classes, properties, methods, and enums (e.g.,
DocumentDetectortoSBSDKDocumentScanner,GenericDocumentRecognizertoSBSDKDocumentDataExtractor,CheckRecognizertoSBSDKCheckScanner,SBSDKHealthInsuranceCardRecognizerrelated classes,SBSDKMachineReadableZoneRecognizertoSBSDKMRZScanner,SBSDKGenericTextLineRecognizertoSBSDKTextPatternScanner,SBSDKMedicalCertificateRecognizertoSBSDKMedicalCertificateScanner,SBSDKPDFRenderertoSBSDKPDFGenerator,SBSDKTIFFImageWritertoSBSDKTIFFGenerator). - Many
Recognize...methods renamed toScan...orExtract.... - Many initializers changed to accept new configuration objects.
- Extensive renaming of classes, properties, methods, and enums (e.g.,
- Feature removal:
- Removed the License Plate Scanner and all of its related files.
- Result type changes:
- Result objects updated for many scanners (e.g.,
SBSDKDocumentDetectionResult,SBSDKBarcodeItem,SBSDKMRZScannerResult,SBSDKCheckScanningResult,SBSDKMedicalCertificateScanningResult,SBSDKVINScannerResult). SBSDKMachineReadableZoneRecognizerResultreplaced bySBSDKMRZScannerResult.SBSDKMachineReadableZoneRecognizerResultDocumentTypebySBSDKMRZDocumentType.SBSDKCheckRecognizerResultbySBSDKCheckScanningResult.SBSDKMedicalCertificateRecognizerResultbySBSDKMedicalCertificateScanningResult.SBSDKHealthInsuranceCardRecognitionResulttoSBSDKEuropeanHealthInsuranceCardRecognitionResult.
- Result objects updated for many scanners (e.g.,
- Configuration object changes:
- Removed old configuration APIs for most scanners; use new
SetConfiguration(_:)methods with dedicated configuration objects. SBSDKPDFRendererOptionsreplaced bySBSDKPDFConfiguration.SBSDKUI2BarcodeRecognizerConfigurationtoSBSDKBarcodeScannerConfiguration.SBSDKUI2AspectRatioreplaced bySBSDKAspectRatio.
- Removed old configuration APIs for most scanners; use new
- Document Scanner:
- The
SBSDKUI2DocumentScannerControllerdoes not dismiss itself automatically anymore when using the staticCreate(configuration:completion:)method. - Properties related to detection parameters (angle, size, brightness, and aspect ratios) moved from
SBSDKUI2DocumentScannerCameraConfigurationtoScannerParametersinSBSDKUI2CameraScreenConfiguration. IgnoreBadAspectRatiorenamed toIgnoreOrientationMismatchin UI configurations.SBSDKDocumentDetectorResultreplaced bySBSDKDocumentDetectionResult.SBSDKPolygonEdgebySBSDKLineSegment.- Renamed class
SBSDKDocumentDetectorModetoSBSDKDocumentScannerEngineMode.
- The
- PDF Image Extractor:
- Removed parameter
Scalingfrom all methods and replaced it by member variableScaleFactor.
- Removed parameter
- Barcode Scanner:
- Initializers for
SBSDKBarcodeScannerViewControllerandSBSDKBarcodeScanAndCountViewControllerchanged to accept configuration objects. SBSDKUI2BarcodeScannerResultrenamed toSBSDKUI2BarcodeScannerUIResult.- Removed properties like
AcceptedBarcodeTypes,EngineMode, etc., fromSBSDKBarcodeScannerViewController; configure viaSBSDKBarcodeScannerConfiguration. - Removed
SBSDKBarcodeScannerAccumulatingResult.Codeproperty, useSBSDKBarcodeScannerAccumulatingResult.Iteminstead. SBSDKBarcodeTyperenamed toSBSDKBarcodeFormat.SBSDKBarcodeDocumentRootTypetoSBSDKBarcodeDocumentFormat. Display names of various barcode formats changed.- Replaced
SBSDKUI2BarcodesExtensionFilterenum withSBSDKUpcEanExtensionBehavior. PropertyBarcodesExtensionFilterinSBSDKUI2BarcodeScannerConfigurationrenamed toExtensions. - Methods of
SBSDKBarcodeTrackingOverlayControllerDelegateandSBSDKTrackedBarcodeInfoViewablenow useSBSDKBarcodeItem. - Removed
SBSDKBarcodeImageGenerationTypeand related properties.
- Initializers for
- MRZ Scanner:
- Replaced methods
SBSDKMRZScanner.ScanFromImage(from: UIImage)andSBSDKMRZScanner.ScanFromFrame(from: SBSDKBaseScannerFrame)bySBSDKMRZScanner.ScanFromImage(from: UIImage, useLiveMode: Bool)andSBSDKMRZScanner.ScanFromFrame(from: SBSDKBaseScannerFrame, useLiveMode: Bool). - Removed outdated
DetectMrz: Booleanflag fromScanInArea()methods.
- Replaced methods
DefaultBackFacingCamera,DefaultFrontFacingCameraandWidestAvailableBackFacingCameranow returns a simulated camera instead ofnullif the physical camera is not available.- Removed property
StopsCameraSessionWhenDisappearedfromSBSDKBaseScannerGeneralConfiguration. To emulate this behavior, setCameraSessionKeepAliveTimeoutto a high value, e.g.Double.MaxValue. - Other class & enum renames:
SBSDKCheckDocumentRootTypetoSBSDKCheckDocumentModelRootType.SBSDKCheckRecognitionResultStatusbySBSDKCheckMagneticInkStripScanningStatus.SBSDKGenericDocumentRootTypetoSBSDKDocumentsModelRootTypeand related constants/model classes.SBSDKHealthInsuranceCardFieldTypetoSBSDKEuropeanHealthInsuranceCardRecognitionResultFieldTypeand related field/status/type classes.SBSDKMedicalCertificateRecognizerCheckboxTypetoSBSDKMedicalCertificateCheckBoxTypeand related result/enum renames.- Renamed parameter
completionHandlertocompletioninCreateNewWithConfigurationandPresentOnfunctions ofSBSDKUI2DocumentScannerController. - Renamed parameter
handlertocompletioninCreateNewWithConfigurationandPresentOnfunctions ofSBSDKUI2BarcodeScannerViewController. - Renamed async function
PresentOnAsync(on:configuration)toPresentOn(on:configuration)inSBSDKUI2BarcodeScannerViewController. - Completion handler result type for
SBSDKUI2CroppingViewControlleris now optional (Action<SBSDKUI2CroppingResult?>).
- Other removed classes:
- Removed
SBSDKCaptureInfo,SBSDKDocumentDetectionMetrics,SBSDKGenericDocumentRecognizerAccumulationConfiguration,SBSDKMachineReadableZoneRecognizerFieldName,SBSDKImageProcessorError, etc.
- Removed
- General:
- Replaced all occurrences of the deprecated
AVCaptureVideoOrientationenum by an equal enum namedSBSDKVideoOrientation.
- Replaced all occurrences of the deprecated
- Package Structure:
- β οΈ Deprecations:
- MRZ Scanner RTU-UI v1 is deprecated. Use new
SBSDKUI2MRZScannerViewController. - Text Pattern Scanner RTU-UI v1 is deprecated. Use new
SBSDKUI2TextPatternScannerViewController.
- MRZ Scanner RTU-UI v1 is deprecated. Use new
- π Under the hood:
- The iOS SDK is now included as an
.xcframework(previously provided as a.framework). - Updated the native iOS SDK to iOS Document SDK 7.1.2.
- The regex filters are applied for substrings instead of the entire output string.
- Upgraded nlohmann::json to 3.11.3.
- Upgraded xsimd to 13.2.
- Upgraded xtl to 0.8.
- Upgraded xtensor to 0.26.0-scanbot.
- Upgraded yaml-cpp to 0.8.
- Upgraded CLI11 to 2.5.
- Upgraded spdlog to 1.15.2.
- Upgraded Boost to 1.88.
- Added flatbuffers 2.0.6.
- The iOS SDK is now included as an
.NET - Version 6.1.0 (5 Dec 2024)β
Androidβ
- π New:
- Implemented new Document API to perform document creation and editing.
- Implemented new Ready-To-Use Document Scanner screen with extended scanning and reviewing capabilities.
- Added multiple overloads of
Render(...)method inIPDFRendererinterface. - Added multiple overloads of
RecognizeTextWithPdfFrom(...)method inIOpticalCharacterRecognizerinterface. - Added multiple overloads of
WriteTIFF()method inTIFFWriterclass. - Added new property
AddAdditionalQuietZonetoBarcodeScannerAdditionalConfig. - Added a new predefined collection of barcodes,
BarcodeFormat.POSTAL, which includes barcodes used in the postal industry. - Added option
MultipleScanningMode.AllowEmptySubmissionto allow submission of an empty barcode list in the Multiple Barcodes use case in RTU-UI v2.
- π Improvements:
- Improved
MagnifierView. - AR overlay is enabled by default for
FindAndPickScanningModein Barcode Scanner RTU UI v2 screen. - For CODE_128 and ITF, we improved the recognition of barcodes generated by defective thermal printers that do not print certain black bars correctly.
- Improved false positive rate of UPC/EAN extensions in live mode.
- Improved
- π Bug fixes:
- Minor fixes for Barcode Scanner appearance in RTU UI v2 to make it consistent with its iOS counterpart.
- Fix point sorting in
ContourDetector. - Fixed KANJI mode for QR codes.
- Fixed an issue with AR Overlay and barcode mapping in
BarcodeScannerActivityRTU UI v2.0, where the mapped image wasn't shown on the AR Overlay until the same barcode appeared in the list below. - Fixed image preprocessing for Document Quality Analyzer.
- Fixed fallback in the "Background Clean" filter when the ML model is unavailable.
- Fixed R8 obfuscation config for SDK logging classes.
- Fixed a bug in
ScanbotColorwhere settingIsArgbto true, resulted in a wrong color.
- β οΈ Breaking changes:
- IMPORTANT Dropped support for the target
.net7.0-android. - All classes from the old Page API were marked as deprecated and moved to
IO.Scanbot.Sdk.Persistence.Page.Legacypackage. - Renamed methods to
Render(...)inIPDFRendererinterface. - Changed
Render(...)method signature inIPDFRendererinterface. Now it takes an array of Uris instead of the List of Uris. - Renamed
WriteTIFFFromImages(...)andWriteTIFFFromFiles(...)methods toWriteTIFF(...)in theTIFFWriterclass. - Renamed
IO.Scanbot.Sdk.Process.Model.DocumentQualityResulttoIO.Scanbot.Sdk.Process.Model.DocumentQuality. - Renamed
IO.Scanbot.Sdk.Core.Contourdetector.DetectionStatustoIO.Scanbot.Sdk.Core.Contourdetector.DocumentDetectionStatus. - Changed the type of the
Rotationfield in thePageclass to theIO.Scanbot.Sdk.Core.ImageProcessorenum. - Removed enum
BarcodeDensity. - Removed property
CodeDensityfromBarcodeAdditionalParameters. - Removed enum values
ValidateandDecodefromGs1Handlingand replaced them byDecodeStructure,DecodeFull,ValidateStructureandValidateFull. - Removed property
SharpnessAcceptanceFactorfromGenericDocumentRecognizerandGenericDocumentRecognizerConfigurationfor RTU UI screen. - Removed redundant fields
BarcodeImagePathandBarcodePreviewFramePathfromResultclass in Barcode Scanner RTU UI v2. - Changed
BarcodesRegexFilterconfig behavior for Barcode Scanner RTU UI v2. Barcodes are accepted if the barcode data contains the part that matches the regex. - Replaced
StandardandValidationStatusfields withValidationErrorsin theGS1.Elementclass.
- IMPORTANT Dropped support for the target
- π Under the hood:
- Updated the native SDK to Android Document SDK 6.1.2.
iOSβ
- π New:
- Added new RTU-UI V2 component, see
SBSDKUI2DocumentScannerController. - Added document capture animation in
SBSDKDocumentScannerViewController. - Added
CaptureAnimationConfiguration(...)andPolygonConfigurationFor(...)method toSBSDKDocumentScannerViewControllerDelegate. - Added class
SBSDKDocumentAnimationConfigurationto configure document capture animation. - Added classes
SBSDKScannedDocumentandSBSDKScannedPage. - Added support for the new
SBSDKScannedDocumentclass toSBSDKPDFRenderer,SBSDKUIPDFRenderer,SBSDKTIFFImageWriterandSBSDKOpticalCharacterRecognizer. - Added new constructor to
SBSDKUI2Colorthat initializes fromSBSDKUI2Color(UIColor uiColor). - Added new property
IsAnimatingCapturetoSBSDKDocumentScannerViewController. - Added new class
SBSDKDocumentScannerPolygonConfiguration. - Added new properties
PolygonConfigurationAccepted,PolygonConfigurationRejectedandAutoSnapProgressPolygonConfigurationtoSBSDKDocumentScannerViewController. - Added new method
DidDetectPolygon(...)toSBSDKImageEditingViewControllerDelegate. - Added new property
AddAdditionalQuietZonetoSBSDKBarcodeAdditionalParameters. - Added new property
PostalTypestoSBSDKBarcodeType. - Added a new property
HardwareButtonsEnabledthat enables snapping from the hardware volume buttons and the new hardware camera control button toSBSDKDocumentScannerViewControllerandSBSDKBarcodeScanAndCountViewController, available on iOS 17.2 and later. - Added support for German health insurance cards (front side) and European health insurance cards to
SBSDKGenericDocumentRecognizer,SBSDKGenericDocumentRecognizerViewControllerandSBSDKUIGenericDocumentViewController. - Added support for new barcode types Maxicode, rMQR code, Code 11 and Code 32.
- Added properties
AustraliaPostCustomerFormat,UseIATA2OF5ChecksumandUseCode11ChecksumtoSBSDKBarcodeAdditionalParametersandSBSDKUI2BarcodeRecognizerConfiguration. - Added support for PDF metadata attributes when rendering PDF files: see new class
SBSDKPDFAttributesand new propertypdfAttributesinSBSDKPDFRendererOptions. - Added new properties
resultAccumulatorConfigurationtoSBSDKGenericDocumentRecognizerandSBSDKGenericDocumentRecognizerViewController. See new classSBSDKGenericDocumentRecognizerAccumulationConfiguration. - Added new zoom control slider controlled by the new camera control button on all view controllers, available on all the new iPhone 16 models.
- Added a new property
AllowEmptySubmissiontoSBSDKUI2MultipleScanningMode.
- Added new RTU-UI V2 component, see
- π Improvements:
- Improved sharpness of captured images in
SBSDKDocumentScannerViewControllerby tweaking various timing related default values, such asInitialScanDelayandAutoSnappingDelay. - The AR-overlay in
SBSDKUI2FindAndPickScanningModeis now visible by default. - For CODE_128 and ITF, we improved the recognition of barcodes generated by defective thermal printers that do not print certain black bars correctly.
- Improved detection of UPC and EAN extensions.
- The Generic Document Recognizer and its UI components now use the new Scanbot OCR engine under the hood. In order to scan for generic documents the additional OCR language data bundle is no longer required.
- Improved document detection on booklet documents.
- Improved performance of
SBSDKDocumentQualityAnalyzer. - Added support for Extended Channel Interpretation (ECI) for Datamatrix and Aztec.
- Improved GS1 string handling with new modes for decoding and validation. See
SBSDKGS1Handling. - Added the ability to display the scanned barcodes image in the FindAndPick usecase of
SBSDKUI2BarcodeScannerViewControllerby specifyingSBSDKUI2ExpectedBarcode.barcodeImageKeyfor the expected barcodesImageproperty.
- Improved sharpness of captured images in
- π Bug fixes:
- Fixed a bug in RTU-UI v2 Barcode Scanner where extended barcodes are displayed along with their non-extended versions.
- Fixed a bug in the Find & Pick use case of
SBSDKUI2BarcodeScannerViewControllerthat never showed the expected barcodes title, but always the barcode value. - Fixed a UI issue in the RTU-UI v2 Barcode Scanner where a title that was too long would cut off the cancel button.
- Fixed a UI issue in
SBSDKFinderViewwhere the background color overlapped with the line color. - Fixed a UI issue in the RTU-UI v2 Find & Pick scanner in
buttonsheet mode where the counter badge was not visible. - Fixed a crash when zooming with invalid
MinZoomandMaxZoomvalues. - Fixed a bug that did not mirror the front camera as expected.
- Fixed a bug in
SBSDKUI2SingleScanDialogModelProviderwhere the default displayed texts were not correct. - Fixed KANJI mode for QR codes.
- Fixed a bug with wrong raw bytes returned for some 2D barcode types.
- Fixed potential broken generic document field validation status that could lead to a crash or undefined behavior.
- Fixed a UI issue on the RTU-UI v2 barcode sheet screen where the subtitle label was being vertically cut off.
- Fixed a UI issue on the RTU-UI v2 barcode confirmation sheet in the single use case where the loading indicator was not centered when the loading message was hidden.
- Fixed a bug in
CompressionofSBSDKTIFFImageWriterParameterswhere theSBSDKTIFFImageWriterwas not using the chosen compression value. - Fixed a bug in
SBSDKCheckRecognizerwhere theAcceptedCheckTypeswere not being applied correctly. - Fixed a bug in
SBSDKUICheckRecognizerViewControllerwhere theAcceptedCheckStandardswere not being applied correctly.
- β οΈ Breaking Changes:
- IMPORTANT Dropped support for the target
.net7.0-ios. - Deprecated
SBSDKUIDocumentScannerViewController,SBSDKUIFinderDocumentScannerViewController,SBSDKUICroppingViewControllerand their related classes. - Removed enum
SBSDKBarcodeDensity. - Removed property
CodeDensityfromSBSDKBarcodeAdditionalParameters. - Removed enum values
ValidateandDecodefromSBSDKGS1Handlingand replaced them byDecodeStructure,DecodeFull,ValidateStructureandValidateFull. - Removed property
SharpnessAcceptanceFactorfromSBSDKGenericDocumentRecognizer,SBSDKGenericDocumentRecognizerViewControllerandSBSDKUIGenericDocumentRecognizerBehaviorConfiguration. - Removed property
isAccumulatingDocumentsfromSBSDKGenericDocumentRecognizerandSBSDKGenericDocumentRecognizerViewController. - Deprecated
SBSDKHealthInsuranceCardRecognizer,SBSDKHealthInsuranceCardScannerViewControllerandSBSDKUIHealthInsuranceCardScannerViewController. - Removed class
SBSDKPDFMetadataEditor. - Renamed the values of the enum
SBSDKDocumentDetectionStatus. - Removed optional delegate methods
PolygonFillColorFor(...)andPolygonFillColorFor(...)fromSBSDKDocumentScannerViewControllerDelegateclass. - Removed properties
PolygonLineWidth,PolygonLineColorAccepted,PolygonLineColorRejected,PolygonFillColorAccepted,PolygonFillColorRejected,PolygonAutoSnapProgressEnabled,PolygonAutoSnapProgressColor,PolygonAutoSnapProgressLineWidthandPolygonCornerRadiusfromSBSDKDocumentScannerViewController. - Renamed property
ResidencePermitFronBacktoResidencePermitFrontBackinSBSDKUIDocumentType. - Removed parameter
Encrypterfrom allSBSDKPDFRenderermethods and added it to the initializer of the class.
- IMPORTANT Dropped support for the target
- π Under the hood:
- Updated the native SDK to iOS Document SDK 6.1.1.
.NET - Version 5.1.1 (4 Oct 2024)β
- π Bug fixes:
- Fixed reference issues when using our .NET package in more complex project structures.
.NET - Version 5.1.0 (15 Aug 2024)β
Androidβ
- π New:
- Added new freshly designed RTU-UI version 2 for Barcode scanning with advanced agile configuration.
- Added support for new barcode format BarcodeFormat.MicroPdf417.
- Added support for Canadian and UAE Check standards.
- Added support for parsing of AAMVA Certificate of Title for motor vehicle barcodes.
- Added new ParametricFilters in ImageProcessor API
- ScanbotBinarizationFilter
- CustomBinarizationFilter
- ColorDocumentFilter
- BrightnessFilter
- ContrastFilter
- GrayscaleFilter
- WhiteBlackPointFilter
- LegacyFilter
- Added support for German residence permits (2011 and 2019 formats) in GenericDocumentRecognizer.
- π Improvements:
- Optimized speed of the camera preview frames handling for all scanners.
- Changed the touch to focus square in ScanbotCameraXView to a circle.
- π Bug fixes:
- For BarcodeFormat.Pdf417, a single case to generate clusters was not covered, which led to a crash.
- Fixed issue with misaligned barcode polygons on some devices with horizontal orientation.
- Fixed SoundController crash on Android API <= 23.
- Fixed VinScannerConfiguration.setFinderTextHintColor(color) not being applied to the text hint.
- Fixed null pointer exception for PageFileStorage operations.
- β οΈ Breaking Changes:
- BatchBarcodeScannerActivity class from RTU UI v1 is now marked as 'Deprecated'.
- Renamed Rss14 barcode format to Databar and RssExpanded to DatabarExpanded.
- Removed BarcodeFormat.Code25 from BarcodeFormat.CommonCodes list.
- Deleted deprecated IsLicenseActive and IsLicenseValid from ScanbotSDK. Please use LicenseInfo.IsValid instead.
- ZoomRange can be created with any input values but will be limited under the hood by internal MinZoom (x0.2) and MaxZoom (x100) values.
- Replaced the class BarCodeFormattedResult by GenericDocument class for barcode document parser output.
- BarcodeExtensionsFilter now accepts EAN and UPC barcodes with extensions only and all other formats without extensions.
- All HealthInsuranceCard prefixes in result model class names were replaced with Ehic (EhicRecognitionResult, EhicDetectionStatus, etc.).
- π Under the hood:
- Updated the native SDK to Android Document SDK 5.1.2.
- Updated 3rd-party libraries:
- libjpeg-turbo to 2.1.5.1
- libpng to 1.6.40
- libtiff to 4.6.0
- Added third-party library libzueci 1.0.0 and zlib 1.3.1.
- Extracted parts of ScanbotBarcodeScannerSDK API to the ILicensableSdk and IBarcodeScanningSdk interfaces.
- Migrated project to AGP 8.x.
- Added more rules for R8 shrinker to work adequately with AGP >= 8.
- Added Theme.AppCompat.NoActionBar theme as default for Barcode Scanner RTU UI v2 activity.
- Added Consumer Proguard rules for RTU UI v2 modules.
- Class SoundController was renamed to SoundControllerImpl and interface SoundController was extracted.
iOSβ
- π New:
- Added new freshly designed RTU-UI version 2 for Barcode scanning with advanced agile configuration.
- Added support for new barcode type SBSDKBarcodeType.MicroPdf417.
- Added support for Canadian and UAE Check standards.
- Added support for parsing of AAMVA Certificate of Title for motor vehicle barcodes.
- Added various properties to SBSDKBaseScannerViewController and SBSDKBarcodeScannerViewController:
- Added new property RegularExpressionPattern to SBSDKBarcodeScannerViewController and SBSDKBarcodeScanner to limit detection results.
- Added IsCameraFrozen property to SBSDKBaseScannerViewController.
- Added new function ResetAccumulation to SBSDKBarcodeScannerViewController.
- Added the ViewFinderStyle property to SBSDKBaseScannerViewController.
- Added new classes for all the barcode document formats. See the API documentation for more details.
- Added a new class SBSDKBarcodeDocumentConstants which has all the constants related to the barcode document format.
- Added a new class SBSDKBarcodeDocumentRootType which replaces the old SBSDKBarCodeScannerDocumentFormat.
- Added possibility to inject an image to simulate a video stream and a captured image to any scanner's camera session for UI testing. See ScanbotSDKGlobal.TestData, SBSDKTestData and SBSDKSimulatedCameraMockData.
- Added streaming encryption support to SBSDKStorageCrypting.
- Added Privacy manifest file (PrivacyInfo.xcprivacy) to the SDK.
- Added new static property MaximumRecommendedImageSize to SBSDKDeviceInformation.
- Added new class-based image filters with customizable parameters:
- SBSDKParametricFilter (abstract base class)
- SBSDKScanbotBinarizationFilter
- SBSDKCustomBinarizationFilter
- SBSDKColorDocumentFilter
- SBSDKBrightnessFilter
- SBSDKContrastFilter
- SBSDKGrayscaleFilter
- SBSDKWhiteBlackPointFilter
- SBSDKLegacyFilter (encapsulates the deprecated SBSDKImageFilterType filters)
- Added support for German residence permit documents to SBSDKGenericDocumentRecognizer. See SBSDKGenericDocumentRootType.
- Added a new configuration class SBSDKHealthInsuranceCardRecognizerParameters to configure the live detection recognizer in SBSDKHealthInsuranceCardRecognizer.
- Added a new property liveDetectionParameters in SBSDKHealthInsuranceCardRecognizer.
- Added a new property recognizerParameters in SBSDKHealthInsuranceCardScannerViewController and SBSDKUIHealthInsuranceCardScannerViewController.
- Added property acceptedBrightnessThreshold to SBSDKDocumentScanner, SBSDKDocumentScannerViewController, SBSDKUIDocumentScannerBehaviourConfiguration and SBSDKUIFinderDocumentScannerBehaviorConfiguration.
- Added property averageBrightness to SBSDKDocumentDetectionMetrics.
- π Improvements:
- IMPORTANT: Changed the default rear cameras on all scanners to the triple or dual camera. On some devices with triple camera this results in a different view port (more zoomed in). Please make sure to adapt your zoom ranges and factors.
- Improved detection of UPC/EAN barcode extensions in live mode.
- Improved image quality and capture speed on most iOS devices slightly by capturing HEIF images.
- Added support of haptic feedback on capable devices.
- SBSDKPDFPagesExtractor functions now create the output directory if it doesn't exist yet.
- Added support for structured logging (OSLog) to the SDK (iOS 14+).
- The health insurance card recognizer now implements the new scanbot OCR engine. The recognition is faster and more accurate than before.
- π Bug fixes:
- Changed privacy manifest to comply with the latest Apple specs.
- Fixes a bug with the asynchronous functions of SBSDKPDFPagesExtractor which returned an empty array of image URLs.
- Fixed a bug with the generic textline recognizer not returning multiline results.
- β οΈ Breaking Changes:
- IMPORTANT: The default rear camera in all scanners has been changed from the ultra-wide or wide camera to the triple or dual camera.
- Deprecated SBSDKUIBarcodeScannerViewController and SBSDKUIBarcodesBatchScannerViewController along with their related classes. Please consider switching to the new SBSDKUI2BarcodeScannerViewController.
- Renamed function CaptureJPEGStillImage to CaptureStillImageWithCompletionHandler in SBSDKBaseScannerViewController (and all subclasses) and SBSDKCameraSession.
- Replaced the class SBSDKBarcodeDocumentType with SBSDKBarcodeDocumentRootType.
- Removed the protocol SBSDKBarCodeScannerDocumentFormat and all of its children classes.
- Changed SetLoggingEnabled to property IsLoggingEnabled in SBSDKLog.
- Changed all SBSDKBarcodeType global constants to static properties of SBSDKBarcodeType.
- Moved the global constants SBSDKBarcodeMetadataEANUPCExtensionKey and SBSDKBarcodeMetadataIsGS1MessageKey to SBSDKBarcodeScannerResult as its static properties.
- Removed types
Ccittfax3andCcittfax4fromSBSDKTIFFImageWriterCompressionOptions. UseCcitt_t4andCcitt_t6respectively.
- π Under the hood:
- Updated the native SDK to iOS Document SDK 5.1.3.
- Updated third-party libraries zlib to version 1.3.1, libtiff to 4.6.0, libjpeg-turbo to 2.1.5.1, libpng to 1.6.40.
- Added third-party library libzueci version 1.0.0.
- Refactored all public SDK code to Swift.
.NET - Version 4.2.0 (23 Apr 2024)β
- π New:
- Both Android and iOS:
- Added new feature - Document Quality Analyzer. It analyzes the text quality (legibility) on images.
- Added new component - VIN (Vehicle identification number) scanner.
- New generation of Text Data Scanner component. The quality and speed of scanning has significantly improved.
- MRZ support for td1 long document standard.
- Added support for Kuwait ID cards in the MRZ scanner.
- Added support for Israelian checks to the check recognizer. Check
SBSDKCheckDocumentRootTypeandIO.Scanbot.Check.Entity.RootDocumentTypeenums. - Added support for more PDF page sizes. Check
SBSDKPDFRendererPageSizeandIO.Scanbot.Sdk.Model.PageSizeenums. - Added support for PDF orientations. Check
SBSDKPDFRendererPageOrientationandIO.Scanbot.Pdf.Model.PageDirectionenums.
- Android:
- Added new supported barcode formats. Check
BarcodeFormatenum for:UspsIntelligentMailRoyalMailJapanPostRoyalTntPostAustraliaPostGs1CompositeDatabarLimited
- The new PDF renderer for simple PDF and "sandwiched" PDF generation also allows flexibility to add custom PDF metadata.
- Added new supported barcode formats. Check
- iOS:
- Added new classes
SBSDKDocumentQualityAnalyzer,SBSDKOpticalCharacterRecognizer,SBSDKOpticalCharacterRecognizerConfigurationandSBSDKTextLayoutRecognizer. - Added
TrackingOverlayControllerproperty toSBSDKBarcodeScannerViewController. - Added property
ExtensionFilterto all barcode scanning APIs and added propertyExtensiontoSBSDKBarcodeScannerResult. - Introduced new classes and properties to manage barcode tracking overlay.
- Added functions to
SBSDKDeviceInformationto get the total, used and unused disk space on the device. - Added Privacy manifest file (PrivacyInfo.xcprivacy) to the SDK which complies with the latest Apple specs.
- Added
SetupDefaultLicenseFailureHandlerWithCompletionmethod to theScanbotSDKGlobalclass. - Added new method
WidestAvailableBackFacingCameratoSBSDKCameraDevice. - Added support for new barcode types. Check
SBSDKBarcodeTypeenum for:USPSIntelligentMailRoyalMailJapanPostRoyalTNTPostAustraliaPostGS1CompositeDatabarLimited
- Added new classes
- Both Android and iOS:
- π Improvements:
- Both Android and iOS:
- Added new Optical Character Recognition engine based on machine learning algorithms that is much faster and less error-prone. The new OCR engine currently supports all languages with Latin letters, there is no need to specify the languages for it. The legacy engine based on Tesseract can still be used.
- Added more control over how to handle GS1 messages in barcodes. Check Gs1 Handling property in the Barcode scanner configurations classes.
- Improved the document detector with better performance and less memory consumption.
- Android:
- Added
SetBarcodeFormatsFilter(barcodeFormat: List<BarcodeFormat>)method inBatchBarcodeScannerConfigurationclass. - Optimized default and custom preview/picture size selection in the
ScanbotCameraXView. - Optimized
SetForceMaxSnappingSize(enabled: bool)behavior in theScanbotCameraXView. - Improved pinch-to-zoom gesture in
ScanbotCameraXView. - Added
SetLifecycleOwner(lifecycleOwner: ILifecycleOwner)method forViewControllerinDocumentScannerViewandBarcodeScannerViewto improve compatibility with Compose UI.
- Added
- Both Android and iOS:
- π Bug fixes:
- Android:
- Fixed some OOM crashes on low to midrange devices.
- Fixed
EnableCameraButtonTitleandEnableCameraExplanationTextparameters on Batch and Barcode RTU UI screen configs. - Fixed crash in
GenericTextRecognizeron ARM v7 devices. - Fixed behavior of
OcrResolutionLimitconfiguration inGenericTextRecognizer.
- iOS:
- Fixed a bug where the finder text hint was still showing when
ViewFinderEnabledwas disabled inSBSDKUIBarcodeScannerViewControllerandSBSDKUIBarcodesBatchScannerViewController. - Fixed a wrong polygon color in RTU-UI barcode scanner tracking overlay.
- Fixed an issue where the MRZ Scanner was not recognizing the new standard of Belgian ID Cards.
- Fixed the issue when the top and bottom toolbars' background color in
SBSDKUICroppingViewControllerdidn't update on dark mode change, when set toUIColor.SystemBackground.
- Fixed a bug where the finder text hint was still showing when
- Android:
- β οΈ Breaking changes:
- Android:
- If you are using
SetPictureSize(pictureSize: Size),SetCameraFrameSize(frameSize: Size)orSetPreviewFrameSize(frameSize: Size), make sure input Size has the correct orientation (fits the view or display size). - All scanner components have been switched to zoom ratio (values 1x, 2x, etc.) instead of linear zoom (from 0 to 1). Methods renamed:
SetOpticalZoomRange()->SetPhysicalZoomRange(),SetOpticalZoomLevel()->SetPhysicalZoomRatio()inScanbotCameraXView,DocumentScannerView,BarcodeScanAndCountViewandBarcodeScannerView.setPhysicalZoomRange()andsetPhysicalZoomRatio()accept possible zoom values from 0.5x up to 100x. NOTE: if the value sent to the camera is out of range for a specific device's capabilities, then the camera will try to set the max or min possible for that specific device. eg. Zoom 100x will only work on some high-end Samsung devices, whereas other devices will only have 12x-30x max. The same goes for minimum supported values, 0.5x is a wide-format camera module that does not exist on many Android devices. - Removed deprecated
BlurEstimatorand addedDocumentQualityAnalyzerfeature. Please use SDK functionCreateDocumentQualityAnalyzer(...)instead ofCreateBlurEstimator(...). - Changed signature of
RenderDocumentFromImages()andRenderDocumentFromPages()methods -pageSize: PDFPageSizewas replaced with more detailedpdfConfig: PdfConfigparameter. - Changed namespace from
IO.Scanbot.Sdk.Process.PDFPageSizetoIO.Scanbot.Pdf.Model.PageSize. - Removed parameter
forceCpu: BooleanfromImageProcessormethods. - The
TextDataScannerConfigurationnow requires an instance ofTextDataScannerStepfor initialization. - Replaced
CameraModule.FrontMirroredwithCameraModule.Front, which behaves as mirrored mode.
- If you are using
- iOS:
- Removed
SBSDKImageMetricsAnalyzer,SBSDKImageChannelMetricsandUIImage+SBSDKMetricsAnalysis. - Refactored all OCR and PDF rendering classes to incorporate the new OCR engine and simplify the APIs.
- Removed
SBSDKOpticalTextRecognizerandSBSDKTextOrientationRecognizer. - Renamed
SBSDKPageOrientationtoSBSDKTextOrientation. - Changed function signatures of methods in
SBSDKPDFRendererandSBSDKUIPDFRenderer. - Added new values and removed unused values in
SBSDKPDFRendererPageSize. - Removed barcode type
SBSDKBarcodeTypeUnknown. - Removed property
AutoCancelTimeoutfromSBSDKUIMRZScannerBehaviorConfiguration. - Removed
TextRecognitionLanguagesandTextFilterStrategyfromSBSDKGenericTextLineRecognizerViewController. - Removed
TextFilterStrategyfromSBSDKUITextDataScannerStep. - Removed
SupportedLanguagesfromSBSDKUITextDataScannerBehaviorConfiguration. - Removed
SelectionOverlayTextForfromSBSDKUIBarcodeScannerViewControllerDelegate. - Renamed
SelectionOverlayConfigurationtoTrackingOverlayConfigurationinSBSDKUIBarcodeScannerConfigurationandSBSDKUIBarcodesBatchScannerConfiguration. - Renamed
SBSDKUIBarcodeSelectionOverlayConfigurationtoSBSDKUIBarcodeTrackingOverlayConfiguration. - Replaced the properties
PolygonEnabled,PolygonColor,PolygonFillColorandPolygonLineWidthby the propertyPolygonStyleinSBSDKBarcodeScanAndCountViewController. - The class
SBSDKBlurrinessEstimatorhas been removed and replaced by the far superiorSBSDKDocumentQualityAnalyzer. - Changed default value of the finder aspect ratio in
SBSDKUIFinderDocumentScannerUIConfigurationto DIN A4 portrait. - Removed prefix
Sbsdk_from all the method names inUIImage_SBSDKFiltersAndWarpinginterface. (eg:Sbsdk_imageWarpedByPolygontoImageWarpedByPolygon).
- Removed
- Android:
- π Under the hood:
- The native Scanbot Android SDK upgraded to v4.2.0.
- The native Scanbot iOS SDK upgraded to v4.2.2.
.NET - Version 2.3.1 (11 Oct 2023)β
- π Bug fixes:
- Fixed a focusing issue with the new iPhone 15 Pro and 15 Pro Max.
.NET - Version 2.3.0 (15 Sep 2023)β
- π New:
- Both Android and iOS:.
- Added support for the Micro QR barcode type.
- Added view finder flag for barcode scanners (see more details below).
- Added support for Scan and Count of Barcodes (see more details below).
- Android:
- Added new function
setViewFinderEnabledto:IO.Scanbot.Sdk.UI.View.Barcode.Configuration.BarcodeScannerConfigurationIO.Scanbot.Sdk.UI.View.Barcode.Batch.Configuration.BatchBarcodeScannerConfiguration
- Introduced a scanned barcode confirmation dialog in
IO.Scanbot.Sdk.UI.View.Barcode.BarcodeScannerActivityRTU screen:- Added
SetConfirmationDialogConfigurationtoIO.Scanbot.Sdk.UI.View.Barcode.Configuration.BarcodeScannerConfigurationfor modifying dialog UI.
- Added
- Added Scan and Count of Barcodes feature.
- Use
IO.Scanbot.Sdk.Barcode.UI.BarcodeScanAndCountViewto integrate it into your app.
- Use
- Added new function
- iOS:
- Added new property
ViewFinderEnabledto:ScanbotSDK.iOS.SBSDKUIBarcodeScannerBehaviorConfigurationScanbotSDK.iOS.SBSDKUIBarcodesBatchScannerBehaviorConfiguration
- Added new Classic UI component
Scanbot.iOS.SBSDKBarcodeScanAndCountViewControllerwhich enables you to scan barcodes multiple times using the shutter button. - Added new properties
ConfirmationDialogTitleandConfirmationDialogMessagetoScanbotSDK.iOS.SBSDKUIBarcodeScannerTextConfiguration.
- Machine-readable-zone results have been refactored (please see β οΈ Breaking changes):
- Added new properties to
ScanbotSDK.iOS.SBSDKMachineReadableZoneRecognizerResult:GenericDocumentTravelDocumentTypeVariantFieldDateOfIssueField
- Added new value
CrewMemberCertificateto theScanbot.iOS.SBSDKMachineReadableZoneRecognizerResultDocumentTypeenum. - Added new values to the
Scanbot.iOS.SBSDKMachineReadableZoneRecognizerFieldNameenum:DateOfIssuanceTravelDocumentTypeVariant
- Added new properties to
- Added new function
FlipHorizontallytoScanbotSDK.iOS.SBSDKPolygon. - Added new property
IsMirroredtoScanbotSDK.iOS.SBSDKCameraDevice.
- Added new property
- Both Android and iOS:.
- π Improvements:
- Both Android and iOS:
- Improved accuracy and detection speed of several barcode types, such as QR_CODE, Code39, and Code93.
- Added support for inverted PDF-417 barcodes.
- iOS:
- Changed the default value for the
DocumentTypeproperty inScanbot.iOS.SBSDKUIGenericDocumentRecognizerBehaviorConfiguration- All documents are recognised by default now.
- Changed the default zoom range from (0.0 - 3.0) to (0.0 - 12.0) in:
- All Classic UI components
- All RTU-UI components
- The
ScanbotSDK.iOS.SBSDKZoomRangeclass
- Support for generic documents in the MRZ recognizer.
- Changed the default value for the
- Both Android and iOS:
- π Bug fixes:
- Android:
- Fixed a crash within the barcode detector.
- Fixed detection of several RSS_EXPANDED false-positives in live mode.
- Fixed a bug causing incorrect (mirrored) preview when
CameraModule.Frontis set up forIO.Scanbot.Sdk.UI.Camera.ScanbotCameraXView. - Fixed the logic in
setAutoSnapProgressEnabledandsetPolygonAutoSnapProgressEnabledmethods in:IO.Scanbot.Sdk.UI.View.Camera.Configuration.FinderDocumentScannerConfigurationIO.Scanbot.Sdk.UI.View.Camera.Configuration.DocumentScannerConfiguration
- Fixed
TextDataScaner.textDataScannerStepnot applying from JSON configuration. - Ignored iOS-only parameter
shutterButtonIndicatorColorwhen mapping:IO.Scanbot.Sdk.UI.View.Camera.Configuration.DocumentScannerConfigurationIO.Scanbot.Sdk.UI.View.Camera.Configuration.FinderDocumentScannerConfiguration
- Corrected mapping of
userGuidanceStringsJSON configuration forIO.Scanbot.Sdk.UI.View.Check.Configuration.CheckRecognizerConfiguration.
- iOS:
- Fixed the detection of a few false positive RSS Expanded codes in live mode.
- Fixed an unexpected behavior of the barcode scanner when passing
ScanbotSDK.iOS.SBSDKBarcodeType.Unknownas accepted barcode type. - Fixed a bug in all Classic UI and RTU-UI components where the
RecognitionEnabledproperty might not have worked as intended. - Fixed a bug where
ocrResolutionLimitwas not being used in:ScanbotSDK.iOS.SBSDKUITextDataScannerBehaviorConfigurationfrom JSON. - Fixed a bug where the polygon should be mirrored when using the front camera in:
ScanbotSDK.iOS.SBSDKDocumentScannerViewControllerScanbotSDK.iOS.SBSDKUIDocumentScannerViewController
- Fixed a bug where
automaticSelectionEnabledwas not working properly inScanbotSDK.iOS.SBSDKUIBarcodesBatchScannerViewController.
- Android:
- β οΈ Breaking changes:
- Android:
- API breaking changes in the MRZ scanner result interface:
- Replaced
IO.Scanbot.Mrzscanner.Model.MRZRecognitionResultresult model class withIO.Scanbot.Mrzscanner.Model.MRZGenericDocument. - Removed the
Fieldslist andMRZFieldclass, instead:- All detected fields are now stored in the
Document.Fieldslist inIO.Scanbot.Mrzscanner.Model.MRZGenericDocument.
- All detected fields are now stored in the
- The
travelDocType: MRZDocumentTypeis now represented by thedocumentType: MRZDocumentTypefield in theMRZGenericDocumentinstance.
- Date fields in the
IO.Scanbot.Mrzscanner.Model.MRZGenericDocumentresult model now contain an unformatted date string. - Replaced
IO.Scanbot.Mrzscanner.Model.MRZDocumentTypeclass withIO.Scanbot.Mrzscanner.Model.MRZGenericDocument.MRZDocumentType.
- Replaced
- API breaking changes in the MRZ scanner result interface:
- iOS:
- Several delegate method names were renamed, such as:
ScanbotSDK.iOS.SBSDKCheckRecognizerViewControllerDelegate:CheckRecognizerViewControllertoDidRecognizeCheck.CheckRecognizerViewControllertoDidChangeState.CheckRecognizerViewControllerShouldRecognizetoShouldRecognize.
ScanbotSDK.iOS.SBSDKGenericDocumentRecognizerViewControllerDelegate:DocumentRecognizerViewControllertoDidRecognizeResult.GenericDocumentRecognizerViewControllerShouldRecognizetoShouldRecognize.
ScanbotSDK.iOS.SBSDKHealthInsuranceCardScannerViewControllerDelegate:HealthInsuranceCardScannerViewControllertoDidScanHealthInsuranceCard.HealthInsuranceCardScannerViewControllerShouldRecognizetoShouldRecognize.
ScanbotSDK.iOS.SBSDKUIHealthInsuranceCardScannerViewControllerDelegate:HealthInsuranceCardDetectionViewControllertoDidDetectCard.HealthInsuranceCardDetectionViewControllerDidCanceltoDidCancel.
ScanbotSDK.iOS.SBSDKImageEditingViewControllerDelegate:ImageEditingViewControllertoDidApplyChangesWithPolygon.ImageEditingViewControllerDidCancelChangestoDidCancelChanges.ImageEditingViewControllerDidChangePolygontoDidChangePolygon.ImageEditingViewControllerCancelButtonItemtoCancelButtonItem.ImageEditingViewControllerApplyButtonItemtoApplyButtonItem.ImageEditingViewControllerToolbarStyletoToolbarStyle.ImageEditingViewControllerToolbarTintColortoToolbarTintColor.ImageEditingViewControllerToolbarItemTintColortoToolbarItemTintColor.ImageEditingViewControllerRotateClockwiseToolbarItemtoRotateClockwiseToolbarItem.ImageEditingViewControllerRotateCounterClockwiseToolbarItemtoRotateCounterClockwiseToolbarItem.
ScanbotSDK.iOS.SBSDKDocumentScannerViewControllerDelegate:DocumentScannerViewControllertoDidSnapDocumentImage.DocumentScannerViewControllerShouldDetectDocumenttoShouldDetectDocument.DocumentScannerControllertoDidSampleVideoFrame.DocumentScannerViewControllerWillSnapImagetoWillSnapImage.DocumentScannerViewControllerDidFailSnappingImagetoDidFailSnappingImage.DocumentScannerViewControllertoShouldAutoSnapImageWithForDetectionResult.DocumentScannerViewControllerLineColortoPolygonLineColorForStatus.DocumentScannerViewControllertoPolygonFillColorForStatus.DocumentScannerViewControllertoConfigureStatusDetectionLabel.
ScanbotSDK.iOS.SBSDKUIGenericDocumentRecognizerViewControllerDelegate:GenericDocumentRecognizerViewControllertoDidFinishWithDocuments.GenericDocumentRecognizerViewControllerDidCanceltoDidCancel.
ScanbotSDK.iOS.SBSDKMedicalCertificateScannerViewControllerDelegate:MedicalCertificateScannerViewControllertoDidRecognizeMedicalCertificate.MedicalCertificateScannerViewControllerShouldRecognizetoShouldRecognize.MedicalCertificateScannerViewControllertoDidChangeState.
ScanbotSDK.iOS.SBSDKUIMedicalCertificateScannerViewControllerDelegate:MedicalScannerViewControllertoDidFinishWithResult.MedicalScannerViewControllerDidCanceltoDidCancel.
ScanbotSDK.iOS.SBSDKUIViewControllerDelegate:ViewControllerShouldCanceltoShouldCancel.ViewControllerShouldFinishtoShouldFinish.
- Removed support for iOS 11.x and 12.x. The minimum deployment target to use ScanbotSDK in your app is iOS 13.0!
- Removed classes:
ScanbotSDK.iOS.SBSDKUIMachineCodesCollectionScanbotSDK.iOS.SBSDKMultipleObjectScannerViewControllerScanbotSDK.iOS.SBSDKBusinessCardsImageProcessorScanbotSDK.iOS.SBSDKMultipleObjectsDetectorScanbotSDK.iOS.SBSDKUIMultipleObjectScannerViewControllerand its configuration classes.ScanbotSDK.iOS.SBSDKBaseCameraViewController
- Renamed the property
AcceptedMachineCodeTypestoAcceptedBarcodeTypesin:ScanbotSDK.iOS.SBSDKUIBarcodeScannerBehaviorConfigurationScanbotSDK.iOS.SBSDKUIBarcodesBatchScannerBehaviorConfiguration
- Machine-readable-zone results have been refactored:
- Date fields in machine-readable-zones are returned unformatted now, e.g. in the format 'YYMMDD'. Previously we tried to convert them to the format 'DD.MM.YY'.
- Removed value
DiscreetIssuingStateOrOrganizationfrom theScanbotSDK.iOS.SBSDKMachineReadableZoneRecognizerFieldNameenum. - Removed value
TravelDocumentfrom theScanbotSDK.iOS.SBSDKMachineReadableZoneRecognizerResultDocumentTypeenum. - Removed property
DiscreetIssuingStateOrOrganizationFieldfromScanbotSDK.iOS.SBSDKMachineReadableZoneRecognizerResult. - Removed property
CheckDigitsCountfromScanbotSDK.iOS.SBSDKMachineReadableZoneRecognizerResult.
- Several delegate method names were renamed, such as:
- Android:
- π Under the hood:
- The native Scanbot Android SDK upgraded to v2.3.0.
- The native Scanbot iOS SDK upgraded to v2.3.1.
.NET - Version 2.2.0 (26 Jun 2023)β
- π First release of the
ScanbotSDK.NETNuGet package for Native iOS and Android APIs. - Provides Ready-To-Use UI Components - a set of easy to integrate Native wrappers of .NET based on iOS and Android native components for the most common tasks in Scanbot SDK:
- Document Scanner
- Cropping UI & ImageFilters
- Barcode & QR code Scanner
- MRZ Scanner
- Generic Document Recognizer
- EHIC Scanner
- Check Recognizer
- Provides additional SDK features based on image picked from the device photos application:
- Detect Barcodes on Image
- Detect Document on Image
- New unified Scanbot SDK API:
- Idiomatic asynchronous design
- MAUI-based unified API for Android & iOS
- Example App demonstrating the new functionality: scanbot-sdk-maui-example