Google কোড স্ক্যানার (শুধুমাত্র Android-এ)

শুরু করার আগে

আপনার অ্যাপ প্রস্তুত করতে, নিম্নলিখিত বিভাগে উল্লেখ করা ধাপগুলি সম্পূর্ণ করুন।

আপনার অ্যাপ কনফিগার করুন

1. আপনার টপ-লেভেল settings.gradle ফাইলে, dependencyResolutionManagement ব্লকের মধ্যে Google-এর Maven রিপোজিটরি এবং Maven সেন্ট্রাল রিপোজিটরি অন্তর্ভুক্ত করুন:

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

2. আপনার মডিউলের Gradle বিল্ড ফাইলে play-services-code-scanner SDK-এর জন্য Google Play পরিষেবার ডিপেন্ডেন্সি যোগ করুন, যা সাধারণত app/build.gradle:

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

3. Play Store থেকে আপনার অ্যাপ ইনস্টল করার সময়, Google Play পরিষেবা যাতে ডিভাইসে স্ক্যানার মডিউল অটোমেটিক ডাউনলোড করে নেয়, তার জন্য আপনি অ্যাপ কনফিগার করতে পারবেন।

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

   এছাড়াও, আপনি স্ক্যানার মডিউলের উপলভ্যতা স্পষ্টভাবে চেক করতে এবং Google Play পরিষেবা ModuleInstallClient API-এর মাধ্যমে ডাউনলোডের অনুরোধ করতে পারবেন।

   আপনি যদি ইনস্টল-টাইম মডিউল ডাউনলোড চালু না করেন বা স্পষ্টভাবে ডাউনলোডের অনুরোধ না করেন—এবং অন্য কোনও ব্যবহারের ক্ষেত্রে স্ক্যানার মডিউল আগে থেকেই ইনস্টল করা না থাকে—তাহলে 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();