Как сравнить лицо из снятого для проверки Liveness видео с лицом из вашей базы данных
В этой статье вы узнаете, как сравнить лицо из готового Liveness-видео с лицом на референтной фотографии, сохраненной в вашей базе данных.
Обратите внимание: инструкции применимы для версий, которые не работают с контейнером данных.
Если вы хотите провести сравнение с использованием фото документа вместо изображения из базы данных, соответствующая инструкция находится здесь.
К этому моменту вы, скорее всего, уже разобрались с тем, как снимать видео и проводить Liveness-проверки. Если нет, пожалуйста, ознакомьтесь со статьями:
В данном сценарии описывается, как загрузить референтное фото в ту же папку, где находится снятое ранее Liveness-видео, запустить анализ BIOMETRY и получить результаты.
1. Получите идентификатор папки, где находится нужное видео –folder_id
Сравнение лиц должно происходить в одной папке, поэтому вам необходим идентификатор папки, где лежит нужное вам Liveness-видео. Получите идентификатор папки, как показано ниже, и передайте его на свой бэкенд.
Для видео, записанного через Web SDK, процесс получения идентификатора папки описан .
Для видео, записанного через наши мобильные SDK, получите идентификатор папки из результатов анализа:
Android:
iOS:
2. Загрузите в папку референтное фото из своей базы данных
Вызовите POST /api/folders/{{folder_id}}/media/. Замените folder_id на полученный на предыдущем шаге идентификатор папки. Так ваше изображение попадет в папку с нужным видео.
Установите в запросе теги в соответствии с тем, что за фото вы загружаете – фото документа или селфи. Это нужно сделать в поле Payload.
3. Запустите анализ
Для запуска анализа вызовите POST /api/folders/{{folder_id}}/analyses/. Замените folder_id на полученный ранее идентификатор папки. В теле запроса укажите анализ BIOMETRY.
4. Запустите опрос для получения результатов
Раз в секунду отправляйте GET /api/analyses/{{analyse_id}} с полученным ранее analyse_id, пока состояние анализа не изменится с PROCESSING на какое-либо другое. Когда анализ завершится, вы можете оценить результаты:
качественные – в resolution (SUCCESS или DECLINED).
количественные – в analyses.results_data.min_confidence
Коллекция Postman для описанных в статье шагов.
Эти шаги помогут вам провести сравнение лиц с использованием Oz API. Чтобы получить доступ к снятым видео и результатам анализов, воспользуйтесь или API-запросами.
Детальную информацию о том, как применять инструменты Oz API, вы можете найти в .
analysisRequest.run(
scenarioStateHandler: { state in },
uploadProgressHandler: { (progress) in }
) { (analysisResults : [OzAnalysisResult], error) in
// сохраните folder_id, он потребуется далее
let folderID = analysisResults.first?.folderID
}
}
{
"media:tags": {
"photo1": [
"photo_id", "photo_id_front" // для фото лицевой стороны документа
// ИЛИ
"photo_selfie" // для фото, не являющегося документом
]
}
}
{
"analyses": [
{
"type": "biometry"
}
]
}
Как добавить съемку документа и возможность сопоставления лиц в ваше веб- или мобильное приложение
Обратите внимание: инструкции применимы для версий, которые не работают с контейнером данных.
Обратите внимание: в мобильных SDK Oz отсутствует интерфейс для съемки документов. Для этого вам потребуется ПО стороннего производителя или ваше собственное. В Web SDK есть базовая функциональность съемки документа.
Ниже описаны шаги, которые потребуется пройти для добавления сравнения лиц к Liveness-проверке.
К этому моменту вы, скорее всего, уже разобрались с тем, как снимать видео и проводить Liveness-проверки. Если нет, пожалуйста, ознакомьтесь со статьями:
Добавление съемки документа в Web SDK
Добавьте photo_id_front в список действий для плагина.
Добавление сравнения лиц в Android SDK
Внимание: в данном случае мы предполагаем, что фотография (например, документа) хранится на устройстве под названием reference.jpg.
Измените код, запускающий анализ:
Для анализа на устройстве вместо Analysis.Mode.SERVER_BASED укажите Analysis.Mode.ON_DEVICE.
Код образца для Android находится .
Добавление сравнения лиц в iOS SDK
Внимание: в данном случае мы предполагаем, что фотография (например, документа) хранится на устройстве под названием reference.jpg.
Измените код, запускающий анализ:
Для анализа на устройстве вместо .serverBased укажите .onDevice.
Код образца для iOS находится .
Для всех SDK
Чтобы получить доступ к снятым видео и результатам анализов, воспользуйтесь или API-запросами.
Методы как API, так и SDK могут гибко комбинироваться. Подробнее об этом вы можете прочитать в .
