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

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

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

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

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

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

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

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

  apply plugin: 'com.android.application'

  ...

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

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

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

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

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