आरंभ करें

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

पहला चरण: Google Play services डाउनलोड करना

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

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

  1. Android SDK Manager खोलें.

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

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

दूसरा चरण: Google खाता बनाना

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

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

Android के लिए Google Nearby Messages API चालू करने के लिए, यह तरीका अपनाएं और एक 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 फ़िंगरप्रिंट की ज़रूरत होगी सर्टिफ़िकेट की ज़रूरी शर्तें पूरी करें. सिर्फ़ मैसेज भेजे जा सकते हैं एक ही प्रोजेक्ट की एपीआई पासकोड से साइन किए गए ऐप्लिकेशन के बीच साइन इन करता है.

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

  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 सेवाओं की क्लाइंट लाइब्रेरी को डिपेंडेंसी के तौर पर जोड़ने के लिए:

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 एक ऑप्ट-इन डायलॉग दिखाएगा.