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
     ```
   
   Create a new instance of the `FirebasePhoneNumberVerification` class and use
   this instance for all Firebase PNV calls.
   
   ```kotlin
     val fpnv = FirebasePhoneNumberVerification.getInstance()
     ```
   
   Enable a test session using the token you generated in the previous step:
   
   ```kotlin
     fpnv.enableTestSession("COPIED_TOKEN_STRING")
     ```
   
   You must call this method only once on an instance of
       `FirebasePhoneNumberVerification`; subsequent calls will throw an error.
   

टेस्ट टोकन की टीटीएल 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(this@MainActivity)
.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 फ़्लो और बैकएंड इंटिग्रेशन को लागू करने और उसकी जांच करने के बाद, अपने ऐप्लिकेशन को प्रोडक्शन में लाया जा सकता है. इससे, पुष्टि किए गए असली फ़ोन नंबर मिलने लगेंगे. प्रोडक्शन मोड में अपग्रेड करना लेख देखें.