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 (baseados em chip) como uma dica.
Os benefícios de usar a dica de número de telefone incluem:
- Nenhuma outra solicitação de permissão é necessária.
- Elimina a necessidade de o usuário digitar manualmente o número de telefone
- Nenhuma Conta do Google é necessária
- Não está diretamente ligada a fluxos de trabalho de login/inscrição
- Suporte mais amplo para versões do Android em comparação com o preenchimento automático
Antes de começar
Para preparar o app, siga as etapas nas seções a seguir.
Configurar o app
Adicionar o Google Play Services
da API Phone Number Hint aos seus
arquivo de build do Gradle do módulo,
que é comumente app/build.gradle
:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-auth:21.2.0'
}
Como funciona
A API Phone Number Hint usa um PendingIntent
para iniciar o fluxo. Depois que a PendingIntent for iniciada, o usuário será
apresentado com uma interface, listando 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 ao desenvolvedor para
recuperar do Intent
.
![Configurações e interface de dica de número de telefone.](https://developers-dot-devsite-v2-prod.appspot.com/static/identity/phone-number-hint/images/phone_number_hint_ui.png?authuser=9&hl=pt-br)
Criar um objeto GetPhoneNumbeHintIntentRequest
Comece criando um objeto GetPhoneNumberHintIntentRequest
usando o
fornecido GetPhoneNumberHintIntentRequest.Builder()
. Esse objeto de solicitação pode ser usado para conseguir um Intent
e iniciar o
Fluxo de dica de número de telefone.
Kotlin
val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()
Java
GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();
Solicitação de dica de número de telefone
Chame SignInClient.getPhoneNumberHintIntent()
,
transmitindo o objeto GetPhoneNumberHintIntentRequest
anterior,
para recuperar o PendingIntent
e iniciar o fluxo de dica 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
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); });
Como recuperar o número de telefone
Transmita o Intent
para o 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
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); } } });