L'API de lecteur de code Google fournit une solution complète pour scanner du code sans exiger que votre application demande l'autorisation d'accéder à l'appareil photo, tout en préservant la confidentialité des utilisateurs. Pour ce faire, déléguez la tâche de numérisation du code aux services Google Play et de ne renvoyer que les résultats de l'analyse à votre application (Vidéo 1).
Le traitement des images est intégralement effectué sur l'appareil, et Google ne stocke ni les résultats, ni les données d'image. L'API accepte les mêmes formats de code que l'API ML Kit Barcode Scanning et renvoie le même objet Barcode
.
Cette API est idéale pour les applications qui nécessitent de scanner facilement du code, sans avoir besoin d'une interface utilisateur ou d'un appareil photo personnalisés. L'implémentation réside entièrement dans les services Google Play, ce qui garantit un impact minimal sur la taille de votre application.
À partir de la version 16.1.0, vous pouvez activer le zoom automatique pour permettre au lecteur de code Google de scanner automatiquement les codes-barres éloignés de l'appareil photo. Lorsque l'utilisateur pointe son appareil vers un code-barres, le lecteur détecte le code-barres de manière intelligente et effectue un zoom avant dessus. Il n'est donc plus nécessaire d'ajuster manuellement le zoom, ce qui rend la lecture des codes-barres plus rapide, plus précise et plus accessible (voir la vidéo 2).
Vidéo 1. Intégration du lecteur de code Google | Vidéo 2. Effet de zoom automatique |
Pour les cas d'utilisation plus complexes nécessitant une interface utilisateur personnalisée, nous vous recommandons d'utiliser directement l'API ML Kit Barcode Scanning.
Si vous avez des questions, si vous souhaitez signaler un bug ou si vous avez besoin d'aide, consultez la page de la communauté ML Kit.
Avant de commencer
Pour préparer votre application, procédez comme indiqué dans les sections suivantes.
Configurer votre application
Dans votre fichier
settings.gradle
de premier niveau, incluez le dépôt Maven de Google et le dépôt central Maven sous le blocdependencyResolutionManagement
:dependencyResolutionManagement { repositories { google() mavenCentral() } }
Ajoutez la dépendance des services Google Play pour le SDK
play-services-code-scanner
au fichier de compilation Gradle de votre module, qui est généralementapp/build.gradle
:dependencies { implementation 'com.google.android.gms:play-services-code-scanner:16.1.0' }
Vous pouvez configurer votre application pour que les services Google Play téléchargent automatiquement le module d'analyse sur l'appareil lorsqu'elle est installée à partir du Play Store.
<application ...> ... <meta-data android:name="com.google.mlkit.vision.DEPENDENCIES" android:value="barcode_ui"/> ... </application>
Vous pouvez également vérifier explicitement la disponibilité du module d'analyse et demander un téléchargement via l'API ModuleInstallClient des services Google Play.
Si vous n'activez pas les téléchargements de modules au moment de l'installation ou si vous ne demandez pas de téléchargements explicites et que le module d'analyse n'est pas déjà installé pour un autre cas d'utilisation, les services Google Play téléchargent le module d'analyse lors de sa première utilisation.
Scanner un code
Pour scanner un code-barres, procédez comme suit :
Facultatif: configurez le lecteur de code.
Si vous connaissez les formats de code-barres que vous souhaitez lire, vous pouvez améliorer la vitesse du détecteur de codes-barres en le configurant pour ne détecter que ces formats. Par exemple, pour ne détecter que le code aztec et les codes QR, créez un objet
GmsBarcodeScannerOptions
comme dans l'exemple suivant:Kotlin
val options = GmsBarcodeScannerOptions.Builder() .setBarcodeFormats( Barcode.FORMAT_QR_CODE, Barcode.FORMAT_AZTEC) .build()
Java
GmsBarcodeScannerOptions options = new GmsBarcodeScannerOptions.Builder() .setBarcodeFormats( Barcode.FORMAT_QR_CODE, Barcode.FORMAT_AZTEC) .build();
Par défaut, le zoom automatique est désactivé. Pour activer la fonctionnalité de zoom automatique à partir de la version 16.1.0, appelez
enableAutoZoom()
comme indiqué dans l'exemple de code suivant.Kotlin
val options = GmsBarcodeScannerOptions.Builder() .setBarcodeFormats(...) .enableAutoZoom() // available on 16.1.0 and higher .build()
Java
GmsBarcodeScannerOptions options = new GmsBarcodeScannerOptions.Builder() .setBarcodeFormats(...) .enableAutoZoom() // available on 16.1.0 and higher .build();
Obtenez une instance de
GmsBarcodeScanner
, comme indiqué dans l'exemple de code:Kotlin
val scanner = GmsBarcodeScanning.getClient(this) // Or with a configured options // val scanner = GmsBarcodeScanning.getClient(this, options)
Java
GmsBarcodeScanner scanner = GmsBarcodeScanning.getClient(this); // Or with a configured options // GmsBarcodeScanner scanner = GmsBarcodeScanning.getClient(context, options);
Demandez un scan de code en appelant
startScan()
.Kotlin
scanner.startScan() .addOnSuccessListener { barcode -> // Task completed successfully } .addOnCanceledListener { // Task canceled } .addOnFailureListener { e -> // Task failed with an exception }
Java
scanner .startScan() .addOnSuccessListener( barcode -> { // Task completed successfully }) .addOnCanceledListener( () -> { // Task canceled }) .addOnFailureListener( e -> { // Task failed with an exception });
Gérez le
Barcode
obtenu.Kotlin
val rawValue: String? = barcode.rawValue
Java
String rawValue = barcode.getRawValue();