סורק הקודים של Google (Android בלבד)

לפני שמתחילים

כדי להכין את האפליקציה, מבצעים את השלבים שמפורטים בקטעים הבאים.

הגדרת האפליקציה

1. בקובץ settings.gradle ברמה העליונה, צריך לכלול את מאגר ה-Maven של Google ואת מאגר ה-Maven המרכזי בקטע dependencyResolutionManagement:

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

2. מוסיפים את התלות ב-Google Play Services בשביל ה-SDK של play-services-code-scanner אל קובץ ה-build של Gradle של המודול, שבדרך כלל נמצא ב-app/build.gradle:

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

3. אתם יכולים להגדיר את האפליקציה כך ש-Google Play Services יוריד באופן אוטומטי את מודול הסורק למכשיר בזמן שהאפליקציה מותקנת מחנות Play.

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

   אפשר גם לבדוק באופן מפורש את הזמינות של מודול הסורק ולבקש להוריד אותו דרך ModuleInstallClient API של Google Play Services.

   אם לא תפעילו הורדות של מודולים בזמן ההתקנה או תבקשו הורדות מפורשות, ואם מודול הסורק לא מותקן כבר לתרחיש שימוש אחר, Google Play Services יוריד את מודול הסורק בפעם הראשונה שתשתמשו בו.

סריקת קוד

כדי לסרוק ברקוד:

1. אופציונלי: מגדירים את סורק הקודים.

   אם אתם יודעים אילו פורמטים של ברקודים אתם צפויים לקרוא, אתם יכולים לשפר את מהירות הגלאי של הברקודים על ידי הגדרה שלו לזיהוי הפורמטים האלה בלבד. לדוגמה, כדי לזהות רק קוד Aztec וקודי QR, יוצרים אובייקט GmsBarcodeScannerOptions כמו בדוגמה הבאה:

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

   כברירת מחדל, הזום האוטומטי מושבת. כדי להפעיל את פונקציית הזום האוטומטי החל מגרסה 16.1.0, צריך להפעיל את enableAutoZoom() כמו שמוצג בדוגמת הקוד הבאה.

   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. מקבלים מופע של GmsBarcodeScanner, כמו שמוצג בקוד לדוגמה:

   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. כדי לבקש סריקת קוד, אפשר להתקשר למספר 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. מטפלים ב-Barcode שנוצר.

   Kotlin

   val rawValue: String? = barcode.rawValue

   Java

   String rawValue = barcode.getRawValue();