Перейти к основному содержимому
Версия: 3.22.0 (последняя)

Flutter сэмпл

Сэмпл демонстрирует использование плагина Face SDK для Flutter и включает в себя следующие функции:

  • Детекция лиц на изображении, полученном с фронтальной или задней камеры устройства
  • Детекция лиц на видеопотоке с фронтальной камеры и проверка Active Liveness

Требования​

  • Flutter 3.3.0 ≤ версии ≤ 3.16.3
  • Dart 2.17.0 ≤ версии ≤ 3.2.3
  • Установлены Latest models и Outdated models
  • Android или iOS устройство

Запуск сэмпла​

  1. Для запуска сэмпла необходимо установите компонент "flutter" с помощью инсталлятора Face SDK или утилиты maintenancetool:

    • Если Face SDK не установлен, следуйте инструкции по установке в разделе Начало работы. Необходимо выбрать компонент "flutter" в разделе "Выбор компонентов".

    • Если Face SDK установлен без компонента "flutter" (директория flutter отсутствует в корневой директории Face SDK), воспользуйтесь утилитой maintenancetool и установите компонент "flutter", выбрав его в разделе "Выбор компонентов".

  2. Подключите Android или iOS-устройство к компьютеру

  3. Запустите скрипт examples/flutter/scripts/linux.sh или examples/flutter/scripts/windows.bat

  4. Скопируйте папку lib из директории flutter в examples/flutter/demo/assets

  5. Выполните сборку и запуск сэмпла с помощью консоли или через Android Studio (см. ниже)

Запуск из консоли​

Для запуска сэмпла из консоли необходимо перейти в директорию examples/flutter/demo и выполнить команды:

flutter pub get
flutter pub upgrade
flutter run
Устранение неполадок

  • Используйте stable-версию Flutter не ниже 3.3.0. Выбрать и скачать дистрибутив Flutter для своей операционной системы можно по ссылке.

  • Добавьте путь до директории bin дистрибутива Flutter в переменную окружения PATH. Инструкция по добавлению переменной окружения для Linux и MacOS доступна по ссылке, для Windows по ссылке.

Запуск через Android Studio​

  • Откройте папку examples/flutter/demo в Android Studio
  • В Android Studio:
    • откройте файл demo/pubspec.yaml и нажмите кнопку "Pub get"
    • нажмите кнопку "Run"
Устранение неполадок

  • Используйте stable-версию Flutter не ниже 3.3.0. Выбрать и скачать дистрибутив 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", при нажатии на которую произойдет переход на стартовый экран.