Document Reader SDK 7.3

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

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

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

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

Улучшена проверка манипуляций с фотографиями.
Новый демо-сайт с расширенными возможностями ввода и анализа результатов.
Внедрена поддержка проверки элемента JURA eIPI.

Core SDK

OCR
- Улучшена точность OCR для западноевропейских языков, кхмерской лингвистической группы и иврита.
- Улучшено поведение параметра processParam.lcidFilter. Если установлен, будут предоставлены только поля с lcid, указанными в фильтре, плюс латиница.
- Исправлена ситуация с OCR перфорации в некоторых документах.
- Исправлена ситуация с расчётом допустимости полей на основе маски с множественными пробелами в значении.
- Исправлена ситуация с некорректной обработкой значений дат RTL в масках при преобразовании в арабские цифры.
Машиносчитываемая зона (MRZ)
- Добавлены новые парсеры:
  - Andorra Passport,
  - CAR ID Card,
  - Cuba Passport,
  - Kyrgyzstan ID Card,
  - Malta ID Card,
  - Uganda ID Card,
  - Ukraine ID Card,
  - Ukraine Passport,
  - South Sudan Passport,
  - Swaziland Passport,
  - Sweden Passport.
- Обновлены парсеры:
  - Множество документов из различных стран и территорий по возможным кодам документов и значениям опциональных данных.
Штрихкоды
- Добавлены новые парсеры:
  - Central African Republic ID Card,
  - Guinea-Bissau Voter Card,
  - Libya Visa,
  - Saudi Arabia Digital Resident Card,
  - US Geneva Conventions Forces ID,
  - Zimbabwe DL.
- Обновлены парсеры:
  - Albania DL,
  - Guatemala Passport,
  - Honduras DL,
  - Paraguay ID Card.
- Исправлена ситуация с положением штрихкода в результатах, если выходное изображение было повернуто на угол, указанный в шаблоне.
Парсинг и проверка текстовых данных
- Добавлено создание числовых полей ft_Issuing_State_Code_Numeric и ft_Nationality_Code_Numeric в соответствии с ISO 3166 на основе ft_Issuing_State_Code и ft_Nationality_Code соответственно. Эти поля будут создаваться, если параметр processParam.generateNumericCodes установлен в true.
- Добавлена транслитерация Ö и Ü для румынских документов в VIZ.
- Добавлена возможность создания составных полей на основе правил, установленных в шаблоне документа. Например, полный адрес может быть сгенерирован из нескольких отдельных полей. Применимо не ко всем типам документов.
- Добавлена возможность проверки устаревших кодов стран в полях Place of birth. Это означает, что некоторые коды стран больше не являются действительными, так как такие страны больше не существуют, но могут присутствовать в поле Place of birth. В то же время такие коды не допускаются в кодах страны выдачи или гражданства.
- Добавлено исключение для дат в Romania ID cards, основанное на разъяснениях MOI.
- Добавлен дополнительный код для Центральноафриканской Республики. Теперь у нее есть коды CAF и CAR.
- Исправлена ситуация с отрицательными значениями параметра shiftExpiryDate, приводящая к некорректным результатам.
- Исправлена ситуация со сравнением кодов ограничений между штрихкодом и визуальной зоной в водительских удостоверениях США (некоторые штаты).
- Исправлена ситуация с некорректной транслитерацией китайского языка в латиницу в некоторых случаях.
- Исправлена ситуация с созданием кода страны выдачи для стран с несколькими кодами, что приводило к некорректному перекрестному сравнению.
- Исправлена ситуация при проверке, что Дата выдачи находится в диапазоне действия сертификата DS, а не в диапазоне использования приватного ключа DS.
- Обновлен парсинг значений полей DG11/DG12 в правильные типы полей и LCID для документов из различных стран.
- Обновлен список образцов документов.
Проверка подлинности
- Значительно улучшено обнаружение манипуляций с портретом документа путем реализации новых подходов для проверки безопасности PhotoEmbeddingType.
- Добавлена поддержка проверки безопасности JURA Encrypted IPI. Идея этой проверки заключается в том, что личные данные кодируются в портретном изображении не визуально, как в IPI, а цифровым способом, в виде кода. При декодировании он должен содержать определенное текстовое значение, составленное из данных документа, и проверка подтверждает их соответствие.
- Реализован параметр processParam.authOneThreadProcessing для улучшения скорости обработки на устройствах с низкой производительностью.
- Улучшена проверка изображения для элементов OVI – теперь проверка выполняется на одном видимом изображении для проверки, в том числе хотя бы формы и цвета элемента.
- Исправлена ситуация с результатами проверки сравнения портретов в случае любых ошибок на сервере.
- Исправлена ситуация с производительностью проверки безопасности IR B900.
- Исправлена ситуация с отображением эталонного изображения в результате проверки безопасности, даже если проверка не была завершена, но была начата.
Контроль качества изображения
- Исправлена ситуация с проверкой бликов, влияющей на допустимость OCR, когда документ был отсканирован с поворотом на 180 градусов.
Перечисления
- Добавлены новые члены перечисления eVisualFieldType:
  - ft_UniqueCertificateIdentifier
  - ft_Email
  - ft_Date_of_SpecimenCollection
  - ft_TypeOfTesting
  - ft_ResultOfTesting
  - ft_MethodOfTesting
  - ft_Digital_Travel_Authorization_Number
  - ft_Date_of_First_Positive_Test_Result
