Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Oz Liveness Web SDK представляет собой модуль съемки и отправки медиаданных на анализы из веб-браузера на клиентском устройстве. Поддерживаются все основные браузеры на большинстве устройств. Доступные языки: EN, RU, ES, PT-BR, KK.
Образец кода Oz Liveness Web SDK находится здесь. Чтобы все работало корректно, нужно заменить <web-adapter-url>
на полученную от нас ссылку на Web Adapter.
Для Angular и React нужно заменить https://web-sdk.sandbox.ozforensics.com
в index.html.
Web SDK работает по протоколу HTTPS; на localhost и 127.0.01 возможна работа по HTTP.
Oz Liveness Web SDK состоит из двух частей:
Клиентская – Oz Liveness Web Plugin. Используется в виде подгружаемого JavaScript-файла в Frontend-приложении клиента.
Серверная – Oz Liveness Web Adapter. Устанавливается в виде отдельного серверного модуля с привязкой к Oz API.
Руководства по интеграции:
Oz Web SDK можно развернуть как на ваших серверах, так и на наших (SaaS), в последнем случае разворачиваем и поддерживаем программное обеспечение мы, а вы пользуетесь уже готовым и настроенным продуктом. Свяжитесь с нами для выбора более удобного варианта.
Для работы Web SDK потребуется информация о доменных именах сайтов, где вы будете его использовать (она необходима для оформления лицензии).
Пошаговая инструкция по использованию Web SDK:
Интегрируйте плагин в свою страницу.
Если вы хотите настроить интерфейс Oz Web SDK под себя, здесь рассказано, как это сделать.
Работа на ваших серверах
Установите Web SDK. Вам помогут наши инженеры. Лицензия также будет установлена в этот момент. Когда вам потребуется ее обновить, воспользуйтесь этой статьей.
Настройте Web Adapter.
SaaS
Ничего делать не нужно, установку и настройку серверной части обеспечивают инженеры Oz Forensics. Вы получите ссылку для интеграции (см. п. 2).
Перед запуском убедитесь, что скрипты плагина загружены.
Для запуска окна плагина следует воспользоваться методом open(options)
. Параметры:
options
– объект с настройками:
token
– (опционально) токен авторизации;
license
– объект с информацией о лицензии;
licenseUrl
– строка, содержащая путь к файлу лицензии;
lang
– строка с идентификатором одного из подключенных языковых пакетов;
meta
– объект, ключи которого являются названиями метаполей, а значения – их строковыми значениями. Метаданные передаются в Oz API и могут быть использованы для получения результатов анализа или поиска;
params
– объект с идентификаторами и значениями дополнительных параметров:
extract_best_shot
: true/false
– запуск выбора лучшего кадра в анализе Quality;
action
– массив строк с идентификаторами действий, по которым будет проводиться проверка.
Доступные действия:
photo_id_front
– фото лицевой стороны документа;
photo_id_back
– фото обратной стороны документа;
video_selfie_left
– поворот головы налево;
video_selfie_right
– поворот головы направо;
video_selfie_down
– наклон головы вниз;
video_selfie_high
– поднятие головы вверх;
video_selfie_smile
– улыбка;
video_selfie_eyes
– моргание;
video_selfie_scan
– сканирование;
video_selfie_blank
– отсутствие действия, простое селфи.
video_selfie_best
– специальное действие, которое извлекает из видео лучший кадр и выполняет анализ по нему вместо целого видео.
overlay_options
– параметры отображения шаблона документа:
show_document_pattern
: true/false
– по умолчанию true
, отображает картинку-шаблон, при значении false
остается только прямоугольная рамка;
on_submit
– callback-функция без аргументов, вызываемая после отправки пользовательских данных на сервер (не применяется в режиме capture
).
on_capture_complete
– callback-функция с одним аргументом, вызываемая по завершении съемки и возвращающая информацию о снятом видео. Пример возвращаемого объекта показан здесь.
on_error
– callback-функция с одним аргументом, вызываемая при ошибке во время съемки и возвращающая информацию об ошибке: код ошибки, сообщение, идентификатор телеметрии для журналирования.
on_close
– callback-функция без аргументов, вызываемая по окончании проверки после закрытия окна плагина, как ручного, так и автоматического.
style
– раздел для настройки интерфейса.
device_id
– (опционально) идентификатор используемой камеры.
cameraFacingMode
(добавлено в 1.4.0) – параметр, определяющий, какую камеру использовать; возможные значения: user
(передняя камера), environment
(задняя камера). Этот параметр работает только в том случае, когда для параметра use_for_liveness
в файле конфигурации Web Adapter не установлено значение. Если use_for_liveness
установлено любое значение, cameraFacingMode
игнорируется.
disable_adaptive_aspect_ratio
(добавлено в 1.5.0) – выключает автоматическую подстройку соотношения сторон видео к соотношению сторон окна. Значение по умолчанию – False
, при стандартных настройках видео подстраивается под ближайшее соотношение из списка: 4:3, 3:4, 16:9, or 9:16. Обратите внимание: для съемки видео на смартфонах нужна портретная ориентация.
get_user_media_timeout
(добавлено в 1.5.0) – когда SDK не может получить доступ к камере, по истечении этого таймаута появится подсказка, как решить проблему. Значение по умолчанию – 40000 (мс).
Пример:
Этот коллбэк вызывается раз в несколько секунд в процессе анализа и возвращает промежуточный результат (не применяется в режиме capture
). Вид результата зависит от параметра настройки Web Adapter result_mode
.
Пожалуйста, обратите внимание: в целях безопасности мы рекомендуем настроить логику принятия решений на стороне вашего бэкенда. Более детальную информацию и примеры кода вы можете найти здесь.
Если result_mode
установлен как safe
, коллбэк on_result
возвращает только состояние анализов:
или
При значении status
коллбэк возвращает состояние анализов, а также – для каждого типа анализа – название типа, состояние анализа этого типа и вердикт системы.
или
При значенииfolder
возвращается практически то же самое, что при status
, только добавляется идентификатор папки.
В случае, когда result_mode
установлен на full
, вернется:
пока анализ выполняется – ответ, аналогичный ответу при значении status
(в процессе обработки), или
полная информация об анализах:
все, что вы могли видеть при значении folder
;
временные метки;
метаданные;
идентификаторы анализов, компании, группы анализов;
пороги;
информация о медиафайлах;
и так далее.
При работе с Web SDK ваше приложение обращается к Web Plugin, который работает в контексте браузера. Плагин обменивается информацией с Web Adapter, а тот, в свою очередь – с Oz API.
Образец кода Oz Liveness Web SDK находится здесь. Чтобы все работало корректно, нужно заменить <web-adapter-url>
на полученную от нас ссылку на Web Adapter.
Для Angular и React нужно заменить https://web-sdk.sandbox.ozforensics.com
в index.html.
Чтобы скрыть окно плагина, не отменяя запросы результатов анализов и пользовательские callback'и, воспользуйтесь методом hide()
. Метод может пригодиться, если, к примеру, после отправки данных требуется вывести собственный индикатор загрузки.
Для принудительного закрытия окна плагина воспользуйтесь методом close()
. При этом все запросы к серверу и callback-функции (кроме on_close) в рамках данной сессии будут остановлены.
Пример использования:
Для подключения плагина на страницу необходимо добавить в html-код страницы ссылку на основной скрипт плагина (plugin_liveness.php
). web-sdk-root-url
– это полученная от нас ссылка на Web Adapter.
При использовании Angular и Vue подключение стилей и скриптов происходит так же. При интеграции с React-приложениями необходимо загружать и инициализировать плагин в head
на главной странице шаблона. Внимание: при использовании <React.StrictMode>
возможна некорректная работа Web Liveness.
В этом разделе вы узнаете, как снимать видео и отправлять его Oz API через ваш бэкенд.
Режим capture работает следующим образом:
1. Oz Web SDK снимает видео и передает его вашему web-приложению в виде последовательности кадров.
2. Web-приложение вызывает ваш бэкэнд и передает в него архив с кадрами.
3. После обработки видео ваш бэкэнд вызывает Oz API для выполнения анализов, после чего получает их результаты.
4. Ваш бэкэнд передает результаты обратно в web-приложение (опционально).
Структура получаемого объекта зависит от того, была ли обнаружена виртуальная камера.
Список переменных с их значениями приведен ниже.
Вы можете получить из папки видео в формате MP4 video: вызовите метод /api/folders/{{folder_id}}
, указав идентификатор папки. В JSON-ответе найдите preview_url
в source_media
. В preview_url
содержится ссылка на видео. Из плагина получить MP4-видео нельзя (только в виде последовательности кадров).
При использовании архитектуры capture
также необходимо добавить в запрос POST {{host}}/api/folders
дополнительное поле additional_info
. Оно нужно для сбора информации о среде клиента. Пример заполнения тела запроса:
Для передачи в Oz API используйте данные без кодирования в base64.
Этот коллбэк вызывается после окончания проверки и возвращает результат анализа (не применяется в режиме capture
). Вид результата зависит от result_mode
.
Пожалуйста, обратите внимание: в целях безопасности мы рекомендуем настроить логику принятия решений на стороне вашего бэкенда. Более детальную информацию и примеры кода вы можете найти .
Если result_mode
установлен как safe
, коллбэкon_complete
возвращает только состояние анализов:
При значении status
коллбэк возвращает состояние анализов, а также – для каждого типа анализа – название типа, состояние анализа этого типа и вердикт системы.
При значенииfolder
возвращается практически то же самое, что при status
, только добавляется идентификатор папки.
В случае, когда result_mode
установлен на full
, вернется полная информация об анализах:
все, что вы могли видеть при значении folder
;
временные метки;
метаданные;
идентификаторы анализов, компании, группы анализов;
пороги;
информация о медиафайлах;
и так далее.
Для настройки интерфейса воспользуйтесь разделом style
в методе Ozliveness.open
. Изменить можно следующие настройки:
faceFrame
– цвет рамки вокруг лица:
faceReady
– цвет рамки при правильном расположении лица;
faceNotReady
– цвет рамки при неправильном положении лица, когда анализ не может быть запущен.
centerHint
– текст подсказки в центре.
textSize
– размер текста;
color
– цвет текста;
yPosition
– позиция по вертикали относительно верха контейнера;
letterSpacing
– расстояние между буквами;
fontStyle
– стиль текста (полужирный, курсив и так далее).
closeButton
– кнопка закрытия плагина:
image
– изображение для кнопки, может быть картинкой в формате PNG или dataURL в base64.
backgroundOutsideFrame
– заливка вне рамки вокруг лица:
color
– цвет заливки.
Пример:
Результаты анализа доступны клиентскому приложению через функции-коллбэки Web Plugin, однако мы рекомендуем получать их через бэкенд напрямую от Oz API и там же обрабатывать впоследствии. Таким образом исключается вероятность манипуляций с результатами анализов через контекст браузера.
Чтобы найти нужную папку со стороны бэкенда, сделайте следующее:
На фронтенде добавьте уникальный идентификатор папки через метаданные:
Вы можете добавить собственные пары ключ-значение для хранения любой текстовой информации, например, номера документа или телефона. Однако удостоверьтесь при этом, что соблюдаются нормы законодательства о защите персональной информации.
Для оповещения о завершении анализа используйте функцию-коллбэк on_result
, затем вызовите бэкенд и передайте значение transaction_id
.
На стороне бэкенда найдите папку по присвоенному ранее идентификатору с помощью метода Folder LIST
:
Для ускорения обработки запроса мы рекомендуем ограничить выдачу по времени:
В ответе придут результаты анализов и идентификатор папки folder_id
- он потребуется для дальнейших действий.
Для настройки интерфейса воспользуйтесь разделом style
в методе Ozliveness.open
. Полный список настроек приведен после примера.
Пример использования:
Основные цветовые настройки.
Основные настройки шрифта.
Настройки шрифта заголовка.
Настройки кнопок.
Настройки панели инструментов.
Настройки подсказки в центре.
Анимация подсказки.
Настройки рамки вокруг лица.
Настройки рамки для съемки документа.
Настройки фона.
Настройки защиты от мошенников: при включении во время записи видео появляется дополнительное сообщение.
Настройки текста версии SDK.
Настройки 3D-маски, добавленной в версии 1.2.1.
Таблица соответствия параметров:
Для добавления нового языкового пакета или модификации существующего следует воспользоваться методом add_lang(lang_id, lang_obj)
.
Параметры:
lang_id
– строковое значение, которое далее можно использовать в качестве параметра lang
метода open()
;
lang_obj
– объект, ключами которого являются идентификаторы строк перевода, а значениями – сами строки перевода.
Список идентификаторов языков:
lang_id | Язык |
---|
*До версии 1.3.1 назывался pt
.
Пример использования:
OzLiveness.add_lang('ru', ruTranslation)
, гдеruTranslation
– объект JSON.
Для установки нужного языка укажите его идентификатор в lang
:
Вы можете запросить, какие языковые пакеты установлены в Web SDK, с помощью метода ozLiveness.get_langs()
. Добавленные вручную локали также отобразятся.
Список всех строковых идентификаторов:
Ключи вида oz_action_*_go
относятся к соответствующим жестам. oz_tutorial_camera_*
– к подсказкам, как включить камеру для различных браузеров. Остальные – к подсказкам для всех жестов, информационным сообщениям или ошибкам.
Если какие-либо из ключей в вашем языковом пакете отсутствуют, соответствующие строки будут отображаться на английском языке.
На стороне сервера необходимо сконфигурировать Web SDK для работы в режиме capture: параметру architecture
в файле app_config.json значение capture
.
В вашем web-приложении добавьте callback-функцию для обработки кадров при открытии Web SDK:
Видео, полученное через Oz Web SDK, – это последовательность кадров. Чтобы отправить его Oz API, поместите кадры в ZIP-архив, затем используйте метод POST {{host}}/api/folders
(пройдите по для ознакомления с коллекцией Postman).
Web Adapter отправляет Web Plugin данные с различным уровнем детализации. Для продакшна рекомендуется установить минимальный уровень. Для этого в Web Adapter установите параметру result_mode
значение "safe".
Переменная | Тип | Описание |
| String | Лучший кадр, JPEG в формате data URL |
| String | Лучший кадр, PNG в формате data URL, необходим для защиты от подмены видеопотока с помощью виртуальной камеры |
| Array[Named_parameter: Int] | Координаты прямоугольника, в который вписано лицо на лучшем кадре |
| Array[Named_parameter: Array[Int, Int]] | Координаты "ориентиров" лица (левый глаз, правый глаз, нос, рот, левое ухо, правое ухо) на лучшем кадре |
| Array[String] | Все кадры в формате data URL |
| Array[Array[Named_parameter: Int]] | Координаты прямоугольников, в которые вписано лицо на кадрах из |
| Array[Named_parameter: Array[Int, Int]] | Координаты "ориентиров" лица (левый глаз, правый глаз, нос, рот, левое ухо, правое ухо) на кадрах из |
| String | Код действия |
| String | Информация о среде клиента |
Параметр | Описание |
textColorPrimary | Основной цвет текста |
backgroundColorPrimary | Основной цвет фона |
textColorSecondary | Дополнительный цвет текста |
backgroundColorSecondary | Дополнительный цвет фона |
iconColor | Цвет значков |
Параметр | Описание |
textFont | Шрифт |
textSize | Размер шрифта |
textWeight | Насыщенность шрифта |
textStyle | Стиль текста |
Параметр | Описание |
textFont | Шрифт |
textSize | Размер шрифта |
textWeight | Насыщенность шрифта |
textStyle | Стиль текста |
Параметр | Описание |
textFont | Шрифт |
textSize | Размер шрифта |
textWeight | Насыщенность шрифта |
textStyle | Стиль текста |
textColorPrimary | Основной цвет текста |
backgroundColorPrimary | Основной цвет фона |
textColorSecondary | Дополнительный цвет текста |
backgroundColorSecondary | Дополнительный цвет фона |
cornerRadius | Угловой радиус кнопки |
Параметр | Описание |
closeButtonIcon | Значок кнопки закрытия |
iconColor | Цвет значка |
Параметр | Описание |
textFont | Шрифт |
textSize | Размер шрифта |
textWeight | Насыщенность шрифта |
textStyle | Стиль текста |
textColor | Цвет текста |
backgroundColor | Цвет фона |
backgroundOpacity | Непрозрачность фона |
backgroundCornerRadius | Угловой радиус подложки |
verticalPosition | Положение по вертикали |
Параметр | Описание |
hideAnimation | Скрыть анимацию |
hintGradientColor | Цвет градиента |
hintGradientOpacity | Непрозрачность градиента |
animationIconSize | Размер значка анимации |
Параметр | Описание |
geometryType | Форма рамки – прямоугольник или овал |
cornersRadius | Угловой радиус прямоугольника |
strokeDefaultColor | Цвет рамки (лицо не в кадре) |
strokeFaceInFrameColor | Цвет рамки (лицо в кадре) |
strokeOpacity | Непрозрачность обводки |
strokeWidth | Толщина линии обводки |
strokePadding | Отступ в рамке |
Параметр | Описание |
cornersRadius | Угловой радиус |
templateColor | Цвет шаблона |
templateOpacity | Непрозрачность шаблона |
Параметр | Описание |
backgroundColor | Цвет фона |
backgroundOpacity | Непрозрачность фона |
Параметр | Описание |
textMessage | Текст сообщения |
textFont | Шрифт |
textSize | Размер шрифта |
textWeight | Насыщенность шрифта |
textStyle | Стиль текста |
textColor | Цвет текста |
textOpacity | Непрозрачность текста |
backgroundColor | Цвет фона |
backgroundOpacity | Непрозрачность фона |
backgroundCornerRadius | Угловой радиус подложки |
flashColor | Цвет мигающего индикатора |
Параметр | Описание |
textFont | Шрифт |
textSize | Размер шрифта |
textWeight | Насыщенность шрифта |
textStyle | Стиль текста |
textColor | Цвет текста |
textOpacity | Непрозрачность текста |
Параметр | Описание |
maskColor | Цвет самой маски |
glowColor | Цвет обводки маски |
minAlpha | Минимальный уровень прозрачности маски (добавлено в 1.3.1) |
maxAlpha | Максимальный уровень прозрачности маски (добавлено в 1.3.1) |
Предыдущий дизайн | Новый дизайн |
doc_color | - |
face_color_success faceFrame.faceReady | faceFrameCustomization.strokeFaceInFrameColor |
face_color_fail faceFrame.faceNotReady | faceFrameCustomization.strokeDefaultColor |
centerHint.textSize | centerHintCustomization.textSize |
centerHint.color | centerHintCustomization.textColor |
centerHint.yPosition | centerHintCustomization.verticalPosition |
centerHint.letterSpacing | - |
centerHint.fontStyle | centerHintCustomization.textStyle |
closeButton.image | - |
backgroundOutsideFrame.color | backgroundCustomization.backgroundColor |
en | Английский |
ru | Русский |
es | Испанский |
pt-br* | Португальский (бразильский) |
kz | Казахский |
Для выпуска лицензии потребуется информация о доменных именах сайтов, где будет использоваться Web SDK. Можно также указывать поддомены.
Чтобы узнать доменный адрес, в режиме разработчика выполните window.origin
на странице, где будет запускаться Web SDK. При использовании Web SDK на localhost / 127.0.0.1 лицензия может работать без информации о доменных именах.
Укажите информацию о лицензии одним из двух способов:
через данные о лицензии:
через путь к лицензии:
Проверьте, как установилась лицензия: например, пройдите по доменному имени хоста и выполните действие Liveness -> Simple selfie.
Далее при каждом запуске Web SDK система будет проверять валидность лицензии.
Журнал изменений Web SDK.
Обновления безопасности.
Исправили ошибку, из-за которой видео могло некорректно создаваться из последовательности кадров.
Коллбэк-функция on_complete
теперь вызывается после изменения общего статуса папки (заявки).
Обновили инструкции по доступу к камере для браузеров Android Chrome и Facebook. Новые ключи:
error_no_camera_access
,
oz_tutorial_camera_android_chrome_with_screens_title
,
oz_tutorial_camera_android_chrome_instruction_screen_click_settings
,
oz_tutorial_camera_android_chrome_instruction_screen_permissions
,
oz_tutorial_camera_android_chrome_instruction_screen_allow_access
,
try_again
,
oz_tutorial_camera_external_browser_button
,
oz_tutorial_camera_external_browser_manual_open_link
,
oz_tutorial_camera_external_browser_title
.
Добавили метод get_langs()
– с его помощью можно узнать, какие языковые пакеты установлены в Web SDK.
Добавили ошибку для ситуации, когда происходит обращение к несуществующему языковому пакету.
Добавили ошибку для ситуации, когда не удалось загрузить необходимые ресурсы. Новый ключ: unable_load_resource.
Обновили тексты ошибок error_connection_lost
и error_service_unavailable
.
Обновили языковые файлы для Web SDK.
Функция обрезки больше не добавляет полосы к кадрам c разрешением менее 512×512.
Если доступ к камере отсутствует в течение длительного времени, пользователям теперь показывается инструкция, как его включить. Для всех браузеров, кроме Facebook, отображается инструкция по умолчанию, для Facebook – отдельная.
Добавили несколько записей в файл локализации Web SDK. Новые ключи локализации:
accessing_camera_switch_to_another_browser
,
error_camera_timeout_instruction
,
error_camera_timeout_title
,
error_camera_timeout_android_facebook_instruction
.
Улучшили работу с картоматами: расстояние, на котором может распознаваться лицо пользователя, увеличено.
Добавили в Web Plugin параметр disable_adaptive_aspect_ratio
. Этот параметр выключает подстройку соотношения сторон видео под окно съемки.
Добавили в Web Plugin параметр get_user_media_timeout
: когда SDK не может получить доступ к камере, по истечении этого таймаута появится подсказка, как решить проблему.
Добавили несколько записей в файл локализации Web SDK. Новые ключи:
oz_tutorial_camera_android_edge_browser
oz_tutorial_camera_android_edge_instruction
oz_tutorial_camera_android_edge_title
error_camera_timeout_instruction
error_camera_timeout_title
Если SDK не может найти перевод для какого-либо из имеющихся ключей, соответствующее сообщение будет показываться на английском.
Бессерверный Web SDK теперь можно распространять через Node Package Manager.
Демонстрацию ошибок API в модальном окне теперь можно отключить. Установите параметру disable_adapter_errors_on_screen
значение True
.
Мобильные браузеры теперь используют основную (заднюю) камеру для съемки документов.
Обновили образцы кода.
Исправили ошибку, когда при повторной попытке пользователя пройти сценарий после неудачи 3D-маска не реагировала на лицо.
Обновления безопасности и журналирования.
Исправили ошибку, из-за которой при съемке лица в горизонтальной ориентации на мобильных устройствах не показывалось предупреждение о необходимости поворота устройства вертикально.
У некоторых пользователей ранее наблюдались зависания при использовании WebView. Теперь в этих случаях пользователь может нажать кнопку, чтобы продолжить работу с приложением. В связи с этим обновили файл со строками в разделе локализации. Ключ: tap_to_continue
.
Расширили возможности отладки.
Крупные обновления безопасности: улучшили защиту от виртуальных камер и модификации JavaScript-кода.
Улучшили поддержку WebView:
Добавили инструкции для неизвестных WebView-браузеров на платформах Android и iOS. Соответствующие события записываются при журналировании.
Улучшили интеграцию с React Native: добавили атрибут webkit-playsinline
, чтобы запуск камеры в полноэкранном режиме для iOS WebView работал корректно.
Ошибка работы с iFrame при параметре iframe_allowed
= False
теперь отображается корректно.
Новые ключи локализации:
oz_tutorial_camera_android_webview_browser
oz_tutorial_camera_android_webview_instruction
oz_tutorial_camera_android_webview_title
Web SDK теперь работает и с черным списком: вы можете сравнить лицо из снятого Liveness-медиафайла с лицами из вашей базы данных. Создайте коллекцию (или коллекции) с нужными фотографиями через API или веб-интерфейс и добавьте соответствующий идентификатор (или идентификаторы) в массив analyses.collection_ids
в файле конфигурации веб-адаптера.
Мы вернули поддержку iframe: установите для параметра iframe_allowed
в файле конфигурации Web Adapter значение True
.
Интервал опроса для получения результатов анализов теперь можно настраивать. При необходимости измените его в параметре results_polling_interval
файла конфигурации Web Adapter.
Теперь вы можете выбрать, какую камеру использовать, переднюю или заднюю, и через веб-плагин. В методе OzLiveness.open()
установите для cameraFacingMode
значение user
для передней камеры и environment
для задней. Этот параметр работает только в том случае, если для параметра use_for_liveness
в файле конфигурации веб-адаптера не установлено значение.
Стили плагина теперь добавляются автоматически. Обратите внимание: удалите стили, которые вы ранее применили к странице клиента вручную (строка <link rel="stylesheet" href="/plugin/ozliveness.css" />
), чтобы избежать конфликтов.
Исправлены некоторые ошибки и улучшено журналирование.
Улучшили защиту против инъекционных атак.
Заменили идентификатор языка для бразильского португальского с pt
на pt-br
согласно стандарту ISO.
Удалили конфигурационный параметр lang_default
.
Прозрачность 3D-маски теперь можно настраивать.
Добавили возможность использования мастер-лицензии, которая работает без ограничений по домену.
Добавили параметр master_license_signature в параметры конфигурации Web Adapter.
Исправили ошибки.
Улучшили работу SDK.
Добавили 3D-маску, которая заменяет овал при съемке видео нашим SDK. Для включения маски установите конфигурационному параметру load_3d_mask
значение true
.
Обновили телеметрию (журналирование).
Обновления журналирования.
Обновления безопасности.
Улучшили работу SDK.
Улучшили работу SDK.
Исправили ошибки.
Изменили сигнатуру коллбэка on_error():
теперь он возвращает не только код ошибки, но и сообщение, а также идентификатор телеметрии для журналирования.
Добавили параметр конфигурации для режима debug. Если он принимает значение True, в Web SDK можно открыть страницу /debug.php, на которой размещена информация о текущих конфигурации и лицензии.
Исправили несколько ошибок и улучшили журналирование.
Добавили возможность выбора камеры при запуске плагина (если на устройстве их несколько).
Полностью переделали дизайн для SDK и демо, в том числе добавили настройки защиты от мошенников: при включении опции во время записи видео появляется дополнительное сообщение. Новые возможности настройки интерфейса описаны здесь.
Перевели SDK на португальский, испанский и казахский языки.
Добавили жест Комбо.
Добавили шкалу прогресса для загрузки медиа.
Жесты Zoom in и Zoom out больше не поддерживаются.
Съемка видео в альбомной ориентации теперь работает корректно для планшетов.
Убрали опцию lang_allow
из файла конфигурации Web Adapter.
В архитектуре capture
при обнаружении виртуальной камеры параметр additional_info
теперь отображается внутри списка from_virtual_camera
.
Добавили возможность обрезать кадр с лицом без потери качества.
Координаты "ориентиров" лица для архитектуры capture теперь передаются корректно.
Улучшили качество съемки;
Значительно переработали лицензирование:
добавили описание ошибок, теперь понятно, что и почему произошло;
теперь можно указывать лицензию в JS в процессе работы;
при применении в OzLiveness.open()
лицензия переписывает предыдущую;
лицензия теперь не требует указания порта и протокола;
в URL лицензии можно указывать поддомены;
информация о лицензии выводится в лог Docker при запуске плагина на сервере;
при использовании на localhost и 127.0.01 лицензия больше не запрашивается;
Коллбэк on_capture_complete
вызывается на всех архитектурах по завершении съемки видео и содержит информацию о жестах на этом видео;
При запуске Oz Web Liveness и Oz Web Adapter их версии теперь выводятся в лог Docker;
Добавили параметры для передачи при съемке информации о прямоугольнике, в который вписано лицо;
Убрали неиспользуемое поле adapter_version из метаданных заявки;
Починили кнопку переключения камер в Google Chrome;
При старте Web SDK в лог Docker выводятся фактические параметры конфигурации.
Изменили расширение некоторых файлов системы Oz Forensics с .bin на .dat.
Ссылки на дополнительные скрипты теперь формируются с использованием адреса основного скрипта.
Добавили возможность распространять Web SDK только статическими файлами, без адаптера (в режиме capture).
Web SDK теперь может работать с CDN.
Теперь можно запускать несколько экземпляров Oz Liveness Web Plugin на разных страницах, в этом случае необходимо указать на этих страницах путь для загрузки скриптов.
При обновлении с 0.4.0 лицензию необходимо также обновить.
Исправили ошибку экрана съемки.
Добавили лицензирование, для получения лицензии необходим origin.
Внешний вид Web SDK теперь можно настраивать.
Исправили ошибки интеграции с Angular.
Исправили ошибку с отсутствием секции IMAGE_FOLDER в JSON-ответе при включенном lossless-кадре.
Исправили ошибки работы с библиотекой ravenjs.
Рамку для фото документов теперь можно настроить.
Повысили безопасность SDK.
Названия всех доступных пользователю камер теперь добавляем в метаинформацию.
В формате видео / режиме zip теперь можно загружать lossless-кадр.
Best Shot теперь работает корректно.
В ответах сервера код ошибки и расшифровка теперь передаются раздельно.
Если режим для SDK настроен в переменных окружения architecture
, api_url
, то он применяется в настройках автоматически.
В режиме lite можно выбрать best frame для любого действия.
В режиме lite фото, отправленное через API, получает статус on_complete
только при успешном liveness.
Можно управлять cors из переменных окружения (по умолчанию заголовки cors не добавляются).
Добавили значение folder
для result_mode
: оно возвращает тот же ответ, что и значение status
, но с folder_id
.
Оптимизировали шифрование: теперь шифруем только метаданные, необходимые для расшифровки объекта.
Оптимизировали отправку данных: теперь изображения отправляются в отдельных полях формы, а не в одном JSON-объекте.
Добавили проверку поддерживаемых параметров камеры.
Включили новый метод шифрования изображений.
Оптимизировали формат отправки изображений.
Добавили опцию use_for_liveness
: при съемке лица на мобильных устройствах выбирается тыловая камера, а на десктопе отключаются флип и обводка овала. По умолчанию опция отключена.
Уменьшили время видео video_selfie_best (жест Selfie) с 1 до 0,2 сек.
Оптимизировали загрузку скриптов – теперь ее можно настраивать.
Повысили точность работы алгоритмов.
Добавили казахский язык.
Добавили инструкцию по доступу к камере для десктопа.
Дополнили журналирование – пишутся запросы к plugin_liveness.php и user-agent в лог сервера.
Добавили возможность работы с режимом Lite.
Добавили шифрование.
Обновили библиотеки.
Добавили возможность скрывать логотип Oz Forensics.
Дополнили руководства для некоторых браузеров и социальных сетей.
Добавили обработку неизвестных и руководство для "неизвестных" браузеров.
Оптимизировали потребление памяти для рамки.
Добавили руководство по включению камер в различных браузерах под Android.
Для работы плагина Oz Liveness браузер должен поддерживать JavaScript ES6. Версия браузера должна быть не ниже указанной в таблице.
Браузер | Версия |
---|---|
*В режиме совместимости с Internet Explorer Web SDK работать не будет, так как не поддерживаются некоторые важные функции.
Google Chrome (и другие браузеры на движке Chromium)
56
Mozilla Firefox
55
Safari
11
Microsoft Edge*
17
Opera
47