Document Reader SDK 6.8

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

• Установочный .EXE-файл
• Отдельные установочные .MSI-файлы
• Установочный .EXE-файл x64
• Отдельные установочные .MSI-файлы x64

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

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

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

• При работе с изображениями на мобильных/сервисных устройствах введена новая проверка liveness документа.
• К существующей проверке сравнения портретов была добавлена возможность сравнения вторичных/"призрачных" портретов (ghost portraits).
• В проверках безопасности Extended MRZ и Extended OCR реализована новая проверка шрифта OCR-B.
• Проверка технологии портретной печати LASINK была добавлена к проверке типа встраивания фотографий (Photo embedding type).
• Для использования на мобильных ОС реализована поддержка кроссплатформенного фреймворка .NET MAUI.
• Все пользовательские валидации личных номеров и другие проверки подлинности текстовых полей теперь доступны в сценарии "FullAuth" только для мобильного/сервисного использования. Все улучшения, расширения и усовершенствования в этом вопросе потребуют соответствующей лицензии для доступа к этой функциональности.

Core SDK

• Определение типа документа
  • Добавлена поддержка большего количества размеров пользовательских форматов документов.
  • Исправлена cитуация со значением угла поворота в результатах
  • Исправлена cитуация с вращением по MRZ для паспортов США.
• OCR
  • Обновлены нейронные сети для западноевропейских языков с улучшенным качеством распознавания.
  • Исправлена cитуация с валидностью поля, когда параметр processParam.updateOCRValidityByGlare установлен и блик находится только в области поля, а не на тексте.
  • Исправлена cитуация с валидностью, когда processParam.matchTextFieldMask включается и выключается несколько раз для разных запросов.
  • Исправлена cитуация отсутствия результатов OCR при включении параметра processParam.disablePerforationOCR.
• Машиносчитываемая зона (MRZ)
  • Добавлены новые парсеры для документов:
    • Brunei Darussalam ID Card,
    • Cape Verde Passport
    • Chile Emergency Passport
    • Guatemala ID Card
    • Haiti ID Card
    • Lithuania Passport Diplomatic
    • Mauritania ID Card
    • Namibia ID Card
    • Nigeria Passport
    • Northern Cyprus ID Card
    • Panama Passport Diplomatic, Official,
    • Slovenia Passport Travel Document.
  • Обновлены парсеры для документов:
    • Ecuador ID Card,
    • Mozambique ID Card.
  • Также добавлена проверка личных номеров для определенных стран в источнике MRZ.
  • Исправлена cитуация отсутствия установленной валидности для сгенерированного поля, которое было создано из необязательных данных, для которых была установлена валидность.
  • Исправлена cитуация с координатами символов MRZ в результатах, которая влияла на многие другие производные результаты, такие как проверка IR B900, проверка Extended MRZ и другие.
  • Исправлена cитуация с вероятностью распознавания символов, которая была установлена в результатах на 100 для исправленных значений на основе маски (O-0, B-8, 5-S и т.д.). Теперь она остается исходной.
• Штрихкоды
  • Добавлены новые парсеры штрихкодов для документов:
    • Cote d’Ivoire ID Card,
    • Dominican Republic Learner Permit,
    • India Tax Card,
    • Mexico Consular ID Card,
    • Mexico DL 6 different types,
    • Pakistan DL,
    • Panama Residence Permit,
    • Uganda DL,
  • Обновлены парсеры штрихкодов для документов:
    • AAMVA DL/ID Card,
    • Abkhazia Passport,
    • Azerbaijan Passport,
    • Canada Quebec Health Insurance Card,
    • Chad Passport,
    • Cote d’Ivoire DL,
    • France ID Card,
    • Georgia DL,
    • Georgia Registration Certificate,
    • Haiti ID Card,
    • Panama ID Card,
    • VDS EU Visa,
    • Viet Nam ID Card.
  • Исправлена ситуация с обнаружением QR-кодов с большим и маленьким размером элемента.
