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