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

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

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

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

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

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

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

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

  apply plugin: 'com.android.application'

  ...

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

यह सुविधा कैसे काम करती है

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

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

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

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

Kotlin

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

Java

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

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

पिछले GetPhoneNumberHintIntentRequest ऑब्जेक्ट को पास करते हुए, SignInClient.getPhoneNumberHintIntent() को कॉल करें और 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);
              }
          }
  });