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