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

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

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

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

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

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

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

प्रोजेक्ट-लेवल की build.gradle फ़ाइल में, Google's Maven repository अपने buildscript और allprojects सेक्शन, दोनों में शामिल करें:

buildscript {
  repositories {
    google()
    mavenCentral()
  }
}

allprojects {
  repositories {
    google()
    mavenCentral()
  }
}

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

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

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

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

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

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

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

Kotlin

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

Java

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

फ़ोन नंबर के लिए अनुरोध करना

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

Kotlin

val phoneNumberHintIntentResultLauncher: ActivityResultLauncher = ...

Identity.signInClient(activity)
  .getPhoneNumberHintIntent(request)
  .addOnSuccessListener(
      try {
          phoneNumberHintIntentResultLauncher.launch(request.getIntentSender())
      } 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: ActivityResultLauncher =
  registerForActivityResult(StartActivityForResult()) { result ->
      try {
          val phoneNumber = Identity.signInClient(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);
              }
          }
  });