Dica de número de telefone

A API Phone Number Hint, uma biblioteca com tecnologia do Google Play Services, oferece uma maneira simples de mostrar os números de telefone de um usuário (com base no chip) como uma dica.

Os benefícios de usar a dica de número de telefone incluem:

  • Não é necessário pedir mais solicitações de permissão
  • Elimina a necessidade de o usuário digitar manualmente o número de telefone.
  • Não é necessário ter uma Conta do Google.
  • Não estão diretamente vinculados aos fluxos de trabalho de login ou inscrição
  • Suporte mais amplo para versões do Android em comparação com o preenchimento automático

Como funciona

A API Phone Number Hint usa um PendingIntent para iniciar o fluxo. Depois que a PendingIntent for iniciada, o usuário vai ver uma interface com todos os números de telefone (baseados em chip). O usuário pode selecionar um número de telefone que gostaria de usar ou cancelar o fluxo. O número de telefone selecionado será disponibilizado para o desenvolvedor recuperar do Intent.

Interface e configurações de sugestão de número de telefone.
Figura 1. Interface e configurações da dica de número de telefone

Para preparar o app, siga as etapas nas seções a seguir.

Configurar o app

Adicione a dependência do Google Play Services para a API Phone Number Hint ao arquivo de build do Gradle do seu módulo, que geralmente é app/build.gradle:

  apply plugin: 'com.android.application'

  ...

  dependencies {
    implementation 'com.google.android.gms:play-services-auth:22.0.0'
  }

Criar um objeto GetPhoneNumbeHintIntentRequest

Comece criando um objeto GetPhoneNumberHintIntentRequest usando o método GetPhoneNumberHintIntentRequest.Builder() fornecido. Esse objeto de solicitação pode ser usado para receber um Intent e iniciar o fluxo de sugestão de número de telefone.

Kotlin

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

Java

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

Solicitando dica de número de telefone

Chame SignInClient.getPhoneNumberHintIntent(), transmitindo o objeto GetPhoneNumberHintIntentRequest anterior, para recuperar o PendingIntent e iniciar o fluxo de sugestão de número de telefone.

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

Acessando o número de telefone

Transmita o Intent para SignInClient.getPhoneNumberFromIntent para recuperar o número de telefone.

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<Intent> phoneNumberHintIntentResultLauncher =
    registerForActivityResult(
        new ActivityResultContracts.StartActivityForResult(),
        new ActivityResultCallback<ActivityResult>() {
            @Override
            public void onActivityResult(ActivityResult result) {
                try {
                    String phoneNumber = Identity.getSignInClient(activity).getPhoneNumberFromIntent(result.getData());
                } catch {
                    Log.e(TAG, "Phone Number Hint failed", e);
                }
            }
    });