ماسح رموز Google (Android فقط)

قبل البدء

لإعداد تطبيقك، أكمِل الخطوات الواردة في الأقسام التالية.

ضبط إعدادات تطبيقك

1. في ملف settings.gradle ذي المستوى الأعلى، أدرِج مستودع Maven من Google و مستودع Maven المركزي ضمن القسم dependencyResolutionManagement:

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

2. أضِف مصدر الاعتمادية الخاص بخدمات Google Play لحزمة تطوير البرامج (SDK) play-services-code-scanner إلى ملف الإصدار Gradle الخاص بالوحدة، والذي يكون عادةً app/build.gradle:

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

3. يمكنك ضبط تطبيقك على أن تتيح "خدمات Google Play" تنزيل وحدة الفحص تلقائيًا على الجهاز أثناء تثبيت تطبيقك من "متجر Play".

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

   يمكنك أيضًا التحقّق بشكل صريح من توفّر وحدة الفحص وطلب تنزيلها من خلال ModuleInstallClient API في "خدمات Google Play".

   إذا لم تفعِّل عمليات تنزيل الوحدات في وقت التثبيت أو لم تطلب عمليات تنزيل صريحة، ولم تكن وحدة الفحص الضوئي مثبَّتة من قبل لحالة استخدام أخرى، ستنزِّل "خدمات Google Play" وحدة الفحص الضوئي عند استخدامها للمرة الأولى.

مسح رمز ضوئيًا

اتّبِع الخطوات التالية لمسح رمز شريطي ضوئيًا.

1. اختياري: اضبط إعدادات الماسح الضوئي للرموز.

   إذا كنت تعرف تنسيقات الرموز الشريطية التي تتوقّع قراءتها، يمكنك تحسين سرعة أداة رصد الرموز الشريطية من خلال ضبطها على رصد هذه التنسيقات فقط. على سبيل المثال، لاكتشاف رمز Aztec ورموز الاستجابة السريعة فقط، أنشئ عنصر 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();