शुरू करें

इस दस्तावेज़ में, Android पर Nearby Messages API का इस्तेमाल करके डेवलपमेंट शुरू करने का तरीका बताया गया है. Nearby Messages API, Google Play services का हिस्सा है.

पहला चरण: Google Play services हासिल करना

Nearby Messages API, Android के उन डिवाइसों पर उपलब्ध है जिन पर Google Play services का वर्शन 7.8.0 या उससे नया वर्शन इंस्टॉल हो. Android 2.3 या उसके बाद के वर्शन पर काम करने वाले ऐसे डिवाइसों पर Google Play services के अपडेट अपने-आप इंस्टॉल हो जाते हैं जिन पर Google Play Store ऐप्लिकेशन मौजूद हो. अपने डिवाइस पर Google Play services का कौनसा वर्शन इंस्टॉल है, यह देखने के लिए सेटिंग > ऐप्लिकेशन > Google Play services पर जाएं.

पक्का करें कि आपके डेवलपमेंट होस्ट पर, Google Play services के लिए सबसे नई क्लाइंट लाइब्रेरी मौजूद हो:

  1. Android SDK Manager खोलें.

  2. अपियरेंस ऐंड बिहेवियर > सिस्टम सेटिंग > Android SDK > SDK टूल में जाकर, पक्का करें कि ये पैकेज इंस्टॉल हों:

    • Google Play services
    • Google Repository

दूसरा चरण: Google खाता हासिल करना

Nearby Messages API का इस्तेमाल करने के लिए, आपके पास एक Google खाता होना चाहिए. ऐसा इसलिए, ताकि डेवलपर के तौर पर, अगले चरण में Nearby API को चालू किया जा सके. आपके उपयोगकर्ताओं के पास Google खाता होना ज़रूरी नहीं है. अगर आपके पास पहले से कोई खाता है, तो आप इसे इस्तेमाल करने के लिए तैयार हैं. आपको जांच के लिए, अलग Google खाते की ज़रूरत भी पड़ सकती है.

तीसरा चरण: एपीआई पासकोड हासिल करना

Android के लिए Google Nearby Messages API को चालू करने और एपीआई पासकोड पाने के लिए, यह तरीका अपनाएं:

  1. Google Developers Console पर जाएं.
  2. अपने ऐप्लिकेशन को रजिस्टर करने के लिए, कोई प्रोजेक्ट बनाएं या चुनें.
  3. एपीआई को चालू करने के लिए, जारी रखें पर क्लिक करें.
  4. क्रेडेंशियल पेज पर जाकर, नया Android पासकोड बनाएं. साथ ही, एपीआई क्रेडेंशियल सेट करें.
    ध्यान दें: अगर आपके पास पहले से कोई Android पासकोड है, तो उसका इस्तेमाल किया जा सकता है.
  5. इसके बाद, खुलने वाले डायलॉग में अपने ऐप्लिकेशन का SHA-1 फ़िंगरप्रिंट और पैकेज का नाम डालें. उदाहरण के लिए: 
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
     
    com.example.android.nearbyexample
  6. आपके प्रोजेक्ट के लिए, एपीआई पासकोड की सूची में नया Android एपीआई पासकोड दिखेगा. एपीआई पासकोड, वर्णों की एक स्ट्रिंग होती है. यह कुछ इस तरह दिखती है: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

अपने सर्टिफ़िकेट का SHA1 फ़िंगरप्रिंट हासिल करना

अपने Android ऐप्लिकेशन के लिए नया एपीआई पासकोड बनाने के लिए, आपको उस सर्टिफ़िकेट का SHA1 फ़िंगरप्रिंट चाहिए जिसका इस्तेमाल, अपने APK पर हस्ताक्षर करने के लिए किया जाता है. एक ही प्रोजेक्ट के एपीआई पासकोड से साइन किए गए ऐप्लिकेशन के बीच ही मैसेज भेजे और पाए जा सकते हैं.

यह फ़िंगरप्रिंट हासिल करने के लिए:

  1. अपना कीस्टोर ढूंढें.
  2. टर्मिनल में, JDK से keytool यूटिलिटी चलाएं. उदाहरण के लिए, अगर `debug` कीस्टोर का इस्तेमाल किया जा रहा है, तो:
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

    ध्यान दें: डीबग कीस्टोर के लिए, पासवर्ड है android. Mac OS और Linux पर, डीबग कीस्टोर आम तौर पर पर मौजूद होता है ~/.android/debug.keystore. Windows पर, यह आम तौर पर %USERPROFILE%\.android\debug.keystore पर मौजूद होता है.

  3. keytool कमांड के आउटपुट में, सर्टिफ़िकेट का SHA1 फ़िंगरप्रिंट शामिल होता है.

चौथा चरण: अपना प्रोजेक्ट कॉन्फ़िगर करना

Android Studio की मदद से, Nearby Messages API के लिए आसानी से प्रोजेक्ट बनाया जा सकता है. नया प्रोजेक्ट बनाने के लिए, प्रोजेक्ट बनाना लेख में बताया गया तरीका अपनाएं. Android Studio में, अपने मॉड्यूल के लिए build.gradle फ़ाइल खोलें और Google Play services की क्लाइंट लाइब्रेरी को डिपेंडेंसी के तौर पर जोड़ें:

apply plugin: 'android'
...

dependencies {
    compile 'com.google.android.gms:play-services-nearby:19.3.0'
}

इसके बाद, पिछले चरण में जनरेट किए गए एपीआई पासकोड के साथ अपना मेनिफ़ेस्ट कॉन्फ़िगर करें:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.sample.app" >
    <application ...>
        <meta-data
            android:name="com.google.android.nearby.messages.API_KEY"
            android:value="API_KEY" />
        <activity>
        ...
        </activity>
    </application>
</manifest>

पांचवा चरण: पब्लिश करना और सदस्यता लेना

अपने ऐप्लिकेशन में, Nearby Messages API का इस्तेमाल शुरू करें.

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    mMessageListener = new MessageListener() {
        @Override
        public void onFound(Message message) {
            Log.d(TAG, "Found message: " + new String(message.getContent()));
        }

        @Override
        public void onLost(Message message) {
            Log.d(TAG, "Lost sight of message: " + new String(message.getContent()));
        }
    }

    mMessage = new Message("Hello World".getBytes());
}

@Override
public void onStart() {
    super.onStart();
    ...
    Nearby.getMessagesClient(this).publish(mMessage);
    Nearby.getMessagesClient(this).subscribe(mMessageListener);
}

@Override
public void onStop() {
    Nearby.getMessagesClient(this).unpublish(mMessage);
    Nearby.getMessagesClient(this).unsubscribe(mMessageListener);
    ...
    super.onStop();
}

Nearby Messages API के लिए, उपयोगकर्ता की सहमति ज़रूरी है. जब पहली बार पब्लिश या सदस्यता लेने की सुविधा का इस्तेमाल किया जाता है, तो Nearby, ऑप्ट-इन डायलॉग दिखाता है.