ماسح رموز 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();