Podpowiedź dotycząca numeru telefonu

Interfejs Phone Number Hint API, biblioteka oparta na Usługach Google Play, zapewnia łatwy sposób wyświetlania numerów telefonów użytkownika (opartych na karcie SIM) jako podpowiedzi.

Korzyści z używania podpowiedzi dotyczącej numeru telefonu:

  • Nie musisz wysyłać dodatkowych próśb o uprawnienia.
  • Eliminuje konieczność ręcznego wpisywania numeru telefonu przez użytkownika.
  • Nie musisz mieć konta Google.
  • Nie jest bezpośrednio powiązany z procesami logowania i rejestracji.
  • Większa liczba obsługiwanych wersji Androida w porównaniu z autouzupełnianiem

Jak to działa

Interfejs Phone Number Hint API wykorzystuje PendingIntent do rozpoczęcia procesu. Po uruchomieniu obiektu PendingIntent użytkownikowi zostanie wyświetlony interfejs z listą wszystkich numerów telefonów (opartych na karcie SIM). Użytkownik może wtedy wybrać numer telefonu, którego chce użyć, lub anulować proces. Wybrany numer telefonu zostanie udostępniony deweloperowi, który będzie mógł go pobrać z Intent.

Interfejs i ustawienia podpowiedzi dotyczących numeru telefonu.
Rysunek 1. Interfejs i ustawienia podpowiedzi dotyczących numeru telefonu

Aby przygotować aplikację, wykonaj czynności opisane w poniższych sekcjach.

Konfigurowanie aplikacji

Dodaj zależność Usług Google Play do interfejsu Phone Number Hint API do pliku build.gradle modułu. Jest to zwykle app/build.gradle:

  apply plugin: 'com.android.application'

  ...

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

Tworzenie obiektu GetPhoneNumberHintIntentRequest

Zacznij od utworzenia obiektu GetPhoneNumberHintIntentRequest za pomocą podanej metody GetPhoneNumberHintIntentRequest.Builder(). Ten obiekt żądania może być następnie użyty do uzyskania Intent, aby rozpocząć przepływ podpowiedzi dotyczących numeru telefonu.

Kotlin

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

Java

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

Wysyłanie prośby o wskazówkę dotyczącą numeru telefonu

Wywołaj funkcję SignInClient.getPhoneNumberHintIntent(), przekazując poprzedni obiekt GetPhoneNumberHintIntentRequest, aby pobrać obiekt PendingIntent i rozpocząć proces podpowiedzi dotyczącej numeru telefonu.

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

Pobieranie numeru telefonu

Przekaż Intent do SignInClient.getPhoneNumberFromIntent, aby pobrać numer telefonu.

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