এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

শুরু করুন

এই ডকুমেন্টটি ব্যাখ্যা করে যে কীভাবে অ্যান্ড্রয়েডে Nearby Messages API দিয়ে ডেভেলপমেন্ট শুরু করবেন। Nearby Messages API হল Google Play পরিষেবার অংশ।

ধাপ ১: গুগল প্লে পরিষেবা পান

Google Play পরিষেবা 7.8.0 বা তার বেশি ভার্সনের Android ডিভাইসগুলিতে Nearby Messages API উপলব্ধ। Android 2.3 বা তার বেশি ভার্সনের যেসব ডিভাইসে Google Play Store অ্যাপ আছে, সেগুলি স্বয়ংক্রিয়ভাবে Google Play পরিষেবার আপডেট গ্রহণ করে। আপনার ডিভাইসে Google Play পরিষেবার কোন সংস্করণ ইনস্টল করা আছে তা পরীক্ষা করতে, সেটিংস > অ্যাপস > Google Play পরিষেবাগুলিতে যান।

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

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

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

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

ধাপ ৩: একটি API কী পান

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

গুগল ডেভেলপারস কনসোলে যান।
আপনার আবেদন নিবন্ধনের জন্য একটি প্রকল্প তৈরি করুন বা নির্বাচন করুন।
API সক্রিয় করতে Continue-এ ক্লিক করুন।
শংসাপত্র পৃষ্ঠায়, একটি নতুন অ্যান্ড্রয়েড কী তৈরি করুন (এবং API শংসাপত্র সেট করুন)।
দ্রষ্টব্য: যদি আপনার কাছে একটি বিদ্যমান Android কী থাকে, তাহলে আপনি সেই কীটি ব্যবহার করতে পারেন।
ফলস্বরূপ ডায়ালগে, আপনার অ্যাপের 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
```
আপনার নতুন Android API কী আপনার প্রোজেক্টের API কীগুলির তালিকায় প্রদর্শিত হবে। একটি API কী হল অক্ষরের একটি স্ট্রিং, এরকম কিছু:
```
AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
```

আপনার সার্টিফিকেটের SHA1 ফিঙ্গারপ্রিন্ট নিন

আপনার অ্যান্ড্রয়েড অ্যাপের জন্য একটি নতুন API কী তৈরি করতে, আপনার APK সাইন করার জন্য যে সার্টিফিকেট ব্যবহার করেন তার SHA1 ফিঙ্গারপ্রিন্ট প্রয়োজন। বার্তাগুলি কেবলমাত্র একই প্রকল্পের API কী দিয়ে সাইন করা অ্যাপগুলির মধ্যে আদান-প্রদান করা যেতে পারে।

এই আঙুলের ছাপ পেতে:

আপনার কীস্টোরের অবস্থান খুঁজুন।
টার্মিনালে, JDK থেকে keytool ইউটিলিটি চালান। উদাহরণস্বরূপ, যদি আপনি `debug` keystore ব্যবহার করেন:

$ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

দ্রষ্টব্য: ডিবাগ কীস্টোরের জন্য, পাসওয়ার্ডটি android । Mac OS এবং Linux-এ, ডিবাগ কীস্টোরটি সাধারণত ~/.android/ debug.keystore এ অবস্থিত। Windows-এ, এটি সাধারণত %USERPROFILE%\ .android\ debug.keystore এ অবস্থিত।

keytool কমান্ডের আউটপুটে সার্টিফিকেটের জন্য SHA1 ফিঙ্গারপ্রিন্ট থাকে।

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

অ্যান্ড্রয়েড স্টুডিও Nearby Messages API-এর জন্য একটি প্রকল্প তৈরি করা সহজ করে তোলে। একটি নতুন প্রকল্প তৈরি করতে একটি প্রকল্প তৈরিতে বর্ণিত পদক্ষেপগুলি অনুসরণ করুন। অ্যান্ড্রয়েড স্টুডিওতে, আপনার মডিউলের জন্য build.gradle ফাইলটি খুলুন এবং Google Play পরিষেবা ক্লায়েন্ট লাইব্রেরিটিকে একটি নির্ভরতা হিসাবে যুক্ত করুন:

apply plugin: 'android'
...

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

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

<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 একটি অপ্ট-ইন ডায়ালগ দেখাবে।