L'API Phone Hints, une bibliothèque fournie par les services Google Play, permet de présenter facilement les numéros de téléphone (basés sur la carte SIM) d'un utilisateur.
L'utilisation de l'indication de numéro de téléphone présente les avantages suivants:
- Aucune autre demande d'autorisation n'est nécessaire
- Les utilisateurs n'ont plus besoin de saisir manuellement le numéro de téléphone.
- Aucun compte Google n'est nécessaire.
- Pas directement liés aux workflows de connexion/d'inscription
- Meilleure compatibilité avec les versions d'Android par rapport à la saisie automatique
Avant de commencer
Pour préparer votre application, suivez les étapes décrites dans les sections suivantes.
Configurer votre application
Dans votre fichier build.gradle
au niveau du projet, incluez le dépôt Maven de Google dans vos sections buildscript
et allprojects
:
buildscript {
repositories {
google()
mavenCentral()
}
}
allprojects {
repositories {
google()
mavenCentral()
}
}
Ajoutez la dépendance des services Google Play pour l'API Phone Number à votre fichier de compilation Gradle de votre module, qui est généralement app/build.gradle
:
dependencies {
implementation 'com.google.android.gms:play-services-auth:20.2.0'
}
Fonctionnement
L'API Phone Number utilise un PendingIntent
pour lancer le flux. Une fois que l'intent PendingIntent a été lancé, l'utilisateur se voit présenter une interface utilisateur répertoriant tous les numéros de téléphone (basés sur la carte SIM). L'utilisateur peut alors 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 alors mis à la disposition du développeur pour récupérer les données du 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
pour démarrer le parcours d'indication de numéro de téléphone.
Kotlin
val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()
Java
GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();
Demande d'indication de 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'indication de numéro de téléphone.
Kotlin
val phoneNumberHintIntentResultLauncher: ActivityResultLauncher = ... Identity.signInClient(activity) .getPhoneNumberHintIntent(request) .addOnSuccessListener( try { phoneNumberHintIntentResultLauncher.launch(request.getIntentSender()) } 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ération du numéro de téléphone
Transmettez l'Intent
dans SignInClient.getPhoneNumberFromIntent
pour récupérer le numéro de téléphone.
Kotlin
val phoneNumberHintIntentResultLauncher: ActivityResultLauncher = registerForActivityResult(StartActivityForResult()) { result -> try { val phoneNumber = Identity.signInClient(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); } } });