Android'de Firebase telefon numarası doğrulama hatalarını işleme

Firebase PNV kitaplığına yapılan bir çağrı başarısız olduğunda kitaplık bir FirebasePhoneNumberVerificationException bildirir. Bu sayfada, istisnanın taşıyabileceği her hata kodu, her birinin ne zaman gerçekleştiği ve uygulamanızın bu konuda ne yapması gerektiği listelenir.

Bu sayfada, Firebase PNV entegrasyonunu Android'de Firebase Phone Number Verification kullanmaya başlama bölümünde açıklandığı şekilde yaptığınız varsayılmaktadır.

Hatalar nasıl raporlanır?

• Eşzamansız yöntemler (getVerificationSupportInfo(), getVerifiedPhoneNumber() ve özel akış yöntemleri) bir Task döndürür. Bu kontroller başarısız olduğunda Task, FirebasePhoneNumberVerificationException ile başarısız olur. Bu hata mesajını addOnFailureListener içinde alırsınız.

• enableTestSession() eşzamanlıdır. Doğrudan FirebasePhoneNumberVerificationException atar.

Sorunun ne olduğunu öğrenmek için istisnanın errorCode değerini okuyun. Firebase PNV kodları, FirebasePnvStatusCodes sınıfındaki sabitlerdir. Hata Google Play Hizmetleri'nden kaynaklanıyorsa errorCode, NETWORK_ERROR gibi bir CommonStatusCodes değeri de olabilir.

Desteklenmeyen bir cihaz veya SIM, hata olarak kabul edilmez. getVerificationSupportInfo() başarılı olur ve bu SIM için isSupported() değerini false olarak bildirir. getReason() bunun nedenini açıklar. Desteklenmeyen cihazlar ve SIM'ler bölümüne bakın.

Hata kodları

Test oturumu oluşturma

Bu hatalar enableTestSession() tarafından eşzamanlı olarak oluşturulur.

Doğrulama

Bu hatalar, getVerifiedPhoneNumber() tarafından döndürülen Task işleminin başarısız olmasına neden olur.

Destek kontrolü

getVerificationSupportInfo() tarafından döndürülen Task, yalnızca kontrolün kendisi çalıştırılamazsa başarısız olur. Bu durumda errorCode, Google Play Hizmetleri CommonStatusCodes değeri veya CARRIER_NOT_SUPPORTED olur. Cihazı desteklenmeyen bir cihaz olarak değerlendirin ve SMS gibi başka bir doğrulama yöntemine geçin.

Test oturumu etkinleştirildiğinde getVerificationSupportInfo(), Firebase PNV arka ucuyla iletişime geçmez ve test jetonunun süresi dolmuş olsa bile test SIM'ini her zaman desteklenen olarak bildirir.

Özel akış

getVerifiedPhoneNumber() yerine özel akışı kullanıyorsanız:

• getDigitalCredentialPayload(), PREFLIGHT_CHECK_FAILED ile veya arka uç test jetonunuzu reddederse INVALID_TEST_NUMBER_ID ile başarısız olur.
• exchangeCredentialResponseForPhoneNumber(), INVALID_DIGITAL_CREDENTIAL_RESPONSE ile veya arka uç test jetonunuzu reddederse INVALID_TEST_NUMBER_ID ile başarısız olur.
• Kimlik Bilgisi Yöneticisi'ne yaptığınız çağrı, doğrudan işlediğiniz bir GetCredentialException hatası döndürür.

Desteklenmeyen cihazlar ve SIM'ler

Bir SIM için isSupported(), false olduğunda getReason() aşağıdaki VerificationSupportStatus değerlerinden birini döndürür:

Bu durumlarda, söz konusu SIM için SMS gibi başka bir doğrulama yöntemi kullanın.

Örnek

Aşağıdaki örnekte, tipik bir uygulamanın getVerifiedPhoneNumber() yöntemini çağırırken ayırt etmesi gereken hatalar ele alınmaktadır:

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

Bu örnekte showSmsVerification(), uygulamanızın mevcut telefon numarası doğrulama akışıdır.

Sonraki adımlar

• Her bir sınıf ve sabit hakkında ayrıntılı bilgi için Firebase PNV API referansına bakın.
• Sunucunuzda jetonu doğrulamak için Firebase PNV jetonlarını doğrulama başlıklı makaleyi inceleyin.