L'API Phone Number Hint, une bibliothèque optimisée par les services Google Play, offre un moyen simple d'afficher les numéros de téléphone d'un utilisateur (basés sur la carte SIM) sous forme d'indice.
Voici quelques-uns des avantages à utiliser les numéros de téléphone:
- Aucune autre demande d'autorisation n'est requise.
- L'utilisateur n'a plus besoin de saisir manuellement son numéro de téléphone.
- Aucun compte Google n'est nécessaire
- Lié directement aux workflows de connexion/inscription
- Compatibilité étendue avec les versions Android par rapport à la saisie automatique
Avant de commencer
Pour préparer votre application, procédez comme indiqué dans les sections suivantes.
Configurer votre application
Ajoutez la dépendance des services Google Play pour l'API Phone Number Hint au fichier de compilation Gradle de votre module, qui est généralement app/build.gradle
:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-auth:20.7.0'
}
Fonctionnement
L'API Phone Number utilise un PendingIntent
pour lancer le flux. Une fois l'Intent en attente lancé, l'utilisateur voit une interface utilisateur répertoriant tous les numéros de téléphone (basés sur la carte SIM). L'utilisateur peut ensuite choisir le numéro de téléphone qu'il souhaite utiliser ou annuler le flux.
Le numéro de téléphone sélectionné sera ensuite rendu disponible pour le développeur à récupérer à partir de Intent
.

Créer un objet GetPhoneNumbeHintIntentRequest
Commencez par créer un objet GetPhoneNumberHintIntentRequest
à l'aide de la méthode GetPhoneNumberHintIntentRequest.Builder()
fournie. Cet objet de requête peut ensuite être utilisé pour obtenir un Intent
afin de lancer le flux de suggestion de numéro de téléphone.
Kotlin
val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()
Java
GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();
Conseil pour demander le numéro de téléphone
Appelez SignInClient.getPhoneNumberHintIntent()
en transmettant l'objet GetPhoneNumberHintIntentRequest
précédent, afin de récupérer le PendingIntent
pour lancer le flux d'indications relatives aux numéros de téléphone.
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); });
Récupérer le numéro de téléphone
Transmettez Intent
à SignInClient.getPhoneNumberFromIntent
pour récupérer le numéro de téléphone.
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); } } });