फ़ोन नंबर हिंट एपीआई, 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
से वापस पाएं.
![फ़ोन नंबर हिंट का यूज़र इंटरफ़ेस (यूआई) और सेटिंग.](https://developers-dot-devsite-v2-prod.appspot.com/static/identity/phone-number-hint/images/phone_number_hint_ui.png?authuser=7&hl=hi)
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
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); } } });