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 les numéros de téléphone (basés sur la carte SIM) d'un utilisateur en tant qu'indice.

Voici les avantages de l'utilisation de l'indice de numéro de téléphone:

  • Aucune demande d'autorisation supplémentaire n'est requise
  • L'utilisateur n'a plus besoin de saisir manuellement le numéro de téléphone.
  • Aucun compte Google n'est requis.
  • Non directement associé aux flux de connexion ou d'inscription
  • Compatibilité plus étendue avec les versions d'Android par rapport à la saisie automatique

Fonctionnement

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

Interface utilisateur et paramètres de l'invite de numéro de téléphone
Figure 1. UI et paramètres de l'indice de numéro de téléphone

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.4.0'
  }

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 démarrer le flux d'indice de numéro de téléphone.

Kotlin

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

Java

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

Demander un indice de numéro de téléphone

Appelez SignInClient.getPhoneNumberHintIntent(), en transmettant l'objet GetPhoneNumberHintIntentRequest précédent, pour récupérer PendingIntent et lancer le flux d'indice de numéro 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

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ération du 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

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