La API de Phone Number Hint, una biblioteca con la tecnología de los Servicios de Google Play, proporciona una manera sencilla de mostrar los números de teléfono de un usuario (basado en SIM) como una sugerencia.
Los beneficios de usar la sugerencia de número de teléfono incluyen los siguientes:
- No se necesitan solicitudes de permiso adicionales.
- Elimina la necesidad de que el usuario escriba manualmente el número de teléfono.
- No se necesita una Cuenta de Google
- No está directamente vinculado a los flujos de trabajo de acceso y acceso.
- Mayor compatibilidad con las versiones de Android en comparación con Autocompletar
Antes de comenzar
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:21.0.0'
}
Cómo funciona
La API de Phone Number Hint usa un PendingIntent
para iniciar el flujo. Una vez que se haya iniciado PendingIntent, se mostrará una IU al usuario en la que se enumeran todos los números de teléfono (basados en SIM). Luego, el usuario puede elegir seleccionar un número de teléfono que desea usar o cancelar el flujo.
El número de teléfono seleccionado estará disponible para que el desarrollador lo recupere desde Intent
.
Crea un objeto GetPhoneNumbeHintIntentRequest
Para comenzar, crea un objeto GetPhoneNumberHintIntentRequest
con el método GetPhoneNumberHintIntentRequest.Builder()
proporcionado. Este objeto de solicitud se puede usar para obtener un Intent
y así iniciar el flujo de sugerencia de número de teléfono.
Kotlin
val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()
Java
GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();
Solicitando sugerencia de número de teléfono
Llama a SignInClient.getPhoneNumberHintIntent()
y pasa el objeto GetPhoneNumberHintIntentRequest
anterior para recuperar el PendingIntent
e 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
ActivityResultLauncherphoneNumberHintIntentResultLauncher = ... 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); });
Cómo recuperar 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
ActivityResultLauncherphoneNumberHintIntentResultLauncher = 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); } } });