רמז למספר טלפון

Phone Number Hint API, ספרייה שמופעלת על ידי Google Play Services, מספק דרך פשוטה להציג את מספרי הטלפון של המשתמשים (המבוססים על כרטיס SIM) כרמז.

בין היתרונות של שימוש ברמז למספר טלפון:

  • אין צורך בבקשות הרשאה נוספות
  • לא צריך להקליד את מספר הטלפון באופן ידני
  • אין צורך בחשבון Google
  • לא קשורה באופן ישיר לתהליכי עבודה של כניסה או הרשמה
  • תמיכה רחבה יותר בגרסאות Android בהשוואה למילוי אוטומטי

לפני שמתחילים

כדי להכין את האפליקציה, צריך לבצע את השלבים בקטעים הבאים.

הגדרת האפליקציה

הוספה של Google Play Services ותלויות ב-Phone Number Hint API קובץ 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.

הגדרות וממשק משתמש לרמז למספר טלפון.
איור 1. הגדרות וממשק משתמש לרמז למספר טלפון

יצירת אובייקט GetPhoneNumbeHintIntentRequest

בשלב הראשון יוצרים אובייקט GetPhoneNumberHintIntentRequest באמצעות סופקו GetPhoneNumberHintIntentRequest.Builder() . לאחר מכן אפשר להשתמש באובייקט הבקשה הזה כדי לקבל Intent ולהתחיל תהליך רמז למספר טלפון.

Kotlin

val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()

Java

GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();

רמז לבקשת מספר טלפון

קוראים לפונקציה SignInClient.getPhoneNumberHintIntent(), מעבירים את האובייקט GetPhoneNumberHintIntentRequest הקודם, כדי לאחזר את PendingIntent כדי להתחיל תהליך של 'רמז למספר טלפון'.

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 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);
  });

אחזור מספר הטלפון

עוברים בתוך 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

ActivityResultLauncher phoneNumberHintIntentResultLauncher =
  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);
              }
          }
  });