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

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

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

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

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

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

2. צריך להוסיף את התלות של Google Play Services עבור play-services-code-scanner SDK לקובץ ה-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>
   

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

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

סריקת קוד

מבצעים את השלבים הבאים כדי לסרוק ברקוד.

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

   אם ידוע לך אילו פורמטים של ברקוד אתה מצפה לקרוא, תוכל לשפר את המהירות של מזהה הברקוד על ידי הגדרתו כך שיזהה רק פורמטים. לדוגמה, כדי לזהות רק קוד אצטקי וקודי 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();