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 পরিষেবার কারণে ব্যর্থ হলে, errorCode-এর ভ্যালু CommonStatusCodes হতে পারে, যেমন NETWORK_ERROR।

কাজ করে না এমন ডিভাইস বা সিম কার্ড কোনও সমস্যা নয়। getVerificationSupportInfo() সফল হয় এবং সেই সিমের জন্য isSupported()-কে false হিসেবে রিপোর্ট করে এবং getReason() আপনাকে কারণ জানায়। কাজ করে না এমন ডিভাইস ও সিম দেখুন।

ত্রুটি কোড

টেস্ট সেশন সেট-আপ

এইসব সমস্যা enableTestSession()-এর মাধ্যমে সিঙ্ক্রোনাসভাবে থ্রো করা হয়।

যাচাইকরণ

এইসব সমস্যার কারণে getVerifiedPhoneNumber()-এর পাঠানো Task কাজ করে না।

সহায়তা চেক

getVerificationSupportInfo()-এর মাধ্যমে ফেরত পাঠানো Task তখনই ব্যর্থ হয় যখন চেক নিজেই রান করতে পারে না। সেক্ষেত্রে, errorCode হয় Google Play পরিষেবার 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 API রেফারেন্স দেখুন।
• আপনার সার্ভারে টোকেন যাচাই করতে, Firebase PNV টোকেন যাচাই করুন দেখুন।