Phone Number Hint API, ספרייה שמופעלת על ידי Google Play Services, מאפשר להציג בצורה חלקה את מספרי הטלפון (שמבוססים על כרטיס SIM) של המשתמשים כרמז.
בין היתרונות של שימוש ברמז למספר טלפון:
- אין צורך בבקשות הרשאה נוספות
- לא צריך להקליד את מספר הטלפון באופן ידני
- אין צורך בחשבון Google
- לא קשורה באופן ישיר לתהליכי עבודה של כניסה או הרשמה
- תמיכה רחבה יותר בגרסאות Android בהשוואה למילוי אוטומטי
לפני שמתחילים
כדי להכין את האפליקציה, צריך לבצע את השלבים בקטעים הבאים.
הגדרת האפליקציה
מוסיפים את התלות של Google Play Services עבור Phone Number Hint API לקובץ ה-build של Gradle של המודול, שבדרך כלל הוא app/build.gradle
:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-auth:21.2.0'
}
איך זה עובד
כדי להתחיל את התהליך, ב-Phone Number Hint API משתמשים ב-PendingIntent
. לאחר הפעלת PendingIntent, למשתמש יוצג ממשק משתמש שבו מפורטים כל מספרי הטלפון (מבוססי SIM). ואז המשתמשים יכולים לבחור מספר טלפון שבו הם רוצים להשתמש או לבטל את התהליך.
מספר הטלפון שנבחר יהיה זמין למפתח
לאחזור מ-Intent
.
יצירת אובייקט GetPhoneNumbeHintIntentRequest
מתחילים ביצירת אובייקט GetPhoneNumberHintIntentRequest
באמצעות ה-method GetPhoneNumberHintIntentRequest.Builder()
שסופקה. לאחר מכן אפשר להשתמש באובייקט הבקשה הזה כדי לקבל Intent
כדי להתחיל את התהליך Phone Number Hint.
Kotlin
val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()
Java
GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();
רמז לבקשת מספר טלפון
קוראים ל-SignInClient.getPhoneNumberHintIntent()
, שמעבירים באובייקט GetPhoneNumberHintIntentRequest
הקודם, כדי לאחזר את ה-PendingIntent
כדי להתחיל את התהליך Phone Number Hint.
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); });
אחזור מספר הטלפון
מעבירים את Intent
אל SignInClient.getPhoneNumberFromIntent
כדי לאחזר את מספר הטלפון.
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); } } });