L'API Phone Number Hint, una libreria basata su Google Play Services, fornisce un modo semplice per mostrare i numeri di telefono di un utente (basati su SIM) come suggerimento.
I vantaggi dell'utilizzo di Phone Number Hint includono:
- Non sono necessarie ulteriori richieste di autorizzazione
- Elimina la necessità per l'utente di digitare manualmente il numero di telefono
- Non è necessario un Account Google
- Non direttamente collegati ai workflow di accesso o registrazione
- Supporto più ampio per le versioni di Android rispetto alla compilazione automatica
Come funziona
L'API Phone Number Hint utilizza un PendingIntent per avviare il flusso. Una volta avviato PendingIntent, all'utente verrà mostrata una UI con l'elenco di tutti i numeri di telefono (basati su SIM). L'utente può quindi scegliere di selezionare un numero di telefono che vuole utilizzare o annullare il flusso.
Il numero di telefono selezionato verrà quindi reso disponibile allo sviluppatore per il recupero da Intent.
Per preparare l'app, completa i passaggi descritti nelle sezioni seguenti.
Configura la tua app
Aggiungi la dipendenza di Google Play Services per l'API Phone Number Hint al file di build Gradle del modulo, che in genere è app/build.gradle:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-auth:22.0.0'
}
Crea un oggetto GetPhoneNumbeHintIntentRequest
Inizia creando un oggetto GetPhoneNumberHintIntentRequest utilizzando il metodo GetPhoneNumberHintIntentRequest.Builder() fornito. Questo oggetto della richiesta può essere utilizzato per ottenere un Intent per avviare il flusso di suggerimento del numero di telefono.
Kotlin
val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()
Java
GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();
Richiesta di suggerimento del numero di telefono
Chiama SignInClient.getPhoneNumberHintIntent(),
passando l'oggetto GetPhoneNumberHintIntentRequest precedente,
per recuperare PendingIntent e avviare il flusso di suggerimento del numero di telefono.
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);
});
Recupero del numero di telefono in corso…
Passa Intent a SignInClient.getPhoneNumberFromIntent per recuperare il numero di telefono.
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);
}
}
});