- Добавлены новые члены перечисления eCheckDiagnose:
  - chd_EncryptedIPI_NotFound
  - chd_EncryptedIPI_DataDontMatch
  - chd_IncorrectObjectColor
- Добавлены новые члены перечисления eRPRM_DeviceType:
  - RPRM_DeviceType_M600
- Добавлены новые члены перечисления eRPRM_Authenticity:
  - RPRM_Authenticity_EncryptedIPI.
- Переименован член перечисления eRPRM_DeviceAdditionalFeatures с RPRM_DeviceAdditionalFeature_RESERVED на RPRM_DeviceAdditionalFeature_FactoryCalibrated.
- Добавлен новый член перечисления eRPRM_ResultType:
  - RPRM_ResultType_BarcodePosition
Прочее
- Реализована возможность добавления контейнеров результатов в пакет для повторной обработки на клиенте не только путем сканирования, но и вручную.
- Реализована возможность предоставления координат кадра захвата для каждой страницы при формировании пакета для повторной обработки на сервере на мобильных устройствах.
- Реализован правильный порядок портретов в результатах сравнения в соответствии с названиями элементов.
- Реализована правильная вероятность для полей RFID и штрихкодов, правильный индекс страницы для полей RFID, правильное положение для полей штрихкодов в текстовых результатах.
- Исправлена ситуация со статусом безопасности, когда тип документа не распознан, но сравнение лиц было выполнено.
- Исправлена ситуация с параметрами faceApi по умолчанию при включенном параметре processParam.useFaceApi, что приводило к некорректному поведению, если не все они были установлены одновременно.
- Исправлена ситуация с отсутствием начального transactionID при повторной обработке пакета транзакции, собранного клиентом, для повторной обработки на сервере, что приводило к дополнительным подсчитанным транзакциям.
- Исправлена ситуация с некорректным поведением лицензирования при включении различной лицензии в запрос на сервис, который уже имеет инициализированную лицензию с различными возможностями.
- Исправлена ситуация с невозможностью отправки пакета транзакции на сервер для повторной обработки более одного раза (оптические и затем накопленные данные RFID).
- Исправлена ситуация при работе с изображениями JPEG в цветовом пространстве JCS_YCbCr.
- Исправлена ситуация с именем графического поля контактного чипа в выходном контейнере изображений.
- Исправлены позиции страниц в выходном контейнере изображений. Теперь всегда сначала идет белое (видимое) изображение, затем ИК, затем УФ.
- Исправлена ситуация с корреляцией значений processParam.authParams.checkLiveness и processParam.authParams.livenessParams. Если все параметры livenessParams отключены, то checkLiveness также будет отключен.
- Исправлена ситуация с некорректной анимацией, предоставляемой при сканировании обратной стороны удостоверения личности в сценарии BarcodeAndLocate.
- Исправлена логика поворота выходного изображения с несколькими сигналами: по портрету, по MRZ, по данным шаблона типа документа.
- Исправлена утечка памяти на платформе iOS.
- Исправлена ситуация с сохранением логов на платформах POSIX.
- Исправлена ситуация с экспортом символов TinyXML2 на платформах POSIX.
- Исправлена ситуация с экспортом пустых результатов в формат XML.
- Исправлены различные ситуации в логировании.

Desktop API

Реализована возможность использовать видеодетекцию при подключении устройств 70xx одновременно с устройством 72xx.
Улучшено время сканирования для устройств 70xx при включенной видеодетекции.
Исправлена ситуация с отключением устройства от USB и последующим подключением без перезагрузки библиотеки, что приводило к отсутствию уведомлений после повторного подключения.
Исправлена ситуация со значениями параметров, предоставляемыми через файл RegulaReader.json в папке SDK и через команду RPRM_Command_Set_ProcessParametersJson. Если установлено в файле, они будут применены, даже если они отсутствуют в командном вызове.
Исправлена ситуация с поворотом выходного изображения по портрету.
Исправлена ситуация с непредоставлением результатов MRZ во время сканирования по уведомлению, когда они уже доступны в некоторых случаях.
Исправлена ситуация с некорректной обрезкой штампов в некоторых документах в соответствующем режиме.
Исправлено поведение при вызове команды RPRM_Command_Process_Cancel, когда затем возвращались некорректные результаты.

Hardware Support

Улучшен процесс калибровки для получения изображений более высокого качества.
Обновлена библиотека-адаптер для устройства eSeek M600.
Обновлена библиотека-адаптер для устройств Desko. Теперь нативные результаты считывания штрихкода доступны в режиме видеодетекции без необходимости сканирования.

Mobile API

Добавлено свойство mrzDetectMode, которое улучшает распознавание машиносчитываемой зоны (MRZ) в условиях сложного фона с цифровым шумом, например чёрно-белых ксерокопий некоторых документов. Работает только в режиме обработки одного кадра.
Добавлено свойство logLevel, позволяющее настраивать уровень логирования.
К ProcessParams добавлено свойство timeoutLiveness, позволяющее настраивать лимит времени для проверки подлинности на живость документа.
Добавлена возможность запуска серверной сессии при начале обработки RFID чипа.
Добавлена возможность передачи свойств тенанта и инфраструктуры для нужд лицензирования.
Теперь кадр камеры остаётся активным (зелёным) при завершении обработки документа. Ранее он становился неактивным (белым) до момента закрытия элемента камеры.
Обновлены изображения во вспомогательных анимациях для считывания MRZ и штрихкодов.
Исправлена ситуация с загрузкой базы данных до закрытия приложения.
Другие исправление и улучшения.

Android

Добавлена поддержка страниц памяти в 16 Кбайт.
Определённый размер предпросмотра теперь применяется к режиму захвата изображения.
Исправлена ситуация с настройкой цвета при обработке RFID чипа.
Исправлен радиус закругления для кадра камеры.

iOS

Повышена скорость захвата документа при включённом свойстве живости.
Повышена стабильность завершения процесса считывания RFID данных.
Объект RGLBluetooth теперь создаётся только при использовании BTDevice.
Исправлена ситуация с загрузкой базы данных при принудительном завершении приложения.
Исправлена ситуация с переключением камер при заданном коэффициенте масштабирования.
Исправлены утечки памяти.

Hybrid

Разрешения INTERNET и NFC теперь должны быть явно заданы в AndroidManifest при загрузке базы данных с сервера или использовании функционала считывания RFID чипа.
Исправлена ситуация с совместимостью между Face SDK и Document Reader SDK в .NET MAUI.
Исправлена ситуация с неверным значением CFBundleSupportedPlatforms в .NET MAUI DocumentReaderCore.framework.
Исправлена ситуация с работой uiCustomizationLayer на Android в ReactNative.

Document Reader Application

Добавлено отображение результатов новой проверки безопасности eIPI (encrypted IPI).
Реализовано сохранение всех результатов обработки (вместо сохранения только изображений) при нажатии кнопки Сохранить результаты в папку.
Реализован более строгий подход к генерации результатов сравнения с живым портретом. Если включён захват изображения в реальном времени, то результат принимает положительное/отрицательное значение, но не null.
Исправлена ситуация с отображением результатов видимости в ИК спектре для элементов в случаях, когда одновременно включены проверки видимости и наличия цвета.
Обновлён список уведомлений в разделе PASensitiveNotifications файла RegulaReader.ini для соответствия значениям по умолчанию SDK.

COM API

Добавлено свойство LiveCaptureExternalMode для включения/выключения внешенго захвата изображения в реальном времени, когда для этих целей не используется внутренний интерфейс (чтение/запись, boolean). По умолчанию отключено.
Добавлен метод OnLiveCaptureStarted, вызываемый для начала процесса захвата изображения в реальном времени внешним элементом. Вызывается только при включённом режиме LiveCaptureExternalMode и запуске непосредственно процесса захвата изображения.

Web Component

Добавлен новый отдельный UI компонент для отображения результатов обработки. Он используется в обновлённой версии демо-сайта, а также может применяться в качестве независимого компонента.
Обновлены иллюстрации в анимациях обработки многостраничных документов.
Добавлена новый идентификатор ошибки "MISSING_SCENARIO".
Другие исправления и улучшения.

Web Service API

Добавлена поддержка алгоритма шифрования c открытым ключом Ed25519 для соединений с MariaDB.
Добавлено свойство, показывающее тип применяемой лицензии, при доступе к полю лицензии в ответе /api/ping
Добавлены метаданные, такие как IP пользователя и время на сервере, возвращаемые в поле metadata ответа /api/ping
Добавлена возможность настройки формата журналов доступа (access log).
Добавлена возможность получения списка транзакций по тегу.
Добавлена возможность беспарольной аутентификации при доступе к Azure SQL Database.
Добавлено свойство audit в журнал обработки. Оно позволяет реплицировать данные транзакции в отдельную таблицу базы данных. В случае, когда свойство saveResult включено, одновременно запросы и ответы сохраняются, в противном же случае в таблицу заносятся только запросы.
Добавлена возможность передачи свойств тенанта и инфраструктуры для нужд лицензирования.
Добавлена возможность задания одного или более имён сервиса для подключения к базе данных Oracle.
Demo site
- Полный редизайн веб-сайта.
- Добавлена возможность съёмки селфи и сравнения его с портретом с документа или других фотографий.
- Добавлено отображение результатов сравнения портретов.
- Добавлено отображение результатов проверки чипа в случае предоставленной сессии считывания RFID.
- Добавлено отображение всех доступных проверок подлинности документа.
- Обновлён путь расположения лицензии для запуска веб-компонентов.
Обновлены до последней версии межпакетные зависимости с целью исправления возможных уязвимостей безопасности.
Обновлена спецификация Open API на GitHub.
Обновлены клиенты и пакеты.
Другие исправления и улучшения.

Licensing

Добавлена поддержка возможности передачи значений “tenant” и “env” для каждой отдельной транзакции. Эти значения могут быть определены при инициализации экземпляра и передаваться для каждой транзакции автоматически, если существует выделенный экземпляр для отдельных заказчиков или окружений. Или эти значения могут быть определены отдельно для каждой транзакции в случае работы одного экземпляра для разных заказчиков. Эти данные помогают получать представление об использовании специфических тенантов и окружений при использовании их в рамках единой лицензии.
Исправлена ситуация с отображением деталей онлайн-лицензии в приложении Regula Licensing для Windows.
Исправлена ситуация со слишком долгой проверкой лицензии при использовании аппаратных устройств Regula в рамках контейнера POSIX.
Исправлена ситуация с лицензированием SDK для устройств 7310 и 1120.

Installation Packages

Windows
- Теперь пакет обновления базы данных обновляет одновременно установленные Desktop API и Service API (если оба установлены). Это исправляет ситуацию с невозможностью обновления установленного Service API при наличии новой версии базы данных, но отсутствия новой версии пакета Service API (более частые еженедельные обновления БД против редких ежеквартальных обновлений SDK).
Linux
- Добавлены пакеты ARM-архитектуры для драйверов и Desktop SDK.
Docker
- Добавлена поддержка AWS EKS Pod Identity. Это упрощает подписывание запросов API к сервисам AWS (например, хранилищ Amazon S3 для поддержки хранения журналов (Logs storage) или осуществления серверной верификации (Server-Side Verification). Вместо создания и распространения контейнерам данных вашей учётной записи AWS или использования роли экземпляра Amazon EC2, вы теперь можете связать IAM роль с учётной записью Kubernetes и настроить Pods для использования сервисного аккаунта.
- Обновлён до последней версии базовый образ.

PKD

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

Database

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

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