শুরু করুন

এই দস্তাবেজটি ব্যাখ্যা করে যে কীভাবে Android-এ Nearby Messages API-এর সাথে বিকাশ শুরু করতে হয়৷ Nearby Messages API হল Google Play পরিষেবার অংশ৷

ধাপ 1: Google Play পরিষেবা পান

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

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

  1. অ্যান্ড্রয়েড এসডিকে ম্যানেজার খুলুন।
  2. চেহারা এবং আচরণ > সিস্টেম সেটিংস > Android SDK > SDK টুলের অধীনে, নিশ্চিত করুন যে নিম্নলিখিত প্যাকেজগুলি ইনস্টল করা আছে:

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

ধাপ 2: একটি Google অ্যাকাউন্ট পান

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

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

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

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

আপনার শংসাপত্রের SHA1 আঙ্গুলের ছাপ নিন

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

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

  1. আপনার কীস্টোরের অবস্থান খুঁজুন।
  2. একটি টার্মিনালে, JDK থেকে keytool ইউটিলিটি চালান। উদাহরণস্বরূপ, আপনি যদি `debug` কীস্টোর ব্যবহার করেন:
  3. $ keytool -alias \
    androiddebugkey -keystore \
    ~/.android/debug.keystore -list -v
    

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

  4. keytool কমান্ডের আউটপুটে শংসাপত্রের জন্য SHA1 ফিঙ্গারপ্রিন্ট রয়েছে।

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

Android স্টুডিও 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>

ধাপ 5: প্রকাশ করুন এবং সদস্যতা নিন

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