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

L'API Phone Number Hint, une bibliothèque fournie par les services Google Play, offre une manière simple d'afficher les numéros de téléphone (basés sur la carte SIM) d'un utilisateur comme indice.

Voici quelques-uns des avantages qu'offre l'indice 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és aux processus d'inscription/d'inscription
• Compatibilité plus étendue avec les versions d'Android qu'avec 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:21.2.0'
  }

Fonctionnement

L'API Phone Number Hint utilise un élément PendingIntent pour lancer le flux. Une fois le PendingIntent lancé, une interface utilisateur s'affiche, 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 la procédure. Le numéro de téléphone sélectionné sera ensuite mis à la disposition du développeur pour le récupérer à partir de la 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 démarrer le flux Phone Number Hint.

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

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

Indice pour la demande de numéro de téléphone

Appelez SignInClient.getPhoneNumberHintIntent() en transmettant l'objet GetPhoneNumberHintIntentRequest précédent pour récupérer le PendingIntent afin de lancer le flux d'indication de numéro de téléphone.

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

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.

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

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