Flutter сэмпл
Сэмпл демонстрирует использование плагина Face SDK для Flutter и включает в себя следующие функции:
- получение изображения с фронтальной или задней камеры устройства и детекция лиц на них
- детекция лиц на видеопотоке с фронтальной камеры и проверка Active Liveness
Требования
- Flutter >=2.2 and <=2.8.1
- Android или iOS устройство
Запуск сэмпла
Для запуска сэмпла необходимо установить компонент "flutter" с помощью инсталлятора Face SDK или утилиты maintenancetool:
Если Face SDK не установлен, следуйте инструкции по установке Приступая к работе. Необходимо выбрать компонент "flutter" в разделе "Выбор компонентов".
Если Face SDK установлен без компонента "flutter" (директория flutter отсутствует в корневой директории Face SDK), воспользуйтесь утилитой maintenancetool и установите компонент "flutter", выбрав его в разделе "Выбор компонентов".
Подключить Android или iOS-устройство к компьютеру
Скопировать папку lib из директории flutter в examples/flutter/demo/assets
Поместить файл лицензии 3divi_face_sdk.lic в директорию examples/flutter/demo/assets/license
Выполнить сборку и запуск сэмпла с помощью консоли или через Android Studio (см. ниже)
Запуск из консоли
Для запуска сэмпла из консоли необходимо перейти в директорию examples/flutter/demo и выполнить команды:
flutter pub get
flutter run
Устранение неполадок
Используйте stable-версию Flutter не ниже 2.2. Выбрать и скачать дистрибутив Flutter для своей операционной системы можно по ссылке.
Добавьте путь до директории bin дистрибутива Flutter в переменную окружения
PATH. Инструкция по добавлению переменной окружения для Linux и MacOS доступна по ссылке, для Windows по ссылке.
Запуск через Android Studio
- откройте папку examples/flutter/demo в Android Studio
- в Android Studio:
- откройте файл demo/pubspec.yaml и нажмите кнопку "Pub get"
- нажмите кнопку "Run"
Устранение неполадок
Используйте stable-версию Flutter не ниже 2.2. Выбрать и скачать дистрибутив Flutter для своей операционной системы можно по ссылке.
Укажите путь к дистрибутиву Flutter в настройках Android Studio: "File" > "Settings" > "Languages & Frameworks" > "Flutter".
Установите плагины Flutter и Dart в Android Studio. Список установленных плагинов и Marketplace для их установки доступны в настройках Android Studio: "File" > "Settings" > "Plugins".
Описание функций
После запуска сэмпла на экране устройства отображается стартовый экран и кнопка "Start". Необходимо нажать на кнопку "Start" для перехода в режим "Detect face on photo".
Detecting Faces On Photo
В режиме "Detecting Faces On Photo" на экране устройства отображается превью с камеры устройства. В верхней части экрана отображается инструкция "Take a photo of the document". В нижней части экрана отображаются кнопки "Take a photo" (внизу слева) и "Change Camera" (внизу справа).
Для продолжения работы необходимо сфотографировать документ с изображением лица. Нажмите кнопку "Take a photo" (внизу слева) для того чтобы сделать снимок. После этого на экране устройства отобразится фото "Detected faces", задетектированное лицо будет выделено ограничительно рамкой (bounding box).
После успешной детекции лица на фотографии отобразится кнопка "Next" (справа внизу) для перехода в режим проверки Active Liveness.
Active Liveness
Для корректного прохождения проверки Active Liveness в кадре камеры должно находиться только одно лицо. Проверка Active Liveness запускается автоматически при обнаружении лица.
Действия, которые необходимо выполнить для прохождения проверки Active Liveness, отображаются в виде сообщений в верхней части экрана.
Индикатор прогресса прохождения текущей проверки отображается на экране устройства внизу.
Если на экране отображается сообщение "Please, look at the camera", то необходимо выровнять расположение лица относительно камеры (углы наклона головы от вертикальной оси не должны превышать 15 градусов).
После прохождения проверки Active Liveness в верху экрана устройства отобразятся вердикт проверки "PASSED" или "FAILED" и кнопка "Next" (справа внизу) для перехода к результатам оценки лица.
Нажатие на кнопку "Next" отобразит на экране устройства следующие результаты:
- Match score - Оценка совпадение лица на фото и лица, прошедшего проверку Active Liveness. Максимальное значение 1 означает, что лица принадлежат одной персоне.
- Is same person - Вердикт о принадлежности лица одной персоне, принимает значения "true" или "false".
- Liveness passed - Вердикт о прохождении проверки Active Liveness, принимает значение "true" или "false".
Ниже результатов отображается кнопка "Next", при нажатии на которую произойдет переход на стартовый экран.