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

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

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

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

शुरू करने से पहले

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

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

Google Play सेवाओं को, मॉड्यूल की Gradle बिल्ड फ़ाइल में, फ़ोन नंबर हिंट एपीआई के लिए डिपेंडेंसी जोड़ें. आम तौर पर, यह app/build.gradle होता है:

  apply plugin: 'com.android.application'

  ...

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

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

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

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

GetPhoneNumbeHintइंटेंटRequest ऑब्जेक्ट बनाना

दिए गए 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);
              }
          }
  });