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 os seguintes:
- Nenhuma outra solicitação de permissão é necessária
- Elimina a necessidade de o usuário digitar o número de telefone manualmente.
- Nenhuma Conta do Google é necessária.
- Não vinculado diretamente a fluxos de trabalho de login/inscrição
- Compatibilidade mais ampla para as 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:21.0.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 receber
uma interface com todos os números de telefone (baseados em chip). Em seguida, o usuário pode
selecionar um número de telefone que queira 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 de solicitação 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 Intent
para SignInClient.getPhoneNumberFromIntent
a fim de 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); } } });