Indication du numéro de téléphone

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

L'API Phone Number Hint, une bibliothèque fournie par les services Google Play, offre un moyen simple d'afficher les numéros de téléphone des utilisateurs (basés sur la carte SIM) sous forme d'indices.

Voici quelques-uns des avantages de l'utilisation des indices de numéro de téléphone:

  • Aucune demande d'autorisation supplémentaire n'est nécessaire
  • L'utilisateur n'a plus besoin de saisir manuellement le numéro de téléphone.
  • Aucun compte Google n'est nécessaire
  • Pas directement liée 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.4.0'
  }

Comment ça marche ?

L'API Phone Number utilise un PendingIntent pour lancer le flux. Une fois l'attente "PendingIntent" lancée, une interface utilisateur s'affiche. Elle liste tous les numéros de téléphone (basés sur la carte SIM). L'utilisateur peut ensuite sélectionner 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 qu'il puisse le récupérer depuis la Intent.

Paramètres et UI de numéro de téléphone.
Figure 1. Paramètres et UI de numéro de téléphone

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 d'indication du numéro de téléphone.

Kotlin

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

Java

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

Demande d'indicateur 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 parcours de l'indicateur 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);
              }
          }
  });