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

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

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

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

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

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

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

מוסיפים את התלות של Google Play Services ב-Phone Number Hint API בקובץ Gradle של ה-build של המודול, שהוא בדרך כלל app/build.gradle:

  apply plugin: 'com.android.application'

  ...

  dependencies {
    implementation 'com.google.android.gms:play-services-auth:20.7.0'
  }

איך זה עובד

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