• Парсинг и проверка текстовых данных
  • Функциональность пользовательской проверки номеров документов, личных номеров и других проверок подлинности теперь доступна в сценарии "FullAuth" только для мобильного/сервисного использования. Для всех улучшений, расширений и усовершенствований в этом вопросе потребуется соответствующая лицензия для доступа к этой функциональности.
  Добавлена проверка формата личного номера, парсинг и проверка контрольных цифр, где это применимо для некоторых стран.
• Добавлена возможность сравнения отдельного значения года из одного поля с полной датой из разных полей документа.
• Добавлена возможность проверки инициалов полного имени с отдельным полем инициалов.
• Исправлена ситуация с преобразованием года рождения из формата YY в YYYY для лиц, родившихся в начале 20 века.
• Исправлена ситуация с обработкой даты истечения года в MRZ как 2001 вместо 2101.
• Исправлена ситуация, при которой processParam.minimalHolderAge вмешивался в значение поля Years since issue field.
• Исправлены ситуации с переводом Ü, Ö, Ä на разные языки в документах разных стран.
• Исправлена ситуация с проверкой разницы между DOE и DOB, когда они находятся в разных годах.
• Исправлена ситуация с форматом вводимой даты: если вводимый формат недействителен, то используется значение по умолчанию (настройки локали для Windows, “yyyy-MM-dd” для других платформ).
• Исправлена ситуация с генерацией обоих полей ft_Issuing_State_Code & ft_Issuing_State_Name для распознанных документов, где эти поля явно не присутствуют.
• Исправлена ситуация, при которой не все поля транслитерировались с арабского языка.
• Исправлена ситуация с установкой срока действия водительского удостоверения на основании срока действия одной из водительских категорий.
• Проверка подлинности
  • Добавлена liveness-проверка документа при работе с изображениями на мобильных/сервисных устройствах. Проверка скриншотов теперь выполняется разными методами. Она была перенесена из проверки качества изображения ImageQuality в проверку подлинности Authenticity и в случае неудачи проверка безопасности не будет пройдена. Проверка доступна только в сценарии "FullAuth" и должна быть явно включена путем предоставления значения RPRM_Authenticity_Liveness в параметре запроса processParam.processAuth.
  • Добавлена проверка технологии портретной печати LASINK. Результаты будут доступны в проверке типа вставки фотографии для конкретных шаблонов документов, где применяется эта технология (например, ID-карта Латвии (2021)).
  • Добавлена возможность сравнения вторичных/"призрачных" портретов (ghost portraits) к уже существующей проверке сравнения портретов. Поддерживается по крайней мере 3 различных случая с первичными и вторичными портретами:
    • Видимые на одной странице,
    • На разных страницах (например, на лицевой и оборотной стороне удостоверения),
    • На той же странице, но видимые в разных источниках света (вторичные только в УФ).
    Для этой проверки существуют ограничения, основанные на размере и качестве вторичного портрета. Он должен быть достаточно большим и иметь хорошую контрастность, чтобы его можно было сравнивать. В настоящее время эта проверка работает только для распознанных документов, и в шаблоне необходимо указать, следует ли сравнивать конкретную вторичную фотографию. В настоящее время эта функция включена только в ограниченном количестве шаблонов, но в ближайших обновлениях базы данных документов их станет больше. Обратите внимание, что данная проверка требует наличия соответствующей лицензии для доступа к результатам.
  • Добавлена возможность отключить cравнение лиц для детей. По умолчанию дети младше 13 лет с ожидаемым сроком действия документа 5 лет не будут автоматически сравниваться с лицом во время обработки. Есть возможность настроить эти параметры, предоставив значения параметров “processParam.faceapi.childAgeThreshold” и “processParam.faceapi.childDocValidityYears” в запросе, или указав переменные REGULA_FACEAPI_CHILDAGETHRESHOLD и REGULA_FACEAPI_CHILDDOCVALIDITYYEARS.
  • Добавлена возможность проверки наличия/отсутствия лица при различном освещении.
  • Добавлена возможность указать, что OCR текстовых полей будет выполняться только при определенном освещении для дальнейшей проверки подлинности.
  • Добавлена проверка типа шрифта OCR-B к проверкам Extended MRZ и Extended OCR. Эта проверка выполняется только в случае, если тип документа распознан, а выбранный шаблон содержит конкретную информацию о шрифте для текстовых полей.
  • Добавлена возможность валидации плавающих голограмм в динамических позициях на документе.
  • Исправлена ситуация с отсутствием распознавания лиц у младенцев.
  • Исправлена ситуация с отсутствием обнаружения лица на вторичном/призрачном портрете (ghost portrait), если он слишком мал относительно изображения документа.
  • Исправлена ситуация с порогом проверки свечения всей страницы.
  • Исправлена ситуация со статусом безопасности для неизвестного документа при включенном портретном сравнении. Теперь он будет иметь значение ch_Check_WasNotDone, если все проверки по умолчанию прошли, но будет иметь значение ch_Check_Error, если какая-либо из проверок не прошла.
  • Исправлена ситуация с неправильным статусом безопасности, когда соединение с сервисом Face API было недоступно во время проверки сравнения портретов. Теперь, если соединение отсутствует, проверка завершится неудачей, если она должна быть выполнена.
  • Исправлена ситуация с алгоритмом проверки присутствия голограммы в некоторых случаях.
  • Исправлена ситуация с проверкой IRB900 при съемке с устройства 7310 + 1110.
  • Исправлена ситуация со слишком строгими пороговыми значениями для проверки Extended MRZ.
