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

قبل البدء

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

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

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

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

2. أضِف الاعتمادية على "خدمات Google Play" لحزمة play-services-code-scanner SDK إلى ملف إنشاء 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 و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();