'फ़ोन नंबर हिंट एपीआई' 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.2.0'
}
स्पेस कैसे काम करता है
फ़ोन नंबर हिंट एपीआई, फ़्लो शुरू करने के लिए PendingIntent
का इस्तेमाल करता है. PendingIntent के लॉन्च होने के बाद, उपयोगकर्ता को एक यूज़र इंटरफ़ेस (यूआई) दिखाया जाएगा. इसमें सभी (सिम पर आधारित) फ़ोन नंबर दिखेंगे. इसके बाद, उपयोगकर्ता जिस फ़ोन नंबर को इस्तेमाल करना चाहता है
उसे चुन सकता है या फ़्लो को रद्द कर सकता है.
इसके बाद, चुने गए फ़ोन नंबर को डेवलपर को उपलब्ध कराया जाएगा, ताकि वह उसे Intent
से ले सके.
GetPhoneNumbehintIntentRequest ऑब्जेक्ट बनाएं
दिए गए GetPhoneNumberHintIntentRequest.Builder()
तरीके का इस्तेमाल करके, GetPhoneNumberHintIntentRequest
ऑब्जेक्ट बनाकर शुरुआत करें. इसके बाद, अनुरोध के इस ऑब्जेक्ट का इस्तेमाल करके, Intent
पाने के लिए फ़ोन नंबर हिंट फ़्लो शुरू किया जा सकता है.
Kotlin
val request: GetPhoneNumberHintIntentRequest = GetPhoneNumberHintIntentRequest.builder().build()
Java
GetPhoneNumberHintIntentRequest request = GetPhoneNumberHintIntentRequest.builder().build();
अनुरोध करने के लिए फ़ोन नंबर का संकेत
फ़ोन नंबर हिंट फ़्लो शुरू करने के लिए, PendingIntent
को फिर से पाने के लिए, पिछले GetPhoneNumberHintIntentRequest
ऑब्जेक्ट को पास करते हुए 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); } } });