शुरू करें

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

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

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

पक्का करें कि आपके डेवलपमेंट होस्ट पर, Google Play सेवाओं के लिए सबसे नई क्लाइंट लाइब्रेरी है:

  1. Android SDK Manager खोलें.

  2. दिखने का तरीका और व्यवहार > सिस्टम सेटिंग > Android SDK > SDK टूल में जाकर, पक्का करें कि ये पैकेज इंस्टॉल किए गए हैं:

    • Google Play सेवाएं
    • Google डेटा संग्रह स्थान

दूसरा चरण: 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 API कुंजी, आपके प्रोजेक्ट की एपीआई कुंजियों की सूची में दिखेगी. एपीआई पासकोड, वर्णों की एक स्ट्रिंग होती है. यह कुछ इस तरह की होती है: 
    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.1.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 को इस्तेमाल करने के लिए उपयोगकर्ता की सहमति लेना ज़रूरी है. 'पब्लिश करें' या 'सदस्यता लें' सुविधा को पहली बार शुरू करने पर, 'आस-पास' सुविधा ऑप्ट-इन करने का डायलॉग बॉक्स दिखाएगी.