Skaner kodów Google (tylko w Androidzie)

Zanim zaczniesz

Aby przygotować aplikację, wykonaj czynności opisane w poniższych sekcjach.

Konfiguracja aplikacji

1. W pliku settings.gradle najwyższego poziomu dodaj repozytorium Google Maven oraz Centralne repozytorium Maven w pliku Blokada dependencyResolutionManagement:

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

2. Dodaj zależność Usług Google Play do obiektu play-services-code-scanner pakietu SDK do pliku kompilacji modułu Gradle, który zwykle jest app/build.gradle:

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

3. Możesz skonfigurować w aplikacji Usługi Google Play automatycznie pobierz moduł skanera na urządzenie, gdy aplikacja jest zainstalowana w Sklepie Play.

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

   Możesz też bezpośrednio sprawdzić dostępność modułu skanera i wysłać żądanie pobierz przez Usługi Google Play ModuleInstallClient API.

   Jeśli nie włączysz pobierania modułów podczas instalacji lub nie poprosisz o treści dla pełnoletnich pobrane – a moduł skanera nie jest już zainstalowany dla innego przypadek użycia – Usługi Google Play po raz pierwszy pobierają moduł skanera, i czasu ich użycia.

Zeskanuj kod

Wykonaj poniższe czynności, aby zeskanować kod kreskowy.

1. Opcjonalnie: skonfiguruj skaner kodu.

   Wiedząc, jakie formaty kodu kreskowego spodziewasz się odczytać, możesz poprawić prędkości wykrywania kodu kreskowego przez skonfigurowanie go w taki sposób, aby wykrywał tylko formatów reklam. Na przykład, aby wykrywać tylko kody Aztec i kody QR, utwórz GmsBarcodeScannerOptions jak w tym przykładzie:

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

   Domyślnie automatyczne powiększanie jest wyłączone. Aby włączyć funkcję automatycznego powiększenia od wersji 16.1.0 zadzwoń do enableAutoZoom() zgodnie z instrukcją poniżej przykładowego kodu.

   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. Pobierz instancję GmsBarcodeScanner, Jak widać w przykładowym kodzie:

   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. Poproś o zeskanowanie kodu, dzwoniąc pod numer 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
          });

4. Wykonaj działanie w polu Barcode.

   Kotlin

   val rawValue: String? = barcode.rawValue

   Java

   String rawValue = barcode.getRawValue();