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

फ़ोन नंबर हिंट एपीआई, 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.4.1'
  }

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

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

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

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

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

Kotlin

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

Java

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

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

फ़ोन नंबर हिंट फ़्लो शुरू करने के लिए, PendingIntent वापस पाने के लिए, पिछले 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);
              }
          }
  });