Document Reader SDK 8.1

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

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

Данный релиз — мажорный. Он содержит существенные изменения, затрагивающие все модули и компоненты. Обратная совместимость не гарантирована. Для переноса вашей существующей конфигурации Document Reader SDK с предыдущей версии воспользуйтесь руководством по миграции для соответствующего компонента.

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

Важные изменения

Произведён редизайн экрана камеры в Mobile SDK с целью улучшения пользовательского опыта. Предыдущий графический интерфейс также остаётся доступным; но все последующие функции будут поддерживаться только новым UI. Подробности см. в разделе кастомизации мобильного UI.
Добавлен новый Core тип — RFID, для чтения только RFID чипов без оптической обработки документа.
Добавлена возможность запуска обработки RFID чипа при наличии только требуемых полей MRZ, таких как номер документа, дата рождения и дата истечения срока действия — вместо полной строки MRZ. Это позволяет инициировать чтение чипа без сканирования MRZ в случае, если необходимые данные уже доступны до начала процесса. Функционал может быть полезен для аутентификации пользователя по документам, которые предположительно в наличии. Подробности доступны на странице конфигурации обработки RFID чипа.
Добавлена возможность запуска обработки RFID чипа при наличии данных MRZ, хешированных SHA-1. Подробности доступны на странице конфигурации обработки RFID чипа.
Добавлена проверка живости документа на его геометрию, определяющая различия в перспективе при захвате документа. Подробности см. в соответствущих разделах конфигурации Web Service и Mobile SDK.
Обновлены многие нейросетевые модели для проверок подлинности.

Core SDK

OCR
- Обновлены имеющиеся и добавлены новые шрифты для чтения перфорированных полей документов многих стран.
Машиносчитываемая зона (MRZ)
- Обновлены парсеры:
  - Albania Residence Permit
  - Bahrain ID Card
  - Brazil ID Card
  - Costa Rica Passport
  - Iceland Residence Permit
  - Moldova ID Card
  - PAM Laissez Passer
- Исправлена ситуация с ошибочным статусом валидности, возвращаемым для строк MRZ, у которых отсутствовала заключительная цифра.
Штрихкоды
- Добавлены новые парсеры:
  - Azerbaijan DL
  - Burkina Faso Consular ID Card
  - Colombia Armed Forces ID Card
  - Colombia Police Card
  - Georgia Seaman's Identity Document
  - Guinea Consular ID Card
  - Guinea Voter Card
  - Honduras Consular ID Card
  - India ID Card
  - India Registration Certificates
  - Kosovo DL
  - Lesotho ID Card
  - Madagascar Registration Certificate
  - Mexico Guerrero DL
  - Mexico Visa
  - Namibia Voter Card
  - Pakistan DL
  - Saint Vincent and the Grenadines ID Card
  - Viet Nam eVisa
  - Western Sahara ID Card
- Обновлены парсеры:
  - Argentina ID Card
  - Cameroon ID Card
  - Chile ID Card
  - Colombia Residence Permit
  - Ghana Visa
  - India PVC ID Card
  - Mexico DL
  - Mozambique DL
  - Myanmar D
  - Philippines Digital ID Card
  - Russia ID Card
  - USA DL
