Сканирование штрихкодов
С помощью машинного обучения камера устройства в режиме реального времени считывает данные, закодированные в большинстве стандартных форматов штрихкодов.

Использование
Штрихкоды — это простой и удобный способ передачи сложных или структурированных данных из реального мира на устройство. ML Kit Barcode Scanning API позволяет вашему приложению считывать большинство стандартных форматов штрихкодов, избавляя пользователей от необходимости переключаться на отдельное приложение для их чтения.
Сканирование штрихкодов помогает пользователям решать простые задачи идентификации и работы с контентом: находить товар для покупки, получать информацию о мероприятии или заполнять формы.
Эти рекомендации по дизайну касаются сканирования штрихкодов с использованием камеры в режиме реального времени.
Руководства для разработчиков по сканированию штрихкодов
Связанная ссылка
Пример – AndroidДемонстрационное приложение ML Kit для Android
Связанная ссылка
Принципы
Дизайн этой функции основан на следующих принципах:
Навигация с помощью камеры устройства
Вместо ввода поискового запроса камера устройства используется как «пульт управления» для сканирования штрихкодов.
Чтобы обучить пользователей сканированию штрихкодов с помощью камеры, предоставьте вводное руководство (онбординг) и постоянные подсказки.
Держите обзор камеры свободным и читаемым
Размещайте элементы интерфейса камеры у верхнего и нижнего краёв экрана, следя за тем, чтобы текст и значки оставались читаемыми поверх изображения.
Все неинтерактивные элементы, отображаемые поверх изображения с камеры, должны быть полупрозрачными, чтобы как можно меньше перекрывать обзор.

Обеспечьте обратную связь
Использование камеры для сканирования штрихкодов предъявляет особые требования к взаимодействию: качество изображения должно быть достаточным, а пользователи должны понимать, как исправить проблемы, вызванные плохим освещением или слишком большим расстоянием до штрихкода.
О состояниях ошибок следует сообщать с помощью нескольких визуальных сигналов (таких как компоненты и анимация), поясняя, как пользователь может улучшить результаты сканирования.

Компоненты
Сканирование штрихкодов с камеры в режиме реального времени использует существующие компоненты Material Design и новые элементы, специфичные для взаимодействия с камерой. Примеры кода и демонстрации новых элементов (таких как рамка штрихкода) можно найти в исходном коде демонстрационного приложения ML Kit Material Design для Android.

1. Верхняя панель приложения
2. Рамка штрихкода
3. Всплывающая подсказка
4. Модальная нижняя панель

Верхняя панель приложения
Верхняя панель приложения обеспечивает постоянный доступ к следующим действиям:
- Кнопка выхода из режима сканирования
- Переключатель яркости (управление вспышкой камеры)
- Раздел справки для устранения проблем со сканированием

Рекомендуется
Рамка штрихкода
Рамка штрихкода — это область в центре экрана, в пределах которой пользователь сканирует штрихкод. По умолчанию рамка квадратная, но приложение должно настроить её размер и соотношение сторон в соответствии с поддерживаемыми типами штрихкодов.
Она выполняет три функции:
- Подтверждение: Форма рамки соответствует размерам одного штрихкода, поэтому понятно, что за один раз можно отсканировать только один штрихкод.
- Читаемость: Простые форматы штрихкодов можно считывать на расстоянии, тогда как сложные форматы (такие как PDF417) требуют более близкого расстояния и качественного изображения для точного считывания. Отображая частичную границу обнаружения поверх рамки штрихкода, интерфейс подсказывает пользователю, что нужно поднести устройство ближе для сканирования.
- Активность: Граница рамки пульсирует на этапе «поиска», указывая, что приложение ищет штрихкоды для сканирования.
1. Поиск: пульсирующая анимация указывает, что приложение ищет штрихкоды для сканирования
2. Частичная граница поверх рамки (вместе со всплывающей подсказкой) указывает, что пользователю нужно поднести устройство ближе к штрихкоду
3. Поиск значения: неопределённый индикатор выполнения проходит через рамку штрихкода
4. При ошибках непрерывная линия границы рамки меняется на пунктирную
Всплывающая подсказка
Всплывающие подсказки отображают информационный текст. Например, они сообщают о состоянии (сообщение вроде «Поиск…») и подсказывают пользователю следующий шаг (сообщение вроде «Наведите камеру на штрихкод»).

Рекомендуется

Не рекомендуется

Не рекомендуется
Модальная нижняя панель
Модальные нижние панели предоставляют доступ к информации штрихкода, пока пользователь не вышел из режима сканирования. Макет и содержимое нижней панели зависят от типа данных, которые содержит штрихкод, например:
- Структурированные данные (такие как контактная информация) можно отобразить в текстовых полях для сканирования и редактирования
- Информацию из базы данных следует отображать в стиле, соответствующем типу контента. Типы контента различаются: например, контент из социальных сетей имеет другую структуру, чем данные о розничном товаре.
Отображение результатов
Если пользователю быстрее или проще выполнить свою задачу на другом экране приложения, отобразите информацию штрихкода на этом экране вместо модальной нижней панели. См. раздел «Взаимодействие», чтобы узнать, когда и где в приложении следует отображать информацию штрихкода.


Взаимодействие
Сканирование штрихкодов с камеры в режиме реального времени состоит из трёх этапов:
- Поиск: Использование камеры для поиска входных данных
- Распознавание: Обнаружение штрихкода
- Передача результатов: Отображение результатов сканирования прямо на экране сканирования или на другом экране
Поиск
«Поиск» — это процесс, при котором камера ищет штрихкоды в поступающем в режиме реального времени изображении. Сканирование начинается, когда пользователь открывает функцию сканирования в приложении.
На этом этапе приложение должно:
- Описывать, как работает функция
- Сообщать о действиях, выполняемых приложением
- Подсказывать, как настроить управление камерой
Рекомендуется
Рекомендуется
Подсказки по настройке
Внешние условия могут затруднить сканирование штрихкода, например, слишком яркое или слишком тёмное освещение.

Распознавание
Когда камера обнаруживает штрихкод, приложение должно:
- Приостановить камеру и считать значение штрихкода
- Немедленно отобразить значение, если это структурированные данные
- Выполнить поиск и отобразить его прогресс, если значение штрихкода требуется найти
На этом этапе штрихкод обнаруживается камерой и считывается с помощью Barcode Scanning API. Изображение с камеры приостанавливается, чтобы предотвратить сканирование другого штрихкода.
Штрихкоды, содержащие структурированные данные, распознаваемые API (такие как координаты местоположения и события календаря), могут быть немедленно представлены пользователю. Если данные штрихкода неструктурированы, подробная информация извлекается из базы данных. Пока идёт извлечение, приложение отображает состояние загрузки.
Рекомендуется
Рекомендуется
Внесение исправлений
Обнаружение штрихкода не гарантирует, что приложение найдёт результаты. Возможны следующие проблемы:
- Отсутствие релевантных результатов: Успешно отсканированный штрихкод может не содержать информации, относящейся к вашему приложению или сценарию использования, например, если был отсканирован штрихкод из постороннего источника.
- Потеря сетевого подключения: Если значение штрихкода запрашивается в онлайн-базе данных, запрос может завершиться ошибкой при отсутствии интернет-соединения.
- Малый размер штрихкода: Простые форматы штрихкодов можно считывать на расстоянии, тогда как сложные форматы (такие как PDF417) требуют более близкого расстояния и качественного изображения. Чтобы показать, что пользователю нужно поднести устройство ближе, задайте в приложении минимальный размер сканирования для поддерживаемых форматов штрихкодов и используйте несколько визуальных сигналов (например, в рамке штрихкода и всплывающей подсказке).

Рекомендуется
Рекомендуется
Передача результатов
Результаты сканирования штрихкода могут отображаться несколькими способами:
- Поверх камеры (в модальной нижней панели или диалоговом окне)
- После выхода из режима сканирования — на экране, где информация штрихкода может быть использована
Чтобы адаптировать интерфейс к вашему сценарию использования штрихкодов, рекомендуются следующие шаблоны навигации и компоненты:
| Пример сценария использования | Нужно ли оставаться в сканере штрихкодов? | Место отображения результатов |
|---|---|---|
| Просмотр товаров в магазине | Да | Модальная нижняя панель |
| Добавление контакта | Да, пока пользователь его не сохранит | Модальная нижняя панель или полноэкранное диалоговое окно |
| Заполнение формы | Нет, вернуться к форме | Автоматическое заполнение соответствующих полей формы |
Рекомендуется
Рекомендуется
Рекомендуется
Оформление
Тема Shrine в Material Design
Сканирование штрихкодов используется в сценарии покупки в приложении Shrine.


Рамка штрихкода
Рамка штрихкода Shrine использует цвет On Primary для своего затемняющего слоя. Граница рамки имеет острые углы, отражающие геометрическую форму фирменного логотипа.

2. Рамка штрихкода Shrine использует Shrine Pink 900 (#442C2E) в качестве цвета затемняющего слоя и острую границу.
Всплывающая подсказка
Всплывающая подсказка Shrine выделяется за счёт использования собственных цветов, типографики и расположения.

2. Всплывающая подсказка Shrine использует собственные цвета и типографику, а её контейнер растянут до краёв экрана.