Sugerencia de número de teléfono

La API de Phone Number Hint, una biblioteca con tecnología de los Servicios de Google Play, proporciona una forma sencilla de mostrar los números de teléfono de un usuario (basados en la SIM) como sugerencia.

Entre los beneficios de usar la sugerencia de número de teléfono, se incluyen los siguientes:

  • No se necesitan solicitudes de permisos adicionales.
  • Elimina la necesidad de que el usuario ingrese manualmente el número de teléfono.
  • No se necesita una Cuenta de Google
  • No están vinculadas directamente a los flujos de trabajo de acceso o registro.
  • Mayor compatibilidad con versiones de Android en comparación con Autocompletar

Cómo funciona

La API de Phone Number Hint utiliza un PendingIntent para iniciar el flujo. Una vez que se haya iniciado el PendingIntent, se le presentará al usuario una IU con una lista de todos los números de teléfono (basados en SIM). Luego, el usuario puede elegir un número de teléfono que quiera usar o cancelar el flujo. Luego, el número de teléfono seleccionado estará disponible para que el desarrollador lo recupere de Intent.

IU y configuración de la sugerencia de número de teléfono
Figura 1: IU y configuración de la sugerencia de número de teléfono

Para preparar tu app, completa los pasos que se indican en las siguientes secciones.

Cómo configurar tu app

Agrega la dependencia de los Servicios de Google Play para la API de Phone Number Hint al archivo de compilación de Gradle de tu módulo, que suele ser app/build.gradle:

  apply plugin: 'com.android.application'

  ...

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

Crea un objeto GetPhoneNumbeHintIntentRequest

Para comenzar, crea un objeto GetPhoneNumberHintIntentRequest con el método GetPhoneNumberHintIntentRequest.Builder() proporcionado. Luego, este objeto de solicitud se puede usar para obtener un Intent que inicie el flujo de sugerencia de número de teléfono.

Kotlin

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

Java

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

Cómo solicitar una sugerencia de número de teléfono

Llama a SignInClient.getPhoneNumberHintIntent() y pasa el objeto GetPhoneNumberHintIntentRequest anterior para recuperar el PendingIntent que iniciará el flujo de sugerencia de número de teléfono.

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

Recuperando el número de teléfono

Pasa el Intent a SignInClient.getPhoneNumberFromIntent para recuperar el número de teléfono.

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