Escáner de códigos de Google (solo para Android)

Antes de comenzar

Para preparar tu app, completa los pasos que se indican en las siguientes secciones.

Cómo configurar tu app

1. En tu archivo settings.gradle de nivel superior, incluye el repositorio de Maven de Google y El repositorio central de Maven, en el Bloque dependencyResolutionManagement:

   dependencyResolutionManagement {
     repositories {
       google()
       mavenCentral()
     }
   }
   

2. Agrega la dependencia de los Servicios de Google Play para play-services-code-scanner. SDK al archivo de compilación de Gradle de tu módulo, que suele ser app/build.gradle:

   dependencies {
     implementation 'com.google.android.gms:play-services-code-scanner:16.1.0'
   }
   

3. Puedes configurar tu app para que use los Servicios de Google Play automáticamente descarga el módulo del escáner en el dispositivo mientras la app está instalada desde Play Store.

   <application ...>
     ...
     <meta-data
         android:name="com.google.mlkit.vision.DEPENDENCIES"
         android:value="barcode_ui"/>
     ...
   </application>
   

   También puedes comprobar de forma explícita la disponibilidad y la solicitud del módulo de análisis descargar a través de los servicios de Google Play ModuleInstallClient API

   Si no habilitas las descargas de módulos en el momento de la instalación ni solicitas descargas, y el módulo de escáner no está instalado para otro caso de uso: Los Servicios de Google Play descargan el módulo de escáner tiempo de uso.

Escanear un código

Implementa los siguientes pasos para escanear un código de barras.

1. Opcional: Configura el escáner de código.

   Si sabes qué formatos de códigos de barras leerás, puedes mejorar la del detector de códigos de barras configurándolo para que solo detecte aquellos formatos. Por ejemplo, para detectar solo códigos QR y Aztec, crea una GmsBarcodeScannerOptions como en el siguiente ejemplo:

   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();
   

   De forma predeterminada, el zoom automático está desactivado. Para habilitar la función de zoom automático a partir de la versión 16.1.0, llama a enableAutoZoom() como se muestra en siguiente ejemplo de código.

   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();
   

2. Obtén una instancia de GmsBarcodeScanner. como se muestra en el ejemplo de código:

   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);
   

3. Llama a startScan() para solicitar un análisis de código.

   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
          });
   

4. Controla el Barcode resultante.

   Kotlin

   val rawValue: String? = barcode.rawValue
   

   Java

   String rawValue = barcode.getRawValue();