Phone Number Hint API, biblioteka z Usługami Google Play, umożliwia bezproblemowe wyświetlanie numerów telefonów użytkownika (na podstawie karty SIM).
Zalety korzystania z podpowiedzi dotyczących numeru telefonu:
- Żadne dodatkowe prośby o przyznanie uprawnień nie są potrzebne
- Brak konieczności ręcznego wpisywania numeru telefonu przez użytkownika
- Nie musisz mieć konta Google
- Nie są bezpośrednio powiązane z procesami logowania i logowania
- szersza obsługa wersji Androida w porównaniu z autouzupełnianiem.
Zanim zaczniesz
Aby przygotować aplikację, wykonaj czynności opisane w poniższych sekcjach.
Konfiguracja aplikacji
Dodaj zależność Usługa Google Play od interfejsu Phone Number Hint API do pliku kompilacji Gradle modułu, który zazwyczaj stanowi app/build.gradle
:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-auth:20.5.0'
}
Jak to działa
Interfejs Phone Number Hint API używa PendingIntent
do inicjowania przepływu. Po uruchomieniu funkcji 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żyć, lub anulować ten proces.
Wybrany numer telefonu zostanie potem udostępniony deweloperowi do pobrania z usługi Intent
.

Tworzenie obiektu GetPhoneNumbeHintIntentRequest
Zacznij od utworzenia obiektu GetPhoneNumberHintIntentRequest
, korzystając z podanej metody GetPhoneNumberHintIntentRequest.Builder()
. Ten obiekt żądania może następnie posłużyć do pobrania polecenia Intent
, aby rozpocząć procedurę podpowiedzi dotyczącej numeru telefonu.
Kotlin
val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()
Java
GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();
Prośba o podanie numeru telefonu
Wywołaj SignInClient.getPhoneNumberHintIntent()
, przekazując w poprzednim obiekcie GetPhoneNumberHintIntentRequest
, aby pobrać PendingIntent
w celu zainicjowania przepływu 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
ActivityResultLauncherphoneNumberHintIntentResultLauncher = ... 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); });
Pobieram numer 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
ActivityResultLauncherphoneNumberHintIntentResultLauncher = 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); } } });