Indice pour le numéro de téléphone

L'API Phone Number Hint, une bibliothèque fournie par les services Google Play, permet d'afficher facilement les numéros de téléphone (basés sur la carte SIM) d'un utilisateur sous forme d' indication.

Voici les avantages de l'utilisation de Phone Number Hint :

  • Aucune demande d'autorisation supplémentaire n'est nécessaire.
  • L'utilisateur n'a pas besoin de saisir manuellement son numéro de téléphone.
  • Aucun compte Google n'est requis.
  • N'est pas directement lié aux workflows de connexion ou d'inscription.
  • Prise en charge plus large des versions d'Android que la saisie automatique.

Fonctionnement

L'API Phone Number Hint utilise un PendingIntent pour lancer le flux. Une fois le PendingIntent lancé, une interface utilisateur s'affiche, listant tous les numéros de téléphone (basés sur la carte SIM). L'utilisateur peut alors choisir un numéro de téléphone à utiliser ou annuler le flux. Le numéro de téléphone sélectionné est ensuite mis à la disposition du développeur pour qu'il puisse le récupérer à partir de Intent.

Interface utilisateur et paramètres pour le numéro de téléphone.
Figure 1. Interface utilisateur et paramètres de Phone Number Hint

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:21.5.1'
  }

Créer un objet GetPhoneNumbeHintIntentRequest

Commencez par créer un GetPhoneNumberHintIntentRequest objet à l'aide de la méthode GetPhoneNumberHintIntentRequest.Builder() fournie. Cet objet de requête peut ensuite être utilisé pour obtenir un Intent afin de démarrer le flux Phone Number Hint.

Kotlin

val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()

Java

GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();

Demander Phone Number Hint

Appelez SignInClient.getPhoneNumberHintIntent(), en transmettant l'objet GetPhoneNumberHintIntentRequest précédent, pour récupérer le PendingIntent afin de lancer le flux Phone Number Hint.

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);
  });

Récupérer le numéro de téléphone

Transmettez le 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

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);
              }
          }
  });