Podpowiedź dotycząca numeru telefonu

Interfejs Phone Number Hint API to biblioteka oparta na Usługach Google Play, która umożliwia łatwe wyświetlanie numerów telefonów użytkownika (opartych na karcie SIM) jako podpowiedzi.

Korzyści z używania podpowiedzi dotyczących 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 są bezpośrednio powiązane 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 PendingIntent użytkownik zobaczy interfejs z listą wszystkich numerów telefonów (opartych na karcie SIM). Użytkownik może następnie wybrać numer telefonu, którego chce używać, lub anulować proces. Wybrany numer telefonu zostanie udostępniony deweloperowi, który będzie mógł go pobrać z Intent.

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

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

Konfiguracja 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:22.0.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();

Prośba 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);
              }
          }
  });