- Добавлена проверка цифровой подписи для Philippines Digital ID Card. Детали доступны в нашей статье блога.
- Исправлена ситуация с декодированием штрихкодов формата PDF417 c 8-м уровнем коррекции ошибок.
- Исправлена ситуация со стабильностью распознавания штрихкода формата Code 128.
Парсинг и проверка текстовых данных
- Добавлена транслитерация значений полей с японского языка на латиницу.
- Добавлены правила валидации текстового поля дискриминатора документа для США.
- Добавлена возможность генерации Alpha-2 гражданства и государства-эмитента (processParam.generateAlpha2Codes).
- Добавлена логика детекции образцов для случаев, когда конкретный тип документа неизвестен.
- Расширена логика детекции образцов документов.
- Исправлена ситуация с разделением категорий водительских прав на отдельные текстовые поля, которые не содержат записей.
- Исправлена ситуация, при которой свойство processParam.selectLongestNames не приоритезировало значения, содержащие дефис, в качестве наиболее длинных.
- Исправлена ситуация с транслитерацией текстового поля документа выдающего органа.
- Исправлена ситуация с валидацией текстового поля даты окончания срока страхования.
- Исправлена ситуация с валидностью сгенерированного текстового поля. Теперь статус валидности будет таким же, как и для оригинального текстового поля.
- Исправлена ситуация с сопоставлением полей даты истечения срока действия и даты выдачи для non-ICAO Mexico Resident Permits, где дата выдачи могла присутствовать на месте даты истечения срока действия.
- Исправлена ситуация со сравнением числовых значений в штрихкодах и текстовых значениях в визуальной зоне для одинаковых полей во всех сценариях.
- Исправлена ситуация с нестрогим сравнением данных между RIFD и визуальной зоной для полей DG1.
- Исправлена ситуация с некорректным парсингом дат формата ММ/ГГ в категориях водительских прав.
- Исправлена ситуация с неверным сравнением дат в разрешениях на обучение вождению, где дата истечения срока действия не совпадает с днём рождения.
- Обновлён парсинг значений DG11/DG12 в корректные типы полей и LCID для документов из разных стран.
Проверки подлинности
- Добавлена проверка живости документа на его геометрию, которая определяет изменения в перспективе при захвате документа (processParam.authParams.livenessParams.checkGeometry).
- Уточнены нейросетевые модели для проверок повторного воспроизведения данных с устройства.
- Уточнены нейросетевые модели для проверок на замену фотографии.
- Уточнены нейросетевые модели для проверок чёрно-белых копий.
- Уточнены нейросетевые модели для проверок окклюзии документа.
- Уточнены нейросетевые модели для проверок детекции голограмм.
- Исправлена ситуация с позитивным результатом детекции голограммы в случае завершения обработки по таймауту.
- Исправлена ситуация с отсутствием результата проверки защитного текста при последовательной обработке.
- Исправлена ситуация с отсутствием результата проверки MLI после повторной обработки данных на стороне сервера.
Image QA
- Произведён рефакторинг кода для минимизации использования памяти.
Перечисления
- Добавлены новые члены перечисления eVisualFieldType:
  - ft_MVC_Agency
  - ft_Issuing_State_Code_Alpha2
  - ft_Nationality_Code_Alpha2
- Добавлен новый член перечисления eRPRM_SecurityFeatureType:
  - SecurityFeatureType_Liveness_GeometryCheck
Прочее
- Добавлен новый сценарий — RFID, позволяющий обрабатывать отдельно данные RFID чипа без изображений в запросе.
- Добавлена возможность повторной обработки пакета на стороне веб-сервиса с большей гибкостью: если обработка RFID чипа состоялась на стороне мобильного устройства и пакет включает данные RFID, повторная обработка на стороне веб-сервиса может осуществляться как с переобработкой данных RFID, так и без неё. Используйте настройку processParam.reprocessRfidSession при повторной обработке на стороне веб-сервиса. По умолчанию включено.
- Добавлена возможность ограничения количества страниц для обработки из PDF файла — используйте настройку processParam.pdfPagesLimit
- Добавлен лимит памяти для логов в размере 128 Мб с целью уменьшения потребления памяти.
- Изменён символ перехода на новую строку с ^ на \n в результатах JSON.
- Исправлена ситуация с нерабочими кодами paIgnoreNotificationCodes при передаче через файл config.yaml
- Оптимизация использования памяти.

Core RFID SDK

Добавлена возможность запуска обработки RFID чипа при наличии только требуемых полей MRZ, таких как номер документа, дата рождения и дата истечения срока действия — вместо полной строки MRZ.
Добавлена возможность запуска обработки RFID чипа при наличии данных MRZ, хешированных SHA-1.
В результаты обработки добавлено поле FacialBDBList для хранения биометрических графических данных лиц для нескольких записей.
Исправлена ситуация, при которой скорость чтения не менялась при наличии документа в устройстве.
Исправлена ситуация со сравнением кодов эмитента сертификата и кода страны, воздействовавшая на статус пассивной аутентификации (если коды отличаются).
Перечисления:
- Добавлены новые члены перечисления eLDS_ParsingNotificationCodes:
  - ntfLDS_ICAO_Certificate_Issuer_CountryNonUpperCase
  - ntfLDS_ICAO_Certificate_Subject_CountryNonUpperCase

Desktop API

Добавлена возможность передавать Alpha-2 коды гражданства и выдающего органа в Opera PMS при работе с Local Service SDK. Для этого включите processParam.generateAlpha2Codes параметр в CustomConfig.
Исправлена ситуация с возвратом значения метода _CheckResult() — если запрошенные данные существуют, возвращать указатель на контейнер с данными соответствующего типа, в противном случае — NULL.

Hardware Support

Обновлена интеграция RealPass SDK до версии 3.2.2.357 для работы с устройствами Xperix.
Изменено поведение по умолчанию для threadMode: теперь этот режим по умолчанию отключён.
Исправлена ситуация с калибровкой устройства 7028М-13.

Mobile API

Представлен новый пользовательский интерфейс камеры в Mobile SDK для улучшения пользовательского опыта. Предыдущий интерфейс остаётся доступным; однако все будущие функции будут поддерживаться только в новом интерфейсе камеры.
Метод showScanner() в DocumentReader объявлен устаревшим. Его всё ещё можно использовать для запуска сканирования в старом интерфейсе. Для запуска сканирования в новом интерфейсе используйте startScanner().
Свойство setShowChangeFrameButton() объявлено устаревшим.
Следующие свойства устарели и не используются в новом интерфейсе камеры: resultStatus, showResultStatusMessages, resultStatusTextFont, resultStatusTextColor, resultStatusBackgroundColor, resultStatusPositionMultiplier, showChangeFrameButton.
Добавлена возможность начинать обработку RFID-чипа, используя только обязательные поля MRZ — номер документа, дату рождения и дату окончания срока действия — вместо всей строки MRZ.
Добавлена возможность начинать обработку RFID-чипа по SHA-1 хешу MRZ-данных.
Добавлен новый тип Core: RFID — только для обработки RFID-чипа.
Добавлен новый сценарий: RFID — только для обработки RFID-данных (без изображений во входных данных).
Добавлены настройки положения индикатора активности с помощью параметров activityIndicatorPortraitPositionMultiplier и activityIndicatorLandscapePositionMultiplier.
Добавлены параметры кастомизации кнопки Skip в многостраничной обработке: текст, шрифт, размер текста и цвет.
Свойство readingBuffer теперь принимает значения из перечисления RFIDReadingBufferSize вместо произвольных целых чисел.
Изменён символ новой строки в текстовых результатах: с ^ на \n.
Обновлена обработка ошибок RFID для перезапуска обработки чипа.
Android
- Исправлена ситуация с отображением кнопок на панели инструментов на устройствах с закруглёнными углами.
- Исправлено центрирование рамки камеры после переключения камеры.
iOS
- Метод prepareCameraViewController() в RGLDocReader объявлен устаревшим. Его всё ещё можно использовать для получения контроллера со старым интерфейсом. Используйте prepareCameraViewControllerForStart() для получения контроллера с новым интерфейсом.
- Добавлена возможность задавать processParams, функциональность и параметры кастомизации через JSON.
- Значение по умолчанию для backgroundMaskAlpha в RGLCustomization изменено на 1.0
- Тип свойства cameraViewController в RGLFunctionality изменён с RGLDocumentReaderCameraViewController на RGLDocumentReaderBaseCameraViewController.
- Исправлена ситуация с некорректным размером анимации RFID в альбомной ориентации.
- Исправлена ситуация с некорректным парсингом значения DTC DG17.
- Исправлена ситуация с неправильным изображением анимации RFID.
Hybrid
- Flutter: Исправлена ситуация с совместимостью с JDK 11.
- Flutter: Исправлена ситуация с требованием разрешения Bluetooth для iOS.

COM API

Добавлено свойство RFIDAfterOptical (логическое, чтение/запись) для запуска обработки RFID-чипа после завершения оптической обработки. Требует включения SeparateOpticalReading.
Добавлено свойство RFIDDelay (целое, чтение/запись) для настройки задержки перед запуском обработки RFID.
Добавлено свойство OpticalDelay (целое, чтение/запись) для настройки задержки перед началом оптической обработки.

Document Reader Application

Добавлены новые скорости передачи данных для обработки RFID-чипа, доступные на устройствах с прошивкой версии 3х.хх: 1695 kbps, 3390 kbps, 6780 kbps
Исправлена ситуация с уведомлениями об обновлениях.
Исправлена ситуация с нумерацией страниц в PDF-отчётах.

Web Components

Добавлена кастомизация фоновой области за пределами рамки камеры через CSS parts.
Добавлена настройка положения индикатора активности через параметры activityIndicatorPortraitPositionMultiplier и activityIndicatorLandscapePositionMultiplier.
Добавлена возможность кастомизации изображений интерфейса.
Исправлена ситуация центрирования рамки камеры при отключённых кнопках.
Исправлена ситуация позиционирования рамки камеры, перекрывающей кнопку захвата.
Исправлены ситуации, из-за которых следующие свойства были недоступны в TypeScript:
- angleThreshold
- focusCheck
- documentPositionIndent
- brightnessThreshold
Исправлены ошибки типизации.
Удалены следующие настройки: flipFrontIcon, flipBackIcon.
Удалены следующие CSS parts: hint-next-page-front-img, hint-next-page-back-img.
Удалены следующие неиспользуемые метки: preparingService, documentProcessing, flipDocument.
Удалены следующие устаревшие элементы:
- метод prepare и поле prepareListener в DocumentReaderService
- атрибут license
- настройки devLicense, regulaLogo
- настройка processParams.respectImageQuality
- настройки statusBackgroundColor, statusTextColor, backgroundMaskAlpha
Отключён режим видео "Картинка в картинке".

UI Components

Добавлена опция отключения открытия изображений в модальном окне по нажатию (imageViewer).
Добавлена опция отключения автоматической прокрутки к результатам (scrollToResult).
Добавлена возможность кастомизации начальной страницы и светлого изображения в компоненте DocumentImages.
Добавлена возможность кастомизации начальной вкладки, позиции прокрутки и раскрытия полей данных в компоненте DocumentTabs.
Исправлена ситуация позиционирования результатов по ширине на мобильных устройствах.

Web Service API

Добавлена метрика Prometheus core_request_queue_time_histogram для отслеживания времени нахождения запроса в очереди Core.
Изменена строка подключения к Oracle DB с oracle+cx_oracle на oracle+oracledb
Python обновлён до версии 3.11
Обновлены зависимости до последних версий для устранения уязвимостей.
Исправлена ситуация с подключением к MongoDB Atlas.

Clients

Обновлены все модели для соответствия структуре "raw response".
Добавлена возможность передавать заголовки в запросах в Java Client.
Добавлен метод Health(), вызывающий эндпоинт /api/healthz для проверки состояния сервиса.
Добавлены параметры tenant, env, tag в эндпоинт /api/v2/transaction/process
Исправлена ситуация выхода за пределы диапазона int в Java Client.
Исправлена ситуация отсутствия raw response в .ProcessAsync()

Demo Website

Исправлена ситуация с автопрокруткой после обновления страницы и обработки документа.
Оптимизировано использование памяти.
Обновлены зависимости до последних версий для устранения уязвимостей.

Licensing

Обновлено лицензирование для поддержки обработки только RFID.

Installation Packages

Windows
- В состав пакета Regula Reader Drivers версии 1.8.29 включён драйвер версии 10.5.10.24

PKD

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

Database

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

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