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

ה-Phone Number Hint API הוא ספרייה שמופעלת על ידי שירותי Google Play ומספקת דרך קלה להציג מספרי טלפון של משתמשים (מבוססי 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:20.4.1'
  }

איך זה עובד

ה-API של מספר הטלפון 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);
              }
          }
  });