• Контроль качества изображения
  • Исправлена ситуация с проверкой наличия портрета в различных форматах документов.
  • Исправлена ситуация с выгрузкой всех НС по команде Free.
• Обновленная унифицированная система обнаружения лиц НС теперь используется на всех платформах.
• Добавлен новый сценарий "BarcodeAndLocate" для вырезания документа из изображения и распознавания только данных штрихкода. Доступен на всех платформах.
• Добавлена возможность включить чтение CAN для документов формата ID1 в сценариях без распознавания типа документа, установив параметр processParam.doDetectCan в true.
• Добавлены новые члены перечисления eVisualFieldType:
  • ft_DLClassCode_EB_From
  • ft_DLClassCode_EB_Notes
  • ft_DLClassCode_EB_To
  • ft_DLClassCode_EC_From
  • ft_DLClassCode_EC_Notes
  • ft_DLClassCode_EC_To
  • ft_DLClassCode_EC1_From
  • ft_DLClassCode_EC1_Notes
  • ft_DLClassCode_EC1_To
  • ft_Place_of_Birth_City
  • ft_Year_of_Birth
  • ft_Year_of_Expiry
  • ft_GrandfatherName_Maternal
• Добавлены новые члены перечисления eCheckDiagnose:
  • chd_MrzQuality_WrongFontType
  • chd_LasInk_InvalidLinesFrequency
  • chd_DocLiveness_ElectronicDeviceDetected
• Добавлен новый член перечисления eRPRM_SecurityFeatureType:
  • SecurityFeatureType_LasInk
• Добавлена возможность включить вызов сопоставления лиц через сервис Face SDK во время обработки каждого запроса, применимого путем установки переменной окружения REGULA_USEFACEAPI в true (или 1). Все параметры подключения и обработки сервиса Face SDK также могут быть заданы через соответствующие переменные окружения. Более подробную информацию см. в документации.
• Исправлена ситуация с возвратом портрета в сценарии "MrzAndLocate" для некоторых документов.
• Исправлена ситуация с чтением MRZ дважды в некоторых случаях.
• Исправлена ситуация с расчетом статуса для устаревших документов.
• Исправлена ситуация с запросом сканирования второй страницы для визовых наклеек.
• Исправлена ситуация с возможной утечкой памяти при сериализации/десериализации RFID-контейнеров.
• Информация о deviceID и deviceType теперь включена в раздел результатов TransactionInfo.
• Все включенные зависимости с открытым исходным кодом обновляются до последних доступных версий.
• Улучшено качество кода, исправлен ряд мелких ошибок.
• Обновлена документация.

Core RFID SDK

• Параметр processParam.rfid.paSensitiveCodesDisable переименован в processParam.rfid.paIgnoreNotificationCodes.
• Удалено ntfLDS_ICAO_SignedData_Version_Incorrect из списка уведомлений, чувствительных к PA, из-за разногласий в RFC 5652 и ICAO 9303 (v3 vs v5).
• Исправлена ситуация с тем, что PA не проходил при повторной обработке ранее сохраненной сессии с включенным на сервере процессом CA.
• Исправлена ситуация, при которой кэшированные данные не сбрасывались при повторной обработке ранее сохраненной сессии.
• Исправлена ситуация с обработкой ранее сохраненной сессии, сделанной на разных платформах (32 и 64 бит).
• Исправлена ситуация с поддержкой PKD MasterList, имеющего тег "pkdMasterListContent".
• Исправлена ситуация с выбором MF в соответствии с ISO 7816 и ICAO 9303, которая приводила к неправильной связи с новым словацким eID.
• Исправлена ситуация с недоступностью библиотеки обработки изображений после освобождения/включения функциональности RFID.
• Улучшено качество кода.
• Обновлена документация.

Desktop API

• Исправлена ситуация со статусом безопасности, когда проверка формата штрихкода включена, но считывание штрихкода не включено. Теперь считывание штрихкода будет автоматически включено, если включена проверка формата штрихкода.

Desktop web service

• Linux
  • Исправлена ситуация с аварийным завершением работы подключенного устройства при внезапном удалении с USB.

Hardware support

• Улучшенный захват УФ-изображений с помощью устройств с факелом 11x0.
• Улучшен процесс работы с Linux udev rules для всех устройств.
• Исправлена ситуация с потоком захвата изображений, которая могла привести к некорректному поведению при выгрузке.
• Исправлена ситуация с загрузкой прошивки в некоторых ОС Linux для устройств Regula после того, как устройство было отключено от сети, а затем снова подключено.
• Исправлена ситуация с калибровкой устройств 72x3.

Mobile API

• Добавлен задний слой для настройки пользовательского интерфейса. Теперь есть возможность добавлять изображения под рамку камеры.
• Добавлен originalPageIndex к графическим результатам. Это индекс, который не изменяется в ответе, то есть соответствует тому значению индекса, которое вы указали в запросе, в отличие от pageIndex, где значения изменяются в зависимости от того, как изображения сортируются после завершения обработки документа.
• Добавлено свойство cameraPreviewBackgroundColor для класса Customization для настройки верхней и нижней рамок предварительного просмотра камеры.
• Добавлена возможность создания кнопок поверх пользовательского интерфейса камеры с помощью свойства customUILayer, представленного в классе Customization.
• Добавлено поле isDeprecated к результатам типа документа, которое показывает, является документ устаревшим или нет.
• Добавлено свойство paIgnoreNotificationCodes. Это список кодов уведомлений, которые будут игнорироваться при расчете результатов пассивной аутентификации (PA).
• Исправлена ситуация с showStatusMessage, состояние которого сохранялось, даже если оно было изменено во время выполнения.
• iOS
  • Добавлена проверка наличия интернет-соединения во время выполнения prepareDatabase / runAutoUpdate. В случае его потери оно может быть обработано в обратном вызове.
  • Добавлена возможность настройки разрешения видеороликов, которые записываются во время обработки документов.
  • Исправлена ситуация с выбором камеры UltraWide на iPhone 12+ Pro/ Pro Max.
• Android
  • Улучшена и оптимизирована обработка потока camera2. Теперь обработка кадров занимает меньше времени.
  • Свойство setOrientation применено для активности RFID. Теперь оно применяется как к действиям камеры, так и к действиям RFID.
  • Добавлена возможность настройки размера индикатора загрузки.
  • Исправлена ситуация с записью видео 4K во время обработки.
• Hybrid
  • Xamarin: добавлена поддержка .NET MAUI.
• Документация и примеры проектов обновлены на GitHub с подробным описанием многих случаев.

Document Reader Application

• Добавлено сохранение дополнительных результатов в XML/JSON, когда включено сохранение результатов:
  • RPRM_ResultType_Status
  • RPRM_ResultType_Text
  • RPRM_ResultType_Images
  • RPRM_ResultType_InputImageQuality
• Исправлена ситуация с правильным выбором устройства Smart Card для чтения RFID для всех устройств сторонних производителей.
• Исправлена ситуация с отображением IPI ROI на изображении при выборе в результатах.
• Обновлен логотип в диалоге "О программе".

Web component

• Добавлена возможность обработки штрихкодов; добавлены следующие сценарии: "Barcode", "MrzOrBarcode", "BarcodeAndLocate".
• Добавлена возможность обработки одного кадра при нажатии кнопки захвата.
• Добавлен метод, позволяющий переключаться между всеми доступными камерами.
• Добавлена поддержка Angular 11.
• Добавлен код ответа Timeout - он будет возвращен, если обработка завершится по таймауту.
• Добавлено свойство returnPackageForReprocess в processParams. Если установить значение true, rawResult будет содержать зашифрованные контейнеры результатов сканирования, которые могут быть использованы для последующей повторной обработки в веб-сервисе.
• Добавлена возможность включения/выключения протоколирования с помощью свойства processParam.log.
• Добавлена возможность показывать/скрывать кнопку "Закрыть".
• Добавлена возможность использования настроек кастомизации как через атрибуты, так и через Getters/Setters.
• Добавлена анимация при сканировании новой страницы в многостраничной обработке.
• Добавлена правильная версия Core в сборке.
• Добавлена возможность задавать атрибут "tag" запроса для указания идентификатора сессии. Это позволяет засчитывать несколько неудачных попыток в рамках одной сессии как одну в службе лицензирования.
• Функциональные кнопки перенесены в макет видео.
• Удален атрибут object-fit.

Web Service API

• Demo site:
  • Добавлена возможность использовать обработку только через веб-компонент. В этом случае вся обработка выполняется внутри браузера и никакие данные не отправляются на сервис обработки. Выбрать сторону обработки можно в пользовательском интерфейсе. Соответственно обновлено количество доступных параметров в настройках.
  • Добавлена возможность настройки параметров качества изображения.
  • Добавлено отображение статусов верификации на основной вкладке результатов.
  • Добавлено отображение результатов проверки подлинности всех типов.
  • Обновлен URL-адрес политики конфиденциальности.
• Добавлена возможность настройки конфигурации запроса путем добавления пользовательских заголовков.
• Спецификация Open API обновлена на GitHub.
• Обновлены клиенты и пакеты.

Licensing

• Добавлена возможность предоставления файла лицензии в переменной окружения REGULA_LICENSE в виде строки в кодировке base64. Это удобно для использования веб-компонента в режиме разработчика без привязки к доменному URL или запуска контейнеров в Kubernetes.
• Исправлена ситуация с повторной обработкой захваченных изображений сеанса и данных чипа на онлайн/оффлайн instance лицензиях.
• Исправлена ситуация с выбором лицензии Basic на одном устройстве, даже если лицензия OCR+AAC доступна на другом устройстве, при одновременной работе устройств 70x3 и 70x4/70x9.
• Исправлена ситуация с выбором лицензии для устройств с несколькими камерами.
• Исправлена ситуация с отображением логотипа на мобильных платформах при использовании устройств 11x0 в качестве лицензии.

Installation packages

• Windows Desktop API
  • Включен пакет драйверов Regula 1.8.23.
  • Версия Regula Quick Support x64 корректно включена для сборки x64.
• Docker
  • Обновление базового образа до последней версии.

PKD

• Включен ICAO PKD master list версии 227.
• Включен ICAO Health master list версии 6.

Database

• Обновлены многочисленные шаблоны документов для включения расширенного MRZ, расширенного OCR, типа вставки фотографий, проверки шаблонов (Extended MRZ, Extended OCR, Photo embedding type, Patterns checks), где это уместно.
• Включено 247 стран и территорий, 12613 документов.
• Добавлено 413 новых документа.
• Подробности см. в Списке поддерживаемых документов.