Skip to content
Material Design 2
Main Navigation
v3
v2
v1

Français

English
简体中文
繁體中文
Español
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Français

English
简体中文
繁體中文
Español
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Apparence

Sidebar Navigation

Système Material

Introduction

Études Material

À propos des études Material

Basil

Crane

Fortnightly

Owl

Rally

Reply

Shrine

Fondements Material

Environnement

Surfaces

Élévation

Lumière et ombres

Mise en page

Comprendre la mise en page

Densité de pixels

Grille de mise en page adaptative

Méthodes d'espacement

Comportement des composants

Application de la densité

Navigation

Comprendre la navigation

Transitions de navigation

Recherche

Couleur

Le système de couleurs

Application de la couleur à l'interface utilisateur

Utilisation de la couleur

Lisibilité du texte

Thème sombre

Typographie

Le système typographique

Comprendre la typographie

Prise en charge des langues

Son

À propos du son

Appliquer le son à l'interface utilisateur

Attributs sonores

Chorégraphie du son

Iconographie

Icônes de produit

Icônes système

Icônes animées

Forme

À propos des formes

Forme et hiérarchie

La forme en tant qu'expression

Forme et animation

Appliquer des formes à l'interface utilisateur

Animation

Comprendre l'animation

Le système d'animation

Vitesse

Chorégraphie

Personnalisation

Interaction

Gestes

Sélection

États

Communication

Confirmation et accusé de réception

Formats de données

Visualisation de données

États vides

Aide et commentaires

Visuels

Écran de lancement

Intégration (Onboarding)

États hors ligne

Rédaction

Apprentissage automatique

Modèles de conception pour l'apprentissage automatique

Détection d'objets : caméra en direct

Détection d'objets : image statique

Lecture de codes-barres

Lignes directrices Material

Material Theming

Vue d'ensemble

Mise en œuvre de votre thème

Utilisabilité

Accessibilité

Bidirectionnalité

Lignes directrices par plateforme

Barres Android

Empreinte digitale Android

Retours haptiques Android

Icônes Android

Navigation entre applications sous Android

Notifications sur Android

Autorisations Android

Slices Android

Écran partagé Android

Android : balayer pour actualiser

Barre d'outils de sélection de texte sous Android

Widget Android

Adaptation multiplateforme

Composants

Barres d'application : barre inférieure

Barres d'application : barre d'application supérieure

Backdrop

Bannières

Navigation inférieure

Boutons

Boutons : bouton d'action flottant

Cartes

Cases à cocher

Puces

Tableaux de données

Sélecteurs de date

Boîtes de dialogue

Séparateurs

Listes d'images

Listes

Menus

Tiroir de navigation

Rail de navigation

Indicateurs de progression

Boutons radio

Feuilles inférieures

Panneaux latéraux

Curseurs

Snackbars

Commutateurs

Onglets

Champs de texte

Sélecteurs d'heure

Infobulles

Sur cette page

Lecture de codes-barres ​

Grâce à l'apprentissage automatique, le flux vidéo en direct de la caméra d'un appareil peut lire les données encodées dans la plupart des formats de codes-barres standards.

Image principale de la lecture de codes-barres

Utilisation ​

Les codes-barres constituent un moyen simple et pratique de transférer vers un appareil des données complexes ou structurées issues du monde physique. L'API de lecture de codes-barres de ML Kit permet à votre application de lire la plupart des formats de codes-barres standards, sans que les utilisateurs aient à recourir à une application distincte de lecture de codes-barres.

La lecture de codes-barres facilite des tâches simples d'identification et de contenu : rechercher un produit à acheter, consulter les détails d'un événement ou remplir un formulaire.

Ces lignes directrices de conception portent sur la lecture de codes-barres à partir du flux vidéo en direct de la caméra.

La lecture de codes-barres offre aux utilisateurs une alternative pratique à la recherche manuelle d'informations sur les produits ou à la saisie de données.

Documentation de l'API ML Kit

Guides du développeur pour la lecture de codes-barres

Lien connexe

Exemple – Android

Application de démonstration ML Kit pour Android

Lien connexe

Principes ​

La conception de cette fonctionnalité repose sur les principes suivants :

Naviguer avec la caméra de l'appareil

Au lieu de saisir un terme de recherche, l'utilisateur utilise la caméra de son appareil comme une « télécommande » pour scanner les codes-barres.

Pour expliquer aux utilisateurs comment scanner des codes-barres avec leur caméra, proposez un parcours d'introduction et des instructions permanentes.

Une brève animation d'introduction montre comment scanner un code-barres en orientant correctement la caméra de l'appareil.

Garder l'aperçu de la caméra dégagé et lisible

Alignez les composants de l'interface caméra sur les bords supérieur et inférieur de l'écran, et veillez à ce que le texte et les icônes restent lisibles lorsqu'ils sont superposés à l'image.

Tout élément non interactif affiché en surimpression du flux vidéo en direct doit être translucide afin de masquer le moins possible la vue de la caméra.

La plupart des éléments de l'expérience sont placés le long des bords supérieur et inférieur de l'écran pour maximiser la visualisation
La plupart des éléments de l'interface sont placés le long des bords supérieur et inférieur de l'écran afin de maximiser la zone visible du flux de la caméra.

Fournir un retour d'information

Le scan de codes-barres par caméra impose des exigences d'usage particulières : la qualité de l'image doit être suffisante, et les utilisateurs doivent savoir comment corriger les problèmes d'image causés par l'éclairage ou par une distance trop grande par rapport au code-barres.

Les états d'erreur doivent être signalés par plusieurs indices visuels (composants, animations) et accompagnés d'explications sur la manière dont les utilisateurs peuvent améliorer leur recherche.

Le cadre de code-barres et l'infobulle indiquent tous deux que l'utilisateur doit se rapprocher pour « terminer » la lecture du code-barres
Le cadre de code-barres et l'infobulle indiquent tous deux que l'utilisateur doit se rapprocher pour « terminer » la lecture du code-barres.

Composants ​

La lecture de codes-barres via le flux vidéo en direct de la caméra repose sur des composants Material Design existants ainsi que sur de nouveaux éléments spécifiques à l'interaction avec la caméra. Pour des exemples de code et des démonstrations de ces nouveaux éléments (comme le cadre de code-barres), consultez le code source de l'application de démonstration ML Kit Material Design pour Android.

Éléments clés tout au long des étapes d'une expérience de lecture de codes-barres
Éléments clés tout au long des étapes d'une expérience de lecture de codes-barres :
1. Barre d'application supérieure
2. Cadre de code-barres
3. Infobulle
4. Volet inférieur modal
Composants

Exemple – Android

Application de démonstration ML Kit pour Android

Lien connexe

Barre d'application supérieure ​


La barre d'application supérieure donne un accès permanent aux actions suivantes :

  • Un bouton pour quitter l'expérience de recherche
  • Un bouton à bascule pour améliorer la luminosité (en activant le flash de la caméra)
  • Une section d'aide pour résoudre les problèmes de recherche
À faire : utiliser un voile en dégradé ou une couleur unie pour le conteneur de la barre d'application supérieure afin de garantir la lisibilité de ses actions sur le flux de la caméra

À faire

Utilisez un voile en dégradé ou une couleur unie pour le conteneur de la barre d'application supérieure afin de garantir la lisibilité de ses actions sur le flux de la caméra.

Barre d'application supérieure

La barre d'application supérieure affiche des informations et des actions relatives à la vue actuelle.

Article connexe

Cadre de code-barres ​

Le cadre de code-barres est une zone au centre de l'écran dans laquelle l'utilisateur peut scanner un code-barres. Par défaut, le cadre est carré, mais votre application doit ajuster sa taille et ses proportions en fonction des types de codes-barres pris en charge.

Il remplit trois fonctions :

  1. Confirmation : la forme du cadre correspond aux dimensions d'un code-barres unique, indiquant clairement qu'un seul code-barres peut être lu à la fois.
  2. Lisibilité : si les formats de codes-barres simples peuvent être lus à distance, les formats complexes (comme le PDF417) peuvent nécessiter une image plus rapprochée et de meilleure qualité. L'affichage d'une bordure de détection partielle sur le cadre indique à l'utilisateur qu'il doit se rapprocher pour scanner.
  3. Activité : pendant la phase de « perception », la bordure du cadre émet des pulsations pour signaler que l'application recherche des codes-barres.
Le cadre de code-barres fournit un guide animé qui indique où placer le code-barres, s'il faut se rapprocher pour l'agrandir et l'état actuel de la lecture.

États du cadre de code-barres :

1. La perception est signalée par une animation à pulsations indiquant que l'application recherche des codes-barres
2. L'affichage d'une bordure partielle sur le cadre (accompagnée d'une infobulle) indique que l'utilisateur doit se rapprocher du code-barres
3. La recherche est signalée par un indicateur de progression indéterminé sur le cadre
4. En cas d'erreur, le contour continu du cadre devient pointillé

Infobulle ​

Les infobulles affichent un texte informatif aux utilisateurs : elles indiquent l'état actuel (par exemple « Recherche en cours… ») et les invitent à passer à l'étape suivante (par exemple « Pointez votre caméra vers un code-barres »).

À faire : rédiger des messages courts en utilisant des termes adaptés à votre audience

À faire

Rédigez des messages courts, en utilisant des termes adaptés à votre audience.
À ne pas faire : rédiger des infobulles avec des verbes d'action, tels que « Appuyez pour rechercher », car elles ne déclenchent aucune action

À ne pas faire

N'utilisez pas de verbes d'action dans les infobulles, tels que « Appuyez pour rechercher », car elles ne déclenchent aucune action.

À ne pas faire : placer des messages d'erreur dans une infobulle

À ne pas faire

Ne placez pas de messages d'erreur dans une infobulle. Affichez-les plutôt dans une bannière, afin de leur donner plus de visibilité et de l'espace pour présenter des actions.

Infobulles

Afficher un texte informatif lorsque les utilisateurs survolent, sélectionnent au clavier ou touchent un élément

Article connexe

Feuille inférieure modale ​

Les volets inférieurs modaux permettent d'afficher les informations d'un code-barres pendant que l'utilisateur reste dans la fonctionnalité de lecture. La mise en page et le contenu du volet dépendent du type de données renvoyées par le code-barres, par exemple :

  • Les données structurées (telles que les informations de contact) peuvent être affichées dans des champs de texte pour être lues et modifiées
  • Les informations provenant d'une base de données doivent être présentées dans un style adapté au type de contenu, qui varie selon le cas : un contenu de réseau social n'a pas la même structure qu'un produit de vente au détail.

Affichage des résultats ​

Si la tâche de l'utilisateur peut être accomplie plus rapidement ou plus facilement sur un autre écran de l'application, présentez les informations du code-barres sur cet écran plutôt que dans un volet inférieur modal. Reportez-vous à la section Expérience pour savoir quand et où afficher les informations du code-barres dans l'application.

Les champs de texte se prêtent bien à la présentation de données structurées dans un volet inférieur
Les champs de texte se prêtent bien à la présentation de données structurées dans un volet inférieur. Chaque libellé et chaque champ de saisie peut représenter une « clé » de données et sa « valeur », comme le nom d'un réseau Wi-Fi.
La mise en page d'un volet inférieur modal peut être personnalisée pour correspondre aux informations d'un code-barres
La mise en page d'un volet inférieur modal peut être personnalisée pour correspondre aux informations du code-barres, comme un profil d'utilisateur de réseau social.

Volets inférieurs

Surfaces contenant du contenu complémentaire, ancrées en bas de l'écran.

Article connexe

Expérience ​

La lecture de codes-barres via le flux vidéo en direct de la caméra se déroule en trois phases :

  1. Perception : utiliser la caméra pour rechercher un code-barres
  2. Reconnaissance : détecter un code-barres
  3. Communication : afficher les résultats directement dans le lecteur ou sur un autre écran

Perception ​

La « perception » désigne la phase pendant laquelle la caméra recherche des codes-barres dans le flux vidéo en direct. La lecture commence lorsque l'utilisateur ouvre la fonctionnalité de codes-barres dans une application.

Pendant cette phase, l'application doit :

  • Expliquer le fonctionnement de la fonctionnalité
  • Communiquer les actions de l'application
  • Aider l'utilisateur à ajuster la manière dont il oriente la caméra

À faire

Expliquez l'interaction au moyen d'une expérience d'introduction sur un seul écran. Une animation est recommandée pour montrer à l'utilisateur comment déplacer son appareil.

À faire

Indiquez que l'application recherche des codes-barres. Le cadre de code-barres utilise une animation à pulsations pour signaler qu'il « scanne » le flux de la caméra, accompagnée d'une infobulle invitant l'utilisateur à centrer un code-barres dans le cadre.

Guider les ajustements

Les conditions environnementales, comme un éclairage trop lumineux ou trop sombre, peuvent rendre la lecture d'un code-barres difficile.

Une section d'aide peut aider les utilisateurs à identifier et résoudre les problèmes liés à leur expérience
Une section d'aide permet aux utilisateurs d'identifier et de résoudre les problèmes rencontrés. Elle peut fournir des informations pédagogiques sur des sujets tels que les angles de prise de vue appropriés, la distance et les conditions d'éclairage.

Reconnaissance ​

Lorsqu'un code-barres a été détecté par la caméra, l'application doit :

  1. Mettre la caméra en pause et lire la valeur du code-barres
  2. Afficher immédiatement la valeur s'il s'agit de données structurées
  3. Rechercher la valeur et afficher la progression si elle doit être récupérée

Dans cette phase, le code-barres détecté est lu par l'API Barcode Scanning, et le flux de la caméra est mis en pause pour éviter de scanner un autre code-barres.

Les codes-barres contenant des données structurées reconnues par l'API (telles que des coordonnées géographiques ou des événements d'agenda) peuvent être présentés immédiatement à l'utilisateur. Si les données ne sont pas structurées, les informations détaillées sont récupérées à partir d'une base de données, et l'application affiche un état de chargement pendant cette récupération.

À faire

Utilisez plusieurs indices visuels pour indiquer qu'un code-barres pris en charge a été détecté. La bordure du cadre de code-barres passe de transparente à opaque pendant que le flux de la caméra est mis en pause.

À faire

Si votre application doit rechercher la valeur d'un code-barres, affichez un indicateur de progression indéterminé et un message d'infobulle pour signaler que les résultats sont en attente.

Gérer les erreurs ​

La détection d'un code-barres ne garantit pas que votre application trouvera des résultats. Les problèmes suivants peuvent survenir :

  • Aucun résultat pertinent : un code-barres lu correctement peut ne pas contenir d'informations pertinentes pour votre application ou votre cas d'utilisation, par exemple si le code-barres provient d'une source sans lien.
  • Perte de connexion réseau : si la valeur du code-barres doit être recherchée dans une base de données en ligne, la requête peut échouer sans connexion Internet.
  • Code-barres trop petit : si les formats de codes-barres simples peuvent être lus à distance, les formats complexes (comme le PDF417) peuvent nécessiter une image plus rapprochée et de meilleure qualité. Pour indiquer à l'utilisateur qu'il doit se rapprocher du code-barres avant de pouvoir le scanner, définissez une taille minimale de lecture pour les formats acceptés par votre application et utilisez plusieurs indices visuels (comme le cadre de code-barres et l'infobulle).

À faire : utiliser une bannière pour indiquer qu'aucun objet correspondant n'a été identifié

À faire

Utilisez une bannière pour indiquer qu'aucun objet correspondant n'a été identifié. Proposez des options pour accéder à une section d'aide dédiée ou réessayer avec une autre image.

À faire

Définissez une taille minimale de lecture pour les formats de codes-barres acceptés par votre application afin de garantir un scan précis. Invitez l'utilisateur à se rapprocher du code-barres jusqu'à ce que celui-ci atteigne cette taille minimale.

Erreurs et gestion des échecs

Comment gérer les erreurs d'apprentissage automatique

Lien connexe

Communication ​

Les résultats d'une lecture de code-barres peuvent être affichés de plusieurs manières :

  • En surimpression sur le flux de la caméra (dans une feuille inférieure modale ou une boîte de dialogue)
  • À la sortie de la fonctionnalité de lecture, sur l'écran où les informations du code-barres peuvent être utilisées

Pour adapter l'interface à votre cas d'utilisation, les modèles de navigation et composants suivants sont recommandés :

Exemple de cas d'utilisationRester dans le lecteur de codes-barres ?Emplacement d'affichage des résultats
Parcourir des produits dans un magasinOuiVolet inférieur modal
Ajouter un contactOui, jusqu'à ce que l'utilisateur l'enregistreVolet inférieur modal ou boîte de dialogue en plein écran
Remplir un formulaireNon, retour au formulaireLes champs pertinents du formulaire sont remplis pour l'utilisateur

À faire

Affichez les résultats du code-barres en surimpression sur le flux de la caméra afin que les utilisateurs puissent scanner d'autres articles sans rouvrir le lecteur.

À faire

La modification et l'enregistrement d'informations (comme un nouveau contact) peuvent être effectués rapidement dans le lecteur de codes-barres. Présentez les données structurées dans des champs de texte modifiables, avec une option pour enregistrer et quitter le lecteur.

À faire

La lecture d'un code-barres peut remplacer la saisie manuelle des champs d'un formulaire. Une fois la lecture réussie, l'utilisateur doit être ramené au formulaire pour accomplir sa tâche.

Application du thème ​

Thème Shrine Material ​

La lecture de codes-barres est utilisée dans le parcours d'achat de l'application Shrine.

Le voile du code-barres et le texte de l'infobulle de Shrine sont mis en valeur par des couleurs sombres qui contrastent avec leurs fonds clairs
Le voile du code-barres et le texte de l'infobulle de Shrine sont mis en valeur par des couleurs sombres qui contrastent avec leurs fonds clairs.
Les résultats de la recherche visuelle utilisent les couleurs de marque, la typographie et les styles de forme de Shrine
Les résultats de la recherche visuelle utilisent les couleurs de marque, la typographie et les styles de forme de Shrine.

Cadre de code-barres ​

Le cadre de code-barres de Shrine utilise la couleur « On Primary » du thème pour son voile. La bordure du cadre présente des angles vifs qui rappellent la forme géométrique du logo de la marque.

Le cadre de code-barres par défaut utilise #000000 comme couleur de voile avec un contour arrondi
1. Le cadre de code-barres par défaut utilise #000000 comme couleur de voile avec un contour arrondi.
2. Le cadre de code-barres de Shrine utilise Shrine Pink 900 (#442C2E) comme couleur de voile avec un contour aux angles vifs.

Infobulle ​

L'infobulle de Shrine se distingue par l'utilisation de couleurs, d'une typographie et d'un placement personnalisés.

Les infobulles sont généralement des composants discrets dont la largeur s'adapte à leur texte
1. Les infobulles sont généralement des composants discrets dont la largeur s'adapte à leur texte.
2. L'infobulle de Shrine utilise des couleurs et une typographie personnalisées, et son conteneur s'étend jusqu'aux bords de l'écran.

Shrine

Shrine est une marque de style de vie et de mode qui démontre comment Material Design peut être appliqué à l'e-commerce.

Article connexe

Pager
Page précédenteDétection d'objets : image statique
Page suivanteVue d'ensemble

Publié sous la licence Apache-2.0.

Copyright © 2018-Present Google

https://m2.material.io/design/machine-learning/barcode-scanning.html

Publié sous la licence Apache-2.0.

Copyright © 2018-Present Google