फ़ोन नंबर का संकेत

Phone Number Hint API, Google Play services की मदद से काम करने वाली एक लाइब्रेरी है. यह उपयोगकर्ता के (सिम पर आधारित) फ़ोन नंबर को हिंट के तौर पर दिखाने का एक आसान तरीका उपलब्ध कराती है.

फ़ोन नंबर हिंट का इस्तेमाल करने के ये फ़ायदे हैं:

  • अनुमति के लिए और अनुरोध करने की ज़रूरत नहीं है
  • उपयोगकर्ता को मैन्युअल तरीके से फ़ोन नंबर टाइप करने की ज़रूरत नहीं पड़ती
  • Google खाते की ज़रूरत नहीं है
  • साइन-इन या साइन-अप वर्कफ़्लो से सीधे तौर पर नहीं जुड़ा है
  • ऑटोमैटिक तरीके से जानकारी भरने की सुविधा के मुकाबले, यह सुविधा Android के ज़्यादा वर्शन पर काम करती है

यह कैसे काम करता है

फ़्लो शुरू करने के लिए, Phone Number Hint API, PendingIntent का इस्तेमाल करता है. PendingIntent लॉन्च होने के बाद, उपयोगकर्ता को एक यूज़र इंटरफ़ेस (यूआई) दिखेगा. इसमें सिम पर आधारित सभी फ़ोन नंबर की सूची होगी. इसके बाद, उपयोगकर्ता वह फ़ोन नंबर चुन सकता है जिसका उसे इस्तेमाल करना है या वह इस प्रोसेस को रद्द कर सकता है. इसके बाद, चुना गया फ़ोन नंबर डेवलपर के लिए उपलब्ध हो जाएगा, ताकि वह Intent से उसे वापस पा सके.

फ़ोन नंबर के सुझाव वाला यूज़र इंटरफ़ेस (यूआई) और सेटिंग.
पहली इमेज. फ़ोन नंबर के सुझाव का यूज़र इंटरफ़ेस (यूआई) और सेटिंग

अपना ऐप्लिकेशन तैयार करने के लिए, यहां दिए गए सेक्शन में बताया गया तरीका अपनाएं.

अपना ऐप्लिकेशन कॉन्फ़िगर करना

Phone Number Hint API के लिए, Google Play services डिपेंडेंसी को अपने मॉड्यूल की Gradle बिल्ड फ़ाइल में जोड़ें. आम तौर पर, यह फ़ाइल app/build.gradle होती है:

  apply plugin: 'com.android.application'

  ...

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

GetPhoneNumbeHintIntentRequest ऑब्जेक्ट बनाना

सबसे पहले, दिए गए GetPhoneNumberHintIntentRequest.Builder() तरीके का इस्तेमाल करके, GetPhoneNumberHintIntentRequest ऑब्जेक्ट बनाएं. इसके बाद, इस अनुरोध ऑब्जेक्ट का इस्तेमाल करके, Intent को हासिल किया जा सकता है. इससे फ़ोन नंबर के सुझाव वाला फ़्लो शुरू किया जा सकता है.

Kotlin

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

Java

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

फ़ोन नंबर के सुझाव का अनुरोध किया जा रहा है

फ़ोन नंबर के सुझाव वाला फ़्लो शुरू करने के लिए, PendingIntent को वापस पाएं. इसके लिए, पिछले GetPhoneNumberHintIntentRequest ऑब्जेक्ट को पास करते हुए, SignInClient.getPhoneNumberHintIntent() को कॉल करें.

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