Google Play Hizmetleri tarafından desteklenen bir kitaplık olan Phone Number Hint API, kullanıcının (SIM tabanlı) telefon numaralarını ipucu olarak göstermenin sorunsuz bir yolunu sunar.
Telefon Numarası İpucu'nu kullanmanın avantajları şunlardır:
- Ek izin isteği gerekmez.
- Kullanıcının telefon numarasını manuel olarak yazma ihtiyacını ortadan kaldırır.
- Google Hesabı gerekmez.
- Oturum açma veya kaydolma iş akışlarıyla doğrudan bağlantılı değildir.
- Otomatik doldurmaya kıyasla daha fazla Android sürümü desteklenir.
İşleyiş şekli
Phone Number Hint API, akışı başlatmak için PendingIntent kullanır. PendingIntent başlatıldıktan sonra kullanıcıya tüm (SIM tabanlı) telefon numaralarını listeleyen bir kullanıcı arayüzü gösterilir. Kullanıcı daha sonra kullanmak istediği telefon numarasını seçebilir veya akışı iptal edebilir.
Seçilen telefon numarası, geliştiricinin Intent üzerinden alabilmesi için kullanılabilir hale getirilir.
Uygulamanızı hazırlamak için aşağıdaki bölümlerde yer alan adımları tamamlayın.
Uygulamanızı yapılandırma
Phone Number Hint API için Google Play Hizmetleri bağımlılığını modülünüzün Gradle derleme dosyasına (genellikle app/build.gradle) ekleyin:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-auth:22.0.0'
}
GetPhoneNumbeHintIntentRequest nesnesi oluşturun.
Sağlanan GetPhoneNumberHintIntentRequest.Builder() yöntemini kullanarak bir GetPhoneNumberHintIntentRequest nesnesi oluşturarak başlayın. Bu istek nesnesi daha sonra Telefon Numarası İpucu akışını başlatmak için Intent almak üzere kullanılabilir.
Kotlin
val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()
Java
GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();
Telefon numarası ipucu isteniyor
Telefon numarası ipucu akışını başlatmak için PendingIntent değerini almak üzere önceki GetPhoneNumberHintIntentRequest nesnesini ileterek SignInClient.getPhoneNumberHintIntent() yöntemini çağırın.
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);
});
Telefon numarası alınıyor
Telefon numarasını almak için Intent değerini SignInClient.getPhoneNumberFromIntent yöntemine iletin.
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);
}
}
});