Telefon Numarası İpucu

Google Play Hizmetleri tarafından desteklenen bir kitaplık olan Phone Number Hint API, kullanıcının (SIM tabanlı) telefon numaralarını ipucu olarak göstermenin sorunsuz bir yolunu sunar.

Telefon Numarası İpucu'nu kullanmanın avantajları şunlardır:

  • Ek izin isteği gerekmez.
  • Kullanıcının telefon numarasını manuel olarak yazma ihtiyacını ortadan kaldırır.
  • Google Hesabı gerekmez.
  • Oturum açma veya kaydolma iş akışlarıyla doğrudan bağlantılı değildir.
  • Otomatik doldurmaya kıyasla daha fazla Android sürümü desteklenir.

İşleyiş şekli

Phone Number Hint API, akışı başlatmak için PendingIntent kullanır. PendingIntent başlatıldıktan sonra kullanıcıya tüm (SIM tabanlı) telefon numaralarını listeleyen bir kullanıcı arayüzü gösterilir. Kullanıcı daha sonra kullanmak istediği telefon numarasını seçebilir veya akışı iptal edebilir. Seçilen telefon numarası, geliştiricinin Intent üzerinden alabilmesi için kullanılabilir hale getirilir.

Telefon Numarası İpucu kullanıcı arayüzü ve ayarları.
Şekil 1. Telefon Numarası İpucu Kullanıcı Arayüzü ve Ayarları

Uygulamanızı hazırlamak için aşağıdaki bölümlerde yer alan adımları tamamlayın.

Uygulamanızı yapılandırma

Phone Number Hint API için Google Play Hizmetleri bağımlılığını modülünüzün Gradle derleme dosyasına (genellikle app/build.gradle) ekleyin:

  apply plugin: 'com.android.application'

  ...

  dependencies {
    implementation 'com.google.android.gms:play-services-auth:22.0.0'
  }

GetPhoneNumbeHintIntentRequest nesnesi oluşturun.

Sağlanan GetPhoneNumberHintIntentRequest.Builder() yöntemini kullanarak bir GetPhoneNumberHintIntentRequest nesnesi oluşturarak başlayın. Bu istek nesnesi daha sonra Telefon Numarası İpucu akışını başlatmak için Intent almak üzere kullanılabilir.

Kotlin

val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()

Java

GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();

Telefon numarası ipucu isteniyor

Telefon numarası ipucu akışını başlatmak için PendingIntent değerini almak üzere önceki GetPhoneNumberHintIntentRequest nesnesini ileterek SignInClient.getPhoneNumberHintIntent() yöntemini çağırın.

Kotlin

val phoneNumberHintIntentResultLauncher = ...

Identity.getSignInClient(activity)
  .getPhoneNumberHintIntent(request)
  .addOnSuccessListener { result: PendingIntent ->
    try {
      phoneNumberHintIntentResultLauncher.launch(
        IntentSenderRequest.Builder(result).build()
      )
    } catch (e: Exception) {
        Log.e(TAG, "Launching the PendingIntent failed")
    }
  }
  .addOnFailureListener {
      Log.e(TAG, "Phone Number Hint failed")
  }

Java

ActivityResultLauncher<Intent> phoneNumberHintIntentResultLauncher = ...

Identity.getSignInClient(activity)
    .getPhoneNumberHintIntent(request)
    .addOnSuccessListener( result -> {
        try {
            phoneNumberHintIntentResultLauncher.launch(result.getIntentSender());
        } catch(Exception e) {
            Log.e(TAG, "Launching the PendingIntent failed", e);
        }
    })
    .addOnFailureListener(e -> {
        Log.e(TAG, "Phone Number Hint failed", e);
    });

Telefon numarası alınıyor

Telefon numarasını almak için Intent değerini SignInClient.getPhoneNumberFromIntent yöntemine iletin.

Kotlin

val phoneNumberHintIntentResultLauncher =
  registerForActivityResult(ActivityResultContracts.StartIntentSenderForResult()) { result ->
        try {
            val phoneNumber = Identity.getSignInClient(activity).getPhoneNumberFromIntent(result.data)
        } catch(e: Exception) {
            Log.e(TAG, "Phone Number Hint failed")
        }
    }

Java

ActivityResultLauncher<Intent> phoneNumberHintIntentResultLauncher =
    registerForActivityResult(
        new ActivityResultContracts.StartActivityForResult(),
        new ActivityResultCallback<ActivityResult>() {
            @Override
            public void onActivityResult(ActivityResult result) {
                try {
                    String phoneNumber = Identity.getSignInClient(activity).getPhoneNumberFromIntent(result.getData());
                } catch {
                    Log.e(TAG, "Phone Number Hint failed", e);
                }
            }
    });