Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

Android ऐप्लिकेशन में मैसेज (एसएमएस) की मदद से पुष्टि करने का अनुरोध करना

फ़ोन नंबर की अपने-आप पुष्टि होने की सुविधा चालू करने के लिए, आपको पुष्टि करने की प्रोसेस के क्लाइंट और सर्वर, दोनों हिस्सों को लागू करना होगा. इस दस्तावेज़ में, Android ऐप्लिकेशन में क्लाइंट वाले हिस्से को लागू करने का तरीका बताया गया है.

किसी Android ऐप्लिकेशन में फ़ोन नंबर की पुष्टि करने की सुविधा शुरू करने के लिए, आपको पुष्टि करने वाले सर्वर पर फ़ोन नंबर भेजना होगा. इसके बाद, एसएमएस रिट्रीवर एपीआई को कॉल करना होगा, ताकि आपके ऐप्लिकेशन के लिए वन-टाइम कोड वाला एसएमएस मैसेज सुना जा सके. मैसेज मिलने के बाद, पुष्टि की प्रक्रिया पूरी करने के लिए, वन-टाइम कोड को अपने सर्वर पर वापस भेजें.

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

ऐप्लिकेशन के लिए ज़रूरी शर्तें

पक्का करें कि आपके ऐप्लिकेशन की बिल्ड फ़ाइल में इन वैल्यू का इस्तेमाल किया गया हो:

minSdkVersion 19 या इसके बाद का वर्शन
compileSdkVersion 28 या इसके बाद का वर्शन

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

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

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

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

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

dependencies {
  implementation 'com.google.android.gms:play-services-auth:22.0.0'
  implementation 'com.google.android.gms:play-services-auth-api-phone:18.3.1'
}

उपयोगकर्ता का फ़ोन नंबर पाना

अपने ऐप्लिकेशन के लिए, उपयोगकर्ता का फ़ोन नंबर पाने का कोई भी सही तरीका अपनाया जा सकता है. अक्सर, हिंट पिकर का इस्तेमाल करके उपयोगकर्ता को डिवाइस पर सेव किए गए फ़ोन नंबरों में से चुनने के लिए कहना, उपयोगकर्ता को सबसे अच्छा अनुभव देता है. इससे, फ़ोन नंबर को मैन्युअल तरीके से टाइप करने की ज़रूरत नहीं पड़ती. हिंट पिकर का इस्तेमाल करने के लिए:

// Construct a request for phone numbers and show the picker
private void requestHint() {
    HintRequest hintRequest = new HintRequest.Builder()
            .setPhoneNumberIdentifierSupported(true)
            .build();

    PendingIntent intent = Auth.CredentialsApi.getHintPickerIntent(
            apiClient, hintRequest);
    startIntentSenderForResult(intent.getIntentSender(),
            RESOLVE_HINT, null, 0, 0, 0);
}

// Obtain the phone number from the result
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
  super.onActivityResult(requestCode, resultCode, data);
  if (requestCode == RESOLVE_HINT) {
      if (resultCode == RESULT_OK) {
          Credential credential = data.getParcelableExtra(Credential.EXTRA_KEY);
          // credential.getId();  <-- will need to process phone number string
      }
  }
}

एसएमएस वापस पाने की सुविधा शुरू करना

जब आप उपयोगकर्ता के फ़ोन नंबर की पुष्टि करने के लिए तैयार हों, तो SmsRetrieverClient ऑब्जेक्ट का इंस्टेंस पाएं, startSmsRetriever को कॉल करें, और एसएमएस वापस पाने के टास्क में सफलता और गड़बड़ी के बारे में सूचना देने वाले लिसनर अटैच करें:

// Get an instance of SmsRetrieverClient, used to start listening for a matching
// SMS message.
SmsRetrieverClient client = SmsRetriever.getClient(this /* context */);

// Starts SmsRetriever, which waits for ONE matching SMS message until timeout
// (5 minutes). The matching SMS message will be sent using a Broadcast Intent
// with action SmsRetriever#SMS_RETRIEVED_ACTION.
Task<Void> task = client.startSmsRetriever();

// Listen for success/failure of the start Task. If in a background thread, this
// can be made blocking using Tasks.await(task, [timeout]);
task.addOnSuccessListener(new OnSuccessListener<Void>() {
  @Override
  public void onSuccess(Void aVoid) {
    // Successfully started retriever, expect broadcast intent
    // ...
  }
});

task.addOnFailureListener(new OnFailureListener() {
  @Override
  public void onFailure(@NonNull Exception e) {
    // Failed to start retriever, inspect Exception for more details
    // ...
  }
});

एसएमएस पाने की सुविधा, पांच मिनट तक ऐसे एसएमएस का इंतज़ार करती है जिसमें आपके ऐप्लिकेशन की पहचान करने वाली यूनीक स्ट्रिंग शामिल हो.

फ़ोन नंबर को अपने सर्वर पर भेजना

उपयोगकर्ता का फ़ोन नंबर मिलने और एसएमएस मैसेज सुनने की सुविधा चालू करने के बाद, किसी भी तरीके का इस्तेमाल करके उपयोगकर्ता का फ़ोन नंबर अपने पुष्टि करने वाले सर्वर पर भेजें. आम तौर पर, इसके लिए एचटीटीपीएस पोस्ट अनुरोध का इस्तेमाल किया जाता है.

आपका सर्वर, पुष्टि करने के लिए एक मैसेज जनरेट करता है और उसे आपके बताए गए फ़ोन नंबर पर एसएमएस के ज़रिए भेजता है. सर्वर पर एसएमएस से पुष्टि करना देखें.

पुष्टि करने के लिए मैसेज पाना

जब उपयोगकर्ता के डिवाइस पर पुष्टि करने वाला मैसेज मिलता है, तो Play सेवाएं आपके ऐप्लिकेशन पर साफ़ तौर पर SmsRetriever.SMS_RETRIEVED_ACTION इंटेंट ब्रॉडकास्ट करती है. इसमें मैसेज का टेक्स्ट शामिल होता है. पुष्टि करने वाला यह मैसेज पाने के लिए, BroadcastReceiver का इस्तेमाल करें.

BroadcastReceiver के onReceive हैंडलर में, इंटेंट के अतिरिक्त डेटा से पुष्टि करने वाले मैसेज का टेक्स्ट (और वैकल्पिक तौर पर भेजने वाले का पता) पाएं:

/**
  *   BroadcastReceiver to wait for SMS messages. This can be registered either
  *   in the AndroidManifest or at runtime. Filters Intents on
  *   SmsRetriever.SMS_RETRIEVED_ACTION.
  */
public class MySMSBroadcastReceiver extends BroadcastReceiver {

  @Override
  public void onReceive(Context context, Intent intent) {
    if (SmsRetriever.SMS_RETRIEVED_ACTION.equals(intent.getAction())) {
      Bundle extras = intent.getExtras();
      Status status = (Status) extras.get(SmsRetriever.EXTRA_STATUS);

      switch(status.getStatusCode()) {
        case CommonStatusCodes.SUCCESS:
          // (Optional) Get SMS Sender address - only available in
          // GMS version 24.20 onwards, else it will return null
          String senderAddress = extras.getString(SmsRetriever.EXTRA_SMS_ORIGINATING_ADDRESS);
          // Get SMS message contents
          String message = extras.getString(SmsRetriever.EXTRA_SMS_MESSAGE);
          // Extract one-time code from the message and complete verification
          // by sending the code back to your server.
          break;
        case CommonStatusCodes.TIMEOUT:
          // Waiting for SMS timed out (5 minutes)
          // Handle the error ...
          break;
      }
    }
  }
}

इस BroadcastReceiver को रजिस्टर करने के लिए, इनका इस्तेमाल करें:

इंटेंट फ़िल्टर: com.google.android.gms.auth.api.phone.SMS_RETRIEVED (SmsRetriever.SMS_RETRIEVED_ACTION कॉन्स्टेंट की वैल्यू)
अनुमति: com.google.android.gms.auth.api.phone.permission.SEND (SmsRetriever.SEND_PERMISSION कॉन्सटेंट की वैल्यू)

रिसीवर को अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में रजिस्टर किया जा सकता है, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है. इसके अलावा, Context.registerReceiver का इस्तेमाल करके डाइनैमिक तौर पर भी रजिस्टर किया जा सकता है.

<receiver android:name=".MySMSBroadcastReceiver" android:exported="true"
          android:permission="com.google.android.gms.auth.api.phone.permission.SEND">
    <intent-filter>
        <action android:name="com.google.android.gms.auth.api.phone.SMS_RETRIEVED"/>
    </intent-filter>
</receiver>

पुष्टि करने वाले मैसेज में मिले वन-टाइम कोड को अपने सर्वर पर भेजें

अब आपके पास पुष्टि करने वाले मैसेज का टेक्स्ट है. मैसेज से वन-टाइम कोड पाने के लिए, रेगुलर एक्सप्रेशन या किसी अन्य लॉजिक का इस्तेमाल करें. वन-टाइम कोड का फ़ॉर्मैट इस बात पर निर्भर करता है कि आपने उन्हें अपने सर्वर में कैसे लागू किया है.

आखिर में, एक बार इस्तेमाल होने वाले कोड को सुरक्षित कनेक्शन के ज़रिए अपने सर्वर पर भेजें. जब आपके सर्वर को वन-टाइम कोड मिलता है, तो वह रिकॉर्ड करता है कि फ़ोन नंबर की पुष्टि हो गई है.