শুরু করুন

এই ডকুমেন্টটিতে অ্যান্ড্রয়েডে নিয়ারবাই মেসেজেস এপিআই (Nearby Messages API) ব্যবহার করে ডেভেলপমেন্ট শুরু করার পদ্ধতি ব্যাখ্যা করা হয়েছে। নিয়ারবাই মেসেজেস এপিআই হলো গুগল প্লে সার্ভিসেস (Google Play services) -এর একটি অংশ।

ধাপ ১: গুগল প্লে পরিষেবাগুলো ডাউনলোড করুন।

নিয়ারবাই মেসেজেস এপিআই (Nearby Messages API) গুগল প্লে সার্ভিসেস ৭.৮.০ বা তার উচ্চতর সংস্করণের অ্যান্ড্রয়েড ডিভাইসগুলিতে উপলব্ধ। অ্যান্ড্রয়েড ২.৩ বা তার উচ্চতর সংস্করণে চালিত যে ডিভাইসগুলিতে গুগল প্লে স্টোর অ্যাপ রয়েছে, সেগুলি স্বয়ংক্রিয়ভাবে গুগল প্লে সার্ভিসেস-এর আপডেট পেয়ে যায়। আপনার ডিভাইসে গুগল প্লে সার্ভিসেস-এর কোন সংস্করণ ইনস্টল করা আছে তা পরীক্ষা করতে, সেটিংস > অ্যাপস > গুগল প্লে সার্ভিসেস- এ যান।

আপনার ডেভেলপমেন্ট হোস্টে গুগল প্লে সার্ভিসের জন্য সর্বশেষ ক্লায়েন্ট লাইব্রেরি আছে কিনা তা নিশ্চিত করুন:

  1. অ্যান্ড্রয়েড এসডিকে ম্যানেজার খুলুন।

  2. Appearance & Behavior > System Settings > Android SDK > SDK Tools- এর অধীনে, নিম্নলিখিত প্যাকেজগুলি ইনস্টল করা আছে কিনা তা নিশ্চিত করুন:

    • গুগল প্লে পরিষেবা
    • গুগল রিপোজিটরি

ধাপ ২: একটি গুগল অ্যাকাউন্ট তৈরি করুন।

Nearby Messages API ব্যবহার করার জন্য আপনার একটি Google অ্যাকাউন্ট প্রয়োজন। এর ফলে আপনি, অর্থাৎ ডেভেলপার, পরবর্তী ধাপে Nearby API সক্রিয় করতে পারবেন (আপনার ব্যবহারকারীদের Google অ্যাকাউন্টের প্রয়োজন হবে না)। যদি আপনার আগে থেকেই একটি অ্যাকাউন্ট থাকে, তাহলে আর কোনো সমস্যা নেই। পরীক্ষার উদ্দেশ্যে আপনার একটি আলাদা Google অ্যাকাউন্টও লাগতে পারে।

ধাপ ৩: একটি এপিআই কী সংগ্রহ করুন।

Android-এর জন্য Google Nearby Messages API সক্রিয় করতে এবং একটি API কী পেতে এই পদক্ষেপগুলি অনুসরণ করুন:

  1. গুগল ডেভেলপার কনসোলে যান।
  2. আপনার আবেদনপত্রটি নিবন্ধন করার জন্য একটি প্রকল্প তৈরি করুন বা নির্বাচন করুন।
  3. এপিআই সক্রিয় করতে ' চালিয়ে যান'- এ ক্লিক করুন।
  4. ক্রেডেনশিয়ালস পেজে, একটি নতুন অ্যান্ড্রয়েড কী তৈরি করুন (এবং এপিআই ক্রেডেনশিয়ালস সেট করুন)।
    দ্রষ্টব্য: আপনার যদি আগে থেকে কোনো অ্যান্ড্রয়েড কী থাকে, তবে আপনি সেই কী-টি ব্যবহার করতে পারেন।
  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. আপনার নতুন অ্যান্ড্রয়েড এপিআই কী আপনার প্রোজেক্টের এপিআই কী-গুলোর তালিকায় দেখা যাচ্ছে। এপিআই কী হলো অক্ষরের একটি স্ট্রিং, যা দেখতে অনেকটা এইরকম: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

আপনার সার্টিফিকেটের SHA1 ফিঙ্গারপ্রিন্ট সংগ্রহ করুন।

আপনার অ্যান্ড্রয়েড অ্যাপের জন্য একটি নতুন এপিআই কী তৈরি করতে, আপনার এপিকে (APK) সাইন করতে ব্যবহৃত সার্টিফিকেটের 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 ফিঙ্গারপ্রিন্ট থাকে।

ধাপ ৪: আপনার প্রজেক্ট কনফিগার করুন

অ্যান্ড্রয়েড স্টুডিওতে নিয়ারবাই মেসেজেস এপিআই (Nearby Messages API)-এর জন্য একটি প্রজেক্ট তৈরি করা সহজ। একটি নতুন প্রজেক্ট তৈরি করতে, 'ক্রিয়েটিং এ প্রজেক্ট' (Creating a Project) অংশে বর্ণিত ধাপগুলো অনুসরণ করুন। অ্যান্ড্রয়েড স্টুডিওতে, আপনার মডিউলের build.gradle ফাইলটি খুলুন এবং গুগল প্লে সার্ভিসেস ক্লায়েন্ট লাইব্রেরিটিকে একটি ডিপেন্ডেন্সি হিসেবে যুক্ত করুন:

apply plugin: 'android'
...

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

তারপর, পূর্ববর্তী ধাপে তৈরি করা API Key দিয়ে আপনার ম্যানিফেস্টটি কনফিগার করুন:

<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-এর জন্য ব্যবহারকারীর সম্মতি প্রয়োজন। যখন প্রথমবার publish বা subscribe চালু করা হয়, Nearby একটি অপ্ট-ইন ডায়ালগ দেখাবে।