Document Reader SDK 7.6

Document Reader SDK версии 7.6 доступен для скачивания по следующим ссылкам:

SDK также доступен для загрузки через нашу утилиту Regula Downloads Manager.

Перед тем как установить эту версию, пожалуйста, ознакомьтесь с информацией о произведенных изменениях и дополнениях (после версии 7.5):

ВАЖНЫЕ изменения

Существенная оптимизация использования памяти и улучшения стабильности в Core SDK.
Реализована новая проверка подлинности для динамических элементов безопасности Dynaprint®. Совместно с другими проверками динамических элементов, таких как OVI, голограммы, MLI, её применение расширяет возможности валидации живости документа.
Начиная с текущей версии мы повысили поддерживаемую версию диалекта C++ до С++17. Это значит, что мы не поддерживаем более старые версии компиляторов и более старые версии Linux, не поддерживающие стандарт C++17. Таким образом, изменены минимальные поддерживаемые версии для перечисленных ОС:
- Debian 11
- Ubuntu 20.04
- RHEL 9
- macOS 11
- iOS 13

Core SDK

Обнаружение и вырезание документа
- Исправлена ситуация с различием между результатами, получаемыми на мобильном устройстве, и результатами серверной обработки для того же пакета данных с мобильного устройства.
OCR
- Обновлено значение по умолчанию для свойства processParam.disablePerforationOCR – теперь оно true для мобильных и веб-платформ. Если необходимо чтение перфорированных полей, вам нужно вручную выставить значение свойства в false.
Машиносчитываемая зона (MRZ)
- Обновлены парсеры:
  - Cote d'Ivoire Residence Permit,
  - France DL,
  - Guinea ID Card,
  - Saint Vincent and the Grenadines ID Card,
  - Slovakia ePassport,
  - Tajikistan ePassport.
- Обновлена валидация машиносчитываемой зоны для некоторых нестандартных документов.
Штрихкоды
- Добавлены новые парсеры:
  - Canada DL,
  - Libya Visa,
  - Mexico DL,
  - Taiwan eVisa,
  - Vietnam ID Card and eVisas.
- Обновлены парсеры:
  - IATA Boarding passes,
  - Canada ID Card,
  - Chile ID Card,
  - France ID Card,
  - Moldova ID Card,
  - Philippines ID Card,
  - Saudi Arabia DL, ID and Resident Card.
- Добавлена проверка цифровой подписи для Philippines ID Card. Детали доступны в нашем техническом блоге.
- Исправлена ситуация с проверкой изображения в фокусе, несмотря на включённое свойство processParam.disableFocusingCheck
- Исправлена ситуация с транслитерацией буквы Ä для документа Moldova ID Card.
- Исправлена ситуация с чтением штрихкодов PDF417 при большом числе ячеек (> 930).
Парсинг и проверка текстовых данных
- Добавлена транслитерация с корейского языка на латиницу. На данный момент включена только для полей, содержащих имя.
- Добавлена генерация поля ft_Nationality_Code на основе значения ft_Nationality.
- Добавлено свойство processParam.strictDLCategoryExpiry, принудительно задающее, должна ли дата истечения категории водительских прав влиять на общий статус проверки документа. Так как документы обычно имеют собственные сроки действия, которые укладываются в дату истечения категории или превосходят её, использование этого свойства может быть полезным в специфических случаях.
- Добавлено разделение поля полного имени на отдельные поля ft_Surname и ft_Given_names на основе данных из других источников.
- Обновлена логика валидации поля ft_Voter_Key для документов Mexico Voter Cards.
- Обновлена логика валидации поля ft_Weight для документа USA DL, когда в штрихкоде обнаружены несколько значений различных форматов.
- Расширен список специальных символов, определяющих логику разделения имени и фамилии.
- Исправлена ситуация с валидацией полея ft_Date_of_Expiry для документов без срока действия.
- Исправлена ситуация с транслитерацией китайского языка на латиницу.
- Исправлена ситуация с валидацией нескольких допустимых вариантов масок полей для данных штрихкода.
- Исправлена ситуация с исключением при обработке некоторых индийских документов.
Проверки подлинности
- Реализована новая проверка подлинности для динамических элементов безопасности Dynaprint®. Совместно с другими проверками динамических элементов, таких как OVI, голограммы, MLI, её применение расширяет возможности валидации живости документа.
- Добавлено свойство checkSecurityText к параметрам подлинности (processParam.authParams.checkOcrSecurityText) для поддержки возможности включения/отключения проверки Security Text.
- Добавлено свойство checkBlackAndWhiteCopy к параметрам живости (processParam.authParams.livenessParams.checkBlackAndWhiteCopy) для поддержки возможности включения/отключения проверки на чёрно-белое изображение.
- Реализована возможность повторной обработки пакета данных, содержащего изображения в различных световых схемах, таких как УФ и ИК, которые могут быть получены с использованием устройств Regula 7310 и 1120.
- Повышена точность нейронных сетей для проверок повторного воспроизведения электронного устройства.
- Обновлён порядок приоритетов параметров: если используются оба processAuth и authParams, то authParams имеет больший приоритет, перезаписывая значение processAuth.
- Исправлена ситуация с вычислением статуса живости документа (Document Liveness) при обработке нескольких страниц.
- Исправлена ситуация с повторной серверной обработкой проверки на живость документа (Document Liveness) для нескольких страниц документа в одном пакете данных.
- Исправлена ситуация с проверкой LetterScreen++ для паспортов США.
- Исправлена ситуация с координатами голограммы в результатах проверки живости документа (Document Liveness).
- Исправлена ситуация с неверным определением формата для ламинированных документов, приводившая к ошибочным результатам проверки живости (Document Liveness).
- Исправлена ситуация с всегда активной проверкой checkBarcodeFormat вне зависимости от значения свойства processParam.authParams.checkBarcodeFormat
- Исправлена ситуация с возвращаемой областью, содержащей пустые координаты для результатов проверок подлинности. Теперь, если координаты недоступны, поле не будет возвращено в результатах.
- Исправлена ситуация с неверным количеством страниц в результате проверки подлинности в случае пропуска— если была обработана только одна страница, вторая иногда могла также быть отображена.
- Исправлена ситуация с данными проверки живости документа (Document Liveness), которые могли присутствовать после захвата мобильным устройством, но отсутствовать после обработки на стороне сервера.
- Исправлена ситуация с проверкой на блики в ходе процесса детекции голограммы, которая могла приводить к неверным результатам проверки качества изображения.
- Исправлена ситуация с общим статусом, когда проверка живости документа (Document Liveness) отключена и недоступна.
- Исправлена ситуация с игнорированием результатов сканирования второй страницы документа, когда вместо сканирования второй страницы по запросу, вновь использовалась та же первая страница. Теперь все необходимые результаты доступны в ответе.
Image QA
- Исправлена ситуация с некорректным статусом бликов в результатах проверки качества изображения при включённой проверке живости документа (Document Liveness).
Перечисления
- Добавлен новый член перечисления eBarCodeResultCodes:
  - bcrc_InvalidResult
- Добавлен новый член перечисления eBarCodeResultCodes:
  - chd_DocLiveness_DocumentNotLive
- Добавлен новый член перечисления eRPRM_SecurityFeatureType
  - SecurityFeatureType_Liveness_Dynaprint
- Добавлены новые члены перечисления eVisualFieldType
  - ft_Short_Flight_Number
  - ft_Airline_Code
Прочее
- - Существенная оптимизация использования памяти и улучшения стабильности в Core SDK. Сокращены избыточные выделения памяти, приводившие к фрагментации, которая могла рассматриваться как утечка памяти при длительном исполнении нескольких процессов.
  - Добавлена поддержка обработки многослойных PDF документов.
  - Улучшена логика сравнения портретов детей. Ранее в случае детских документов сравнение портретов не производилось вовсе. Теперь подобное сравнение осуществляется, и если портреты совпадают, тогда возвращается позитивный результат проверки вне зависимости от возрастного порога. Если портреты не совпадают, тогда анализируется возраст: если распознанный возраст превышает детский порог, возвращается отрицательный результат проверки, в противном случае возвращается значение wasNotDone.
  - Реализован новый подход к обнаружению и вырезанию документа посредством использования нейронных сетей на внешних устройствах.
  - Исправлена ситуация с деперсонализацией в случае представления документа в запросе в перевёрнутом виде.
  - Исправлена ситуация с проверкой границ документа, которая могла произойти в ходе обработки многостраничных документов.
  - Исправлена ситуация, когда XML результаты недоступны для RFID данных в случае включённого параметра processParam.xmlResults в запросе.
  - Исправлена ситуация с недоступностью некоторых файлов в db.dat
  - Исправлена ситуация с повторной серверной обработкой пакетов данных от устройств Regula 7310/1120.
  - Исправлена ситуация с вычислением статуса проверки типа документа в случае обработки многостраничного документа при работе с устройством Regula 1120.
  - Исправлена ситуация с нехваткой памяти при обработке пакета данных.
  - Качество кода улучшено за счёт исправления множества мелких ситуаций.

Core RFID SDK

Добавлена возможность загружать списки отозванных сертификатов (CRLs) во время выполнения, на основе расширения сертификата документа id-ce-cRLDistributionPoint.
Добавлены новые элементы перечисления eRFID_BaudRate:
- rfbr_1695
- rfbr_3390
- rfbr_6780
Исправлена ситуация с сохранением данных DTC для документов без RFID после предыдущего сканирования документов с поддержкой RFID.
Исправлена ситуация с различными результатами PA_Status для файла EF.SOD, реализованными в версии 7.5. Теперь восстановлена предыдущая логика.

Desktop API

Добавлена возможность отключить использование mrzproc.dll путём установки параметра processParameters.noMrzProc
Исправлена ситуация, при которой команда извлечения документа срабатывала только для активного считывателя при подключении нескольких устройств.

Mobile API

Добавлена поддержка локализации на армянском и кыргызском языках.
Незначительные изменения в анимации RFID – теперь она немного увеличена.
Поле status на уровне результатов подлинности по страницам устарело. Используйте общее значение статуса.
Добавлена возможность включения/отключения загрузки CRLs во время выполнения на основе DS-сертификата документа.
Добавлено свойство checkSecurityText в параметры подлинности.
Добавлены свойства checkBlackAndWhiteCopy и checkDynaprint в параметры liveness.
Свойство perspectiveAngle устарело – используйте expectedPass, передавая angleThreshold.
Добавлена возможность установить состояние фонарика перед началом обработки документа.
Добавлена возможность изменить смещение рамки камеры по ширине в альбомной ориентации.
Поле sessionLogFolder в классе ProcessParam устарело. Используйте DocumentReaderResults.transactionInfo.sessionLogFolder из результатов обработки.
Индикатор прогресса теперь автоматически центрируется в зависимости от позиции рамки камеры.
Обновлено перечисление групп данных DTC.
Обновлены демонстрационные проекты на GitHub.
Исправлен выбор камеры по умолчанию на некоторых устройствах.

Android

Добавлено разрешение "vibrate" для приложений, если вы хотите, чтобы устройства Regula 7310 начинали вибрацию при инициации обработки RFID-чипа.
Исправлен порядок сохранения папок логов, из-за чего возникала ситуация с некорректным путём возврата через processParams.sessionLogFolder
Исправлена ситуация, когда происходила деинициализация во время обработки документа SDK.
Исправлена ситуация с удалением базы данных, которую нельзя было удалить, если она была загружена частично.
Улучшен автофокус при обработке документа.
Повышена общая стабильность.

iOS

Минимальная версия iOS для развёртывания поднята с 12.0 до 13.0
Добавлена поддержка Server-Side Verification для приложений, использующих UI через childViewController
Исправлена ситуация при обработке изображений в формате PNG для свойств extPortrait и livePortrait
Исправлена ситуация с ориентацией рамки камеры, когда ориентация была ограничена, но пользователь использовал ориентацию, отсутствующую в списке.
Повышена общая стабильность.

Hybrid

Добавлена функция перехвата HTTP-запросов для онлайн-обработки.
Исправлена ситуация, когда класс RNRegulaDocumentReaderModule не был отмечен как абстрактный и не реализовывал абстрактный метод в React Native.
Исправлена ситуация с получением разрешения на использование Bluetooth для Android в React Native и Cordova для устройств Regula 7310 и 1120.

COM API

Добавлено новое свойство RFIDLoadCRLFromRemote для включения/отключения загрузки CRLs во время выполнения на основе сертификата документа DS (чтение/запись, тип boolean). По умолчанию отключено.

Web Component

Добавлена возможность настройки задержки перед началом и после окончания анимации для многостраничных документов.
Добавлена возможность ограничить максимальный размер файла при загрузке – свойство maxImageSize.
Добавлена возможность ограничить максимальное разрешение файла при загрузке – свойство maxResolutionSize.
Добавлена поддержка армянского и кыргызского языков.
Изменено поведение свойства statusPositionMultiplier – теперь позиция статуса регулируется в пределах области камеры, а не рамки.
Добавлены новые свойства:
- strictImageQuality
- doDetectCan
- generateDoublePageSpreadImage
- mrzDetectMode
- strictBarcodeDigitalSignatureCheck
- selectLongestNames
Исправлена ситуация с бесконечной повторной обработкой бэкэнда по тайм-ауту — теперь обработка завершается, если включено свойство finalizeOnTimeout или вызван метод finalize.
Исправлена ситуация с переключением камер в Camera Snapshot.
Исправлена ситуация с кнопкой "Capture" в языках с написанием справа налево (RTL).
Исправлена ситуация с изменением местоположения в режиме iframe.

UI Components

Добавлен демо-проект на GitHub с примером использования пакета ui-components с Angular.
Автоматическое переключение изображений документа при раскрытии результатов по страницам во вкладках «Проверка безопасности», «Качество изображения», «Тип документа».
Автоматическая прокрутка в конец таблицы при её разворачивании.
Перфорированный текст, полученный путём прокалывания бланка документа, теперь отображается в таблице текстовых результатов (если имеется).
Добавлено отображение группы данных текстового поля, если в RFID-чипе содержится более двух групп одного и того же поля.

Web Service API

Исправлена ситуация, при которой эндпоинты /api/healthz и /api/readyz отвечали слишком долго при активной обработке или проблемах с сетью при соединении с сервисом лицензирования. Теперь ответ происходит мгновенно.
Автоматическая очистка данных Server-Side Verification. Подробности – в статье Cleaning Up Data.
Исправлена ситуация с миграциями баз данных. Проблема воспроизводилась на MariaDB, MS SQL, Oracle и была связана с использованием столбца instance_id без указания длины ключа.
Исправлена ситуация с удалением данных транзакции по тегу при использовании хранилища типа File System.
Временные папки, создаваемые после обновления SDK, теперь будут удаляться.
Добавлена возможность сохранять настройки приложения при обновлении SDK в Windows.
Обновлены зависимости пакетов до последних версий для устранения уязвимостей.
Клиенты:
- Добавлено свойство doBarcodes, позволяющее ограничить типы штрихкодов для обработки.
- Обновлены структуры данных результата подлинности для клиента на C#.
- Добавлен метод livenessChecks для получения результатов живости документа для клиента на JS.
Demo Website:
- Добавлены новые настройки из SDK.
- В список добавлены сценарии, которые есть в SDK, но не лицензируются.
- Список доступных сценариев для Web Component теперь формируется динамически – в зависимости от возможностей лицензии.

Licensing

Добавлен механизм предотвращения перегрузки лицензионного сервиса запросами от большого числа устройств одновременно. Это может возникать при неправильной интеграции SDK в мобильных приложениях с широкой аудиторией.

Installation Packages

Новая версия драйвера 10.5.10.23 включена в пакет Regula Reader Drivers версии 1.8.28

PKD

Включён ICAO PKD master list версии 307.

Database

Обновлены многочисленные шаблоны документов для включения актуальной информации по OVI, MLI, контактным чипам, голограммам, расширенной MRZ, расширенной OCR, типе вставки фотографии, проверке шаблонов (patterns check), где это уместно.
Включает 251 страну и территорию, 15 117 документов.
Добавлено 432 новых документа.

Подробности см. в Списке поддерживаемых документов.