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 (baseado 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 o número de telefone
- Não é necessário ter uma Conta do Google
- Não vinculado diretamente a fluxos de trabalho de login/inscrição
- Maior suporte a 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
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:20.7.0'
}
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 o número de telefone que gostaria de usar ou cancelar o fluxo.
O número de telefone selecionado será disponibilizado ao desenvolvedor para
extrair do Intent
.

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 dica de número de telefone.
Kotlin
val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()
Java
GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();
Dica sobre solicitação de número de telefone
Chame SignInClient.getPhoneNumberHintIntent()
,
transmitindo o objeto GetPhoneNumberHintIntentRequest
anterior,
para recuperar o PendingIntent
e iniciar o fluxo de dicas 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 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
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); } } });