Android पर Firebase की फ़ोन नंबर की पुष्टि करने की सुविधा का इस्तेमाल शुरू करना

इस पेज पर, Android ऐप्लिकेशन में Firebase Phone Number Verification का इस्तेमाल शुरू करने का तरीका बताया गया है. इस सुविधा के बारे में सामान्य जानकारी पाने के लिए, खास जानकारी देखें.

इस पेज पर दिए गए चरणों को पूरा करके, उपयोगकर्ता फ़्लो को Firebase PNV के लिए तेज़ी से लागू किया जा सकता है. टेस्टिंग के मकसद से, सिर्फ़ टेस्टिंग के लिए टोकन जनरेट किया जाएगा. इससे नकली फ़ोन नंबर मिलेगा. इस टेस्ट टोकन का इस्तेमाल करके, अपने ऐप्लिकेशन में Firebase PNV जोड़ा जा सकता है. इसके लिए, बिलिंग खाते या असली सिम वाले डिवाइस की ज़रूरत नहीं होगी.

अपने ऐप्लिकेशन में Firebase PNV उपयोगकर्ता अनुभव से संतुष्ट होने के बाद, अपने ऐप्लिकेशन को प्रोडक्शन में लाने के लिए, कुछ और चरण पूरे किए जा सकते हैं.

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

• अगर आपने पहले से ही ऐसा नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें.

• टेस्ट मोड का इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को चलाने वाले डिवाइस को Google सिस्टम सेवाओं के सार्वजनिक बीटा प्रोग्राम में शामिल करना होगा. शामिल होने का तरीका जानने के लिए, लिंक किया गया पेज देखें.

1. अपने ऐप्लिकेशन में Firebase PNV लाइब्रेरी जोड़ना

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.13.0"))

    // Add the dependencies for the Firebase Phone Number Verification libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-pnv")
}

Firebase Android BoM का इस्तेमाल करने पर, आपका ऐप्लिकेशन हमेशा Firebase Android लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल करेगा.

dependencies {
    // Add the dependencies for the Firebase Phone Number Verification libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-pnv:16.1.0")
}

2. टेस्ट मोड में Firebase PNV लाइब्रेरी शुरू करना

1. Firebase कंसोल में, सुरक्षा > फ़ोन की पुष्टि > टेस्टिंग टैब पर जाएं.

2. टोकन जनरेट करें पर क्लिक करें.

3. टेस्ट सेशन का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन में Firebase PNV क्लाइंट शुरू करें:

   Kotlin

   लाइब्रेरी इंपोर्ट करें:

   import com.google.firebase.pnv.FirebasePhoneNumberVerification
   

   FirebasePhoneNumberVerification क्लास का नया इंस्टेंस बनाएं और सभी Firebase PNV कॉल के लिए इस इंस्टेंस का इस्तेमाल करें. getInstance() तरीका, सिंगलटन ऑब्जेक्ट नहीं लौटाता. इसलिए, इसे बनाने के बाद आपको इसे बनाए रखना होगा.

   val fpnv = FirebasePhoneNumberVerification.getInstance(this@MainActivity)
   

   पिछले चरण में जनरेट किए गए टोकन का इस्तेमाल करके, टेस्ट सेशन चालू करें:

   fpnv.enableTestSession("COPIED_TOKEN_STRING")
   

   FirebasePhoneNumberVerification के किसी इंस्टेंस पर, इस तरीके को सिर्फ़ एक बार कॉल किया जा सकता है. इसके बाद किए जाने वाले कॉल से गड़बड़ी होगी.

टेस्ट टोकन की टीटीएल 7 दिन होती है. इसके बाद, टेस्ट सेशन चालू करने के लिए, आपको नया टोकन जनरेट करना होगा. टेस्ट टोकन, असली डिवाइसों और एम्युलेटर पर काम करते हैं. इसलिए, ये आपके ऐप्लिकेशन में UX का प्रोटोटाइप बनाने या CI/CD में टेस्टिंग के लिए सही होते हैं.

3. सुझाया गया: देखें कि Firebase PNV की सुविधा उपलब्ध है या नहीं

यह पता लगाने के लिए कि नंबर डालने का यूज़र इंटरफ़ेस (यूआई) या जानकारी देने वाला यूज़र इंटरफ़ेस (यूआई) कब दिखाना है, यह सुझाव दिया जाता है कि ऐप्लिकेशन लॉन्च होने पर, यह देखा जाए कि डिवाइस और उसका सिम कार्ड, Firebase PNV की सुविधा के साथ काम करता है या नहीं.Firebase PNV यह एक प्री-चेक है. इसके लिए, उपयोगकर्ता की सहमति की ज़रूरत नहीं होती. इस टेस्ट के नतीजे का इस्तेमाल करके, यह तय किया जा सकता है कि Firebase PNV फ़्लो शुरू करना है या फ़ोन नंबर की पुष्टि करने का कोई दूसरा तरीका इस्तेमाल करना है. जैसे, एसएमएस.

डिवाइस की कंपैटिबिलिटी की जांच करने के लिए, getVerificationSupportInfo() तरीके को कॉल करें. टेस्ट सेशन चालू होने पर, यह तरीका आपके प्रोजेक्ट में चालू हर टेस्ट टोकन की सूची लौटाएगा. बाद में, अपने ऐप्लिकेशन को प्रोडक्शन में लाने के बाद, यह तरीका डिवाइस में मौजूद हर सिम के लिए नतीजा लौटाएगा.

// Check all SIMs for support.
fpnv.getVerificationSupportInfo()
  .addOnSuccessListener { results ->
    if (results.any { it.isSupported() }) {
      // At least one SIM is supported; okay to call getVerifiedPhoneNumber
      // (see the next step).
    } else {
      // No SIMs are supported, so fall back to SMS verification.
    }
  }
  .addOnFailureListener { e ->
    // Handle error.
  }

4. पुष्टि करने का फ़्लो शुरू करना

Firebase PNV फ़्लो शुरू करने के लिए, getVerifiedPhoneNumber() तरीके को कॉल करें:

fpnv.getVerifiedPhoneNumber()
  .addOnSuccessListener { result ->
    // In test mode, this phone number will have a valid country code,
    // followed by all zeros.
    val phoneNumber = result.getPhoneNumber()
    val token = result.getToken()

    // Verification successful. Send token to your backend. (See Next Steps.)
  }
  .addOnFailureListener { e ->
    // Handle failures, such as the user declining consent or a network error.
  }

getVerifiedPhoneNumber() तरीका, फ़ोन नंबर की पुष्टि करने का पूरा फ़्लो पूरा करता है. इसमें ये शामिल हैं:

• Android क्रेडेंशियल मैनेजर का इस्तेमाल करके, उपयोगकर्ता की सहमति लेना, ताकि वे अपना फ़ोन नंबर शेयर कर सकें.
• Firebase PNV बैकएंड को अनुरोध भेजना.
• डिवाइस के लिए, पुष्टि किया गया फ़ोन नंबर वाला टोकन लौटाना. प्रोडक्शन ऐप्लिकेशन में, बिलिंग इसी समय होती है.

अगले चरण

• इस पेज पर, एक ही कॉल वाले यूनीफ़ाइड एपीआई का इस्तेमाल करके, Firebase PNV के साथ इंटिग्रेट करने का तरीका बताया गया है. एक ही तरीके को कॉल करने से, पूरा Firebase PNV उपयोगकर्ता फ़्लो मैनेज हो जाता है. इसमें, उपयोगकर्ता की सहमति लेना और Firebase PNV बैकएंड को ज़रूरी नेटवर्क कॉल करना शामिल है. इस तरीके का इस्तेमाल करके, इंटिग्रेशन के चरणों को एक ही तरीके के कॉल तक सीमित किया जा सकता है.

  ज़्यादातर डेवलपर के लिए, इस एपीआई का सुझाव दिया जाता है. हालांकि, अगर आपकी खास ज़रूरतें हैं जो लाइब्रेरी से पूरी नहीं होती हैं, तो कस्टम फ़्लो लागू करने के बारे में जानकारी पाने के लिए, फ़्लो को पसंद के मुताबिक बनाना पेज देखें.Firebase Phone Number Verification

• अगर पुष्टि किए गए फ़ोन नंबर का इस्तेमाल, ऐप्लिकेशन क्लाइंट के बाहर किया जाता है, तो आपको फ़ोन नंबर के बजाय टोकन पास करना चाहिए. इससे, इस्तेमाल करते समय उसकी इंटिग्रिटी की पुष्टि की जा सकती है. टोकन की पुष्टि करना लेख देखें.Firebase PNV

• अपने ऐप्लिकेशन के Firebase PNV फ़्लो और बैकएंड इंटिग्रेशन को लागू करने और उसकी जांच करने के बाद, अपने ऐप्लिकेशन को प्रोडक्शन में लाया जा सकता है, ताकि पुष्टि किए गए असली फ़ोन नंबर मिल सकें. प्रोडक्शन मोड में अपग्रेड करना लेख देखें.