Android पर, Firebase की फ़ोन नंबर की पुष्टि करने की सुविधा से जुड़ी गड़बड़ियों को ठीक करना

Firebase PNV लाइब्रेरी को कॉल करने में गड़बड़ी होने पर, लाइब्रेरी FirebasePhoneNumberVerificationException की रिपोर्ट करती है. इस पेज पर, गड़बड़ी के हर कोड की सूची दी गई है. इसमें यह भी बताया गया है कि गड़बड़ी कब होती है और आपके ऐप्लिकेशन को इसके बारे में क्या करना चाहिए.

इस पेज पर यह माना गया है कि आपने Firebase PNV को इंटिग्रेट कर लिया है. इसके बारे में Android पर Firebase Phone Number Verification का इस्तेमाल शुरू करें में बताया गया है.

गड़बड़ियों की रिपोर्ट कैसे की जाती है

• एसिंक्रोनस तरीके (getVerificationSupportInfo(), getVerifiedPhoneNumber(), और कस्टम फ़्लो के तरीके) Task दिखाते हैं. इनके काम न करने पर, Task भी काम नहीं करता. साथ ही, आपको FirebasePhoneNumberVerificationException मिलता है. यह आपको addOnFailureListener में मिलता है.

• enableTestSession() सिंक्रोनस है. यह सीधे तौर पर FirebasePhoneNumberVerificationException दिखाता है.

गड़बड़ी के बारे में जानने के लिए, अपवाद का errorCode पढ़ें. Firebase PNV कोड, FirebasePnvStatusCodes क्लास में कॉन्सटेंट होते हैं. अगर गड़बड़ी Google Play services की वजह से हुई है, तो errorCode, CommonStatusCodes वैल्यू भी हो सकती है, जैसे कि NETWORK_ERROR.

अगर डिवाइस या सिम पर यह सुविधा काम नहीं करती है, तो इसे गड़बड़ी नहीं माना जाता. getVerificationSupportInfo() सफल होता है और उस सिम के लिए isSupported() को false के तौर पर रिपोर्ट करता है. साथ ही, getReason() आपको इसकी वजह बताता है. इस सुविधा के साथ काम न करने वाले डिवाइस और सिम देखें.

गड़बड़ी के कोड

टेस्ट सेशन का सेटअप

ये गड़बड़ियां, enableTestSession() से सिंक्रोनस तरीके से थ्रो की जाती हैं.

पुष्टि

इन गड़बड़ियों की वजह से, getVerifiedPhoneNumber() से मिले Task काम नहीं करते.

यह देखना कि डिवाइस पर Google Play की सेवाएं काम करती हैं या नहीं

getVerificationSupportInfo() से मिला Task सिर्फ़ तब काम नहीं करता, जब जांच खुद नहीं चल पाती. ऐसे में, errorCode या तो Google Play services की CommonStatusCodes वैल्यू है या CARRIER_NOT_SUPPORTED है. डिवाइस को काम न करने वाला मानें और पुष्टि करने के लिए कोई दूसरा तरीका अपनाएं, जैसे कि एसएमएस.

टेस्ट सेशन चालू होने पर, getVerificationSupportInfo(), Firebase PNV बैकएंड से संपर्क नहीं करता. साथ ही, टेस्ट सिम को हमेशा 'इस्तेमाल किया जा सकता है' के तौर पर रिपोर्ट करता है. भले ही, टेस्ट टोकन की समयसीमा खत्म हो गई हो.

कस्टम फ़्लो

अगर getVerifiedPhoneNumber() के बजाय कस्टम फ़्लो का इस्तेमाल किया जाता है, तो:

• getDigitalCredentialPayload(), PREFLIGHT_CHECK_FAILED के साथ काम नहीं करता. इसके अलावा, अगर बैकएंड आपके टेस्ट टोकन को अस्वीकार कर देता है, तो यह INVALID_TEST_NUMBER_ID के साथ काम नहीं करता.
• अगर बैकएंड आपके टेस्ट टोकन को अस्वीकार कर देता है, तो exchangeCredentialResponseForPhoneNumber(), INVALID_DIGITAL_CREDENTIAL_RESPONSE या INVALID_TEST_NUMBER_ID के साथ काम नहीं करता.
• Credential Manager को किए गए आपके कॉल से GetCredentialException मिलता है, जिसे सीधे तौर पर मैनेज किया जाता है.

इन डिवाइसों और सिम के साथ यह ऐप्लिकेशन काम नहीं करता

जब किसी सिम के लिए isSupported(), false होता है, तो getReason() इनमें से कोई एक VerificationSupportStatus वैल्यू दिखाता है:

हर मामले में, उस सिम के लिए पुष्टि करने का कोई दूसरा तरीका इस्तेमाल करें. जैसे, एसएमएस.

उदाहरण

यहां दिए गए उदाहरण में, उन गड़बड़ियों को मैनेज करने का तरीका बताया गया है जिन्हें किसी सामान्य ऐप्लिकेशन को getVerifiedPhoneNumber() को कॉल करते समय अलग करना पड़ता है:

import android.util.Log
// Credential Manager is included with the Firebase PNV library.
import androidx.credentials.exceptions.GetCredentialCancellationException
import com.google.firebase.pnv.FirebasePhoneNumberVerification
import com.google.firebase.pnv.FirebasePhoneNumberVerificationException
import com.google.firebase.pnv.FirebasePnvStatusCodes

private const val TAG = "PhoneVerification"

// In your Activity:
private fun verifyPhoneNumber() {
    FirebasePhoneNumberVerification.getInstance()
        .getVerifiedPhoneNumber(this)
        .addOnSuccessListener { result ->
            // Send result.getToken() to your backend.
        }
        .addOnFailureListener { e -> handleFpnvError(e) }
}

private fun handleFpnvError(e: Exception) {
    if (e !is FirebasePhoneNumberVerificationException) {
        Log.w(TAG, "Firebase PNV failed", e)
        showSmsVerification()
        return
    }
    when (e.errorCode) {
        FirebasePnvStatusCodes.CREDENTIAL_MANAGER_ERROR -> {
            if (e.cause is GetCredentialCancellationException) {
                // The user dismissed the consent screen.
            }
            showSmsVerification()
        }
        FirebasePnvStatusCodes.INVALID_TEST_NUMBER_ID -> {
            // Test mode only: generate a new test token.
            Log.e(TAG, "Firebase PNV test token rejected", e)
        }
        FirebasePnvStatusCodes.ACTIVITY_CONTEXT_REQUIRED -> {
            // App bug: pass an Activity to getVerifiedPhoneNumber().
            Log.e(TAG, "Firebase PNV needs an Activity context", e)
        }
        else -> {
            // Carrier not supported, network errors, and other failures.
            Log.w(TAG, "Firebase PNV failed with error code ${e.errorCode}", e)
            showSmsVerification()
        }
    }
}

इस उदाहरण में, showSmsVerification() आपके ऐप्लिकेशन में फ़ोन नंबर की पुष्टि करने का मौजूदा फ़्लो है.

अगले चरण

• हर क्लास और कॉन्सटैंट के बारे में जानकारी के लिए, Firebase PNV एपीआई रेफ़रंस देखें.
• अपने सर्वर पर टोकन की पुष्टि करने के लिए, Firebase PNV टोकन की पुष्टि करें देखें.