Google कोड स्कैनर (सिर्फ़ Android पर)

Google कोड स्कैनर एपीआई, कोड स्कैन करने के लिए एक पूरा समाधान देता है इसके लिए, आपके ऐप्लिकेशन को कैमरा ऐक्सेस करने की अनुमति की ज़रूरत नहीं होती. ऐसा करने से, उपयोगकर्ता पर कोई असर नहीं पड़ता निजता. ऐसा करने के लिए, कोड को स्कैन करने का काम Google Play services से और आपके ऐप्लिकेशन को सिर्फ़ स्कैन के नतीजे दिखाना (पहला वीडियो). सभी इमेज प्रोसेसिंग, डिवाइस पर होती है और Google नतीजों को सेव नहीं करता है या इमेज डेटा. एपीआई उन कोड फ़ॉर्मैट के साथ काम करता है जो ML किट बारकोड स्कैनिंग API और यह वही Barcode ऑब्जेक्ट है.

यह एपीआई उन ऐप्लिकेशन के लिए सबसे सही है जिन्हें बिना किसी ज़रूरत के आसानी से कोड स्कैन करने की ज़रूरत होती है और कैमरा अनुभव के लिए, 'अनुभव' को चालू करें. लागू करने की कार्रवाई पूरी तरह से Google Play services की मदद से, यह पक्का किया जाता है कि आपके ऐप्लिकेशन के साइज़ पर कम से कम असर पड़े.

वर्शन 16.1.0 और उसके बाद के वर्शन में, Google कोड को अनुमति देने के लिए, अपने-आप ज़ूम होने की सुविधा चालू की जा सकती है इसका इस्तेमाल, स्कैनर से दूर मौजूद बारकोड को अपने-आप स्कैन करने के लिए किया जाता है. टास्क कब शुरू होगा लोग अपने डिवाइस को बारकोड की तरफ़ से देखते हैं. स्कैनर और बारकोड पर ज़ूम इन करें. इससे मैन्युअल तरीके से ज़ूम करने की ज़रूरत नहीं होती इसमें बदलाव करना, बारकोड स्कैन करने की सुविधा को तेज़, ज़्यादा सटीक, और सुलभ बनाना (दूसरा वीडियो देखें).

वीडियो 1. Google कोड स्कैनर इंटिग्रेशन वीडियो 2. अपने-आप ज़ूम होने का इफ़ेक्ट

अगर ज़रूरत के हिसाब से इस्तेमाल के लिए कस्टम यूज़र इंटरफ़ेस (यूआई) देना ज़रूरी है, तो हमारा सुझाव है कि सीधे ML Kit बारकोड स्कैनिंग एपीआई को भी ऐक्सेस कर सकते हैं.

अगर आपको कुछ पूछना है, कोई गड़बड़ी सबमिट करनी है या मदद चाहिए, तो ML Kit कम्यूनिटी पेज.

शुरू करने से पहले

अपने ऐप्लिकेशन को तैयार करने के लिए, नीचे दिए गए सेक्शन में दिए गए चरणों को पूरा करें.

अपना ऐप्लिकेशन कॉन्फ़िगर करें

  1. अपनी टॉप-लेवल settings.gradle फ़ाइल में, इसे शामिल करें Google की Maven रिपॉज़िटरी और के नीचे Maven सेंट्रल रिपॉज़िटरी dependencyResolutionManagement ब्लॉक:

    dependencyResolutionManagement {
      repositories {
        google()
        mavenCentral()
      }
    }
    
  2. play-services-code-scanner के लिए, Google Play services की डिपेंडेंसी जोड़ें SDK टूल की मदद से अपने मॉड्यूल की ग्रेडल बिल्ड फ़ाइल का इस्तेमाल करें, जो आम तौर पर app/build.gradle होती है:

    dependencies {
      implementation 'com.google.android.gms:play-services-code-scanner:16.1.0'
    }
    
  3. आप Google Play services को अपने-आप चालू करने के लिए, अपने ऐप्लिकेशन को कॉन्फ़िगर कर सकते हैं आपका ऐप्लिकेशन इंस्टॉल किए जाने के दौरान, डिवाइस पर स्कैनर मॉड्यूल डाउनलोड करें Play Store.

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

    स्कैनर मॉड्यूल की उपलब्धता और अनुरोध करने की सुविधा भी साफ़ तौर पर देखी जा सकती है Google Play सेवाएं ModuleInstallClient से डाउनलोड करें एपीआई.

    अगर इंस्टॉल के समय मॉड्यूल डाउनलोड करने की सुविधा चालू नहीं की गई है या अश्लील कॉन्टेंट का अनुरोध किया जा सकता है डाउनलोड किया जा सकता है—और किसी अन्य स्कैनर के लिए, स्कैनर मॉड्यूल पहले से इंस्टॉल नहीं किया गया है इस्तेमाल का उदाहरण—Google Play services सबसे पहले, स्कैनर मॉड्यूल को डाउनलोड करता है कितना समय लगेगा.

कोड स्कैन करें

बारकोड स्कैन करने के लिए नीचे दिया गया तरीका अपनाएं.

  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();