অ্যান্ড্রয়েডে C++ এর জন্য প্লে গেম পরিষেবাগুলি দিয়ে শুরু করুন৷

Google সাইন-ইন API বন্ধ করার পর, আমরা ২০২৬ সালে গেমস v1 SDK সরিয়ে ফেলছি। ২০২৫ সালের ফেব্রুয়ারির পর, আপনি Google Play তে গেমস v1 SDK-এর সাথে নতুনভাবে সংহত করা শিরোনাম প্রকাশ করতে পারবেন না। আমরা আপনাকে এর পরিবর্তে গেমস v2 SDK ব্যবহার করার পরামর্শ দিচ্ছি।
পূর্ববর্তী গেম v1 ইন্টিগ্রেশন সহ বিদ্যমান শিরোনামগুলি কয়েক বছর ধরে কাজ করলেও, আপনাকে জুন 2025 থেকে v2 তে স্থানান্তরিত হতে উৎসাহিত করা হচ্ছে।
এই নির্দেশিকাটি Play Games Services v1 SDK ব্যবহারের জন্য। Play Games Services v2 এর জন্য C++ SDK এখনও উপলব্ধ নয়।

এই ডেভেলপার গাইড আপনাকে দেখাবে কিভাবে Google Play Game services API ব্যবহার করে এমন একটি C++ গেম Android এ কম্পাইল এবং রান করতে হয়। শুরু করার আগে, নিম্নলিখিত প্রয়োজনীয়তাগুলি ডাউনলোড এবং কনফিগার করুন:

• অ্যান্ড্রয়েড এনডিকে , রিভিশন ১৪ বা তার বেশি।
• অ্যান্ড্রয়েড SDK ভার্সন ১০ বা তার উচ্চতর এবং Eclipse ADT এর সর্বশেষ সংস্করণ ।
• ডিভাইসটি অবশ্যই অ্যান্ড্রয়েড ৪.০ (এপিআই লেভেল ১৪) বা তার বেশি চলমান হতে হবে।
• গুগল প্লে সার্ভিসেস এসডিকে-র সর্বশেষ সংস্করণ।

এই ডেভেলপার গাইডটি অ্যান্ড্রয়েড নেটিভ ডেভেলপমেন্ট কিট (NDK) ব্যবহার করে। যদি আপনি NDK এর সাথে অপরিচিত থাকেন, তাহলে চালিয়ে যাওয়ার আগে NDK ডকুমেন্টেশন এবং নমুনাগুলি দেখুন।

ধাপ ১: আপনার পরিবেশ সেট আপ করুন

1. Android SDK এবং Android NDK ডাউনলোড করুন এবং আপনার মেশিনে এক্সট্র্যাক্ট করুন। আপনার পরিবেশে, SDK_ROOT আপনার Android SDK ফোল্ডারের অবস্থানে এবং NDK_ROOT আপনার Android NDK ফোল্ডারের অবস্থানে সেট করুন।
2. C++ নমুনা গেমগুলি ডাউনলোড করুন। এই ডেভেলপার গাইডটি আপনার মেশিনে নমুনাগুলির অবস্থানকে SAMPLES_DIR হিসাবে উল্লেখ করে।
3. গুগল প্লে গেমস সার্ভিসেস C++ SDK ডাউনলোড করুন। আপনার ডেভেলপমেন্ট মেশিনে SDK এক্সট্র্যাক্ট করুন। আপনার পরিবেশে, gpg-cpp-sdk ডিরেক্টরির উপরে ডিরেক্টরিতে নির্দেশ করার জন্য NDK_MODULE_PATH ভেরিয়েবল সেট করুন। আপনার নিম্নলিখিত ডিরেক্টরি কাঠামো থাকা উচিত:

   NDK_MODULE_PATH/
   gpg-cpp-sdk/

4. Eclipse খুলুন। যদি আপনি ইতিমধ্যেই এটি না করে থাকেন, তাহলে Preferences > Android > NDK এ ক্লিক করে Eclipse-এ NDK কোথায় ইনস্টল করেছেন তা জানান।

5. আপনার Eclipse ওয়ার্কস্পেসে Google Play পরিষেবা লাইব্রেরি প্রকল্পটি আমদানি করুন।

   1. Eclipse-এ, File > Import > Android > Existing Android Code into Workspace এ ক্লিক করুন।
   2. SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib নির্বাচন করুন যেখানে SDK_ROOT হল আপনার Android SDK এর অবস্থান।
   3. Finish এ ক্লিক করুন।

6. আপনার Eclipse কর্মক্ষেত্রে মিনিমালিস্ট নমুনা প্রকল্পটি আমদানি করুন।

   1. Eclipse-এ, File > Import > Android > Existing Android Code into Workspace এ ক্লিক করুন।
   2. SAMPLES_DIR/samples-android/minimalist নির্বাচন করুন।
   3. Finish এ ক্লিক করুন।

7. MinimalistActivity প্রজেক্টে রাইট ক্লিক করুন এবং Properties এ ক্লিক করুন। Android এর অধীনে, Library বিভাগে স্ক্রোল করুন এবং নিশ্চিত করুন যে google-play-services_lib প্রজেক্টটি সঠিকভাবে রেফারেন্স করা হয়েছে। যদি না হয়, তাহলে রেফারেন্সটি সরিয়ে ফেলুন এবং আপনার কর্মক্ষেত্র থেকে আবার যোগ করুন।

Eclipse স্বয়ংক্রিয়ভাবে আপনার প্রকল্পের জাভা এবং অ্যান্ড্রয়েড উৎসগুলি কম্পাইল করবে; তবে, jni ফোল্ডারের নেটিভ কোডটি আলাদাভাবে কম্পাইল করতে হবে। এটি ম্যানুয়ালি করার জন্য, jni ফোল্ডারে নেভিগেট করুন এবং ndk-build চালান। jni ফোল্ডারের ভিতরে কোনও পরিবর্তন করার পরে এটি করতে ভুলবেন না।

আপনার প্রোজেক্টটি এখন কম্পাইল করা উচিত, যদিও এটি এখনও কাজ করবে না। আপনাকে প্রথমে গুগল প্লে কনসোলে আপনার গেমটি কনফিগার করতে হবে।

ধাপ ২: গুগল প্লে কনসোলে গেমটি সেট আপ করুন

Google Play Console-এ আপনার গেমের জন্য একটি এন্ট্রি তৈরি করুন। এটি আপনার অ্যাপ্লিকেশনের জন্য গেম পরিষেবা সক্ষম করে এবং যদি আপনার ইতিমধ্যেই OAuth 2.0 ক্লায়েন্ট আইডি না থাকে তবে একটি তৈরি করে।

1. গুগল প্লে গেমস সার্ভিসেস সেট আপ করা -এ বর্ণিত ধাপগুলি অনুসরণ করে আপনার গেমের জন্য একটি এন্ট্রি তৈরি করুন।
2. AndroidManifest.xml তে, <manifest> ট্যাগের package অ্যাট্রিবিউটটি Google Play Console সেট আপ করার সময় আপনার পছন্দের প্যাকেজ নামে পরিবর্তন করুন। এই পরিবর্তনটি করার পরে (বিশেষ করে জেনারেট করা R ক্লাসে) আপনাকে পুরো প্রকল্প জুড়ে কিছু রেফারেন্স ঠিক করতে হতে পারে।
3. res/values/ids.xml খুলুন এবং সেখানে আপনার অ্যাপ আইডিটি রাখুন। মনে রাখবেন যে অ্যাপ আইডি এবং ক্লায়েন্ট আইডি একই নয়; এটি গুগল প্লে কনসোলের গেমের বিবরণ পৃষ্ঠায় আপনার গেমের নামের পাশে থাকা নম্বর।

ধাপ ৩: নমুনাটি চালান

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

1. নেটিভ কোড কম্পাইল করতে ndk-build চালান।
2. Eclipse-এ, Run > Run As > Android Application-এ ক্লিক করুন এবং আপনার ডিভাইসে নমুনাটি চালান।
3. নমুনাটি খুললে, স্ক্রিনের যেকোনো জায়গায় ট্যাপ করুন। আপনি একটি Google Play Games লোগো দেখতে পাবেন। আপনি যদি আপনার অ্যাপটি সঠিকভাবে কনফিগার করে থাকেন, তাহলে আপনাকে সাইন ইন করতে বলা হবে।

ঐচ্ছিক: Eclipse দিয়ে স্বয়ংক্রিয়ভাবে তৈরি করুন

নিম্নলিখিত ধাপগুলি আপনাকে দেখায় যে কীভাবে jni ফোল্ডারের ফাইলগুলিতে পরিবর্তন করার সময় ndk-build স্বয়ংক্রিয়ভাবে চালানোর জন্য Eclipse কনফিগার করবেন।

1. MinimalistActivity প্রজেক্টে ডান-ক্লিক করুন এবং Properties এ ক্লিক করুন। Properties উইন্ডোতে, Builders প্যানটি নির্বাচন করুন।
2. নতুন বিল্ডার যোগ করতে New এ ক্লিক করুন এবং Program নির্বাচন করুন তারপর OK এ ক্লিক করুন।
3. নাম ক্ষেত্রে, 'NDK বিল্ডার' লিখুন।
4. Location এর অধীনে Browse File System এ ক্লিক করুন এবং NDK_ROOT ডিরেক্টরিতে যান এবং ndk-build কমান্ডটি নির্বাচন করুন।
5. ওয়ার্কিং ডিরেক্টরির অধীনে ব্রাউজ ওয়ার্কস্পেস ক্লিক করুন এবং মিনিমালিস্টঅ্যাক্টিভিটি প্রজেক্ট ফোল্ডারটি নির্বাচন করুন।
6. রিফ্রেশ ট্যাবে ক্লিক করুন। নিশ্চিত করুন যে রিফ্রেশ রিসোর্স অন কমপ্লিশন বক্সটি চেক করা আছে।
7. "স্পেসিফিক রিসোর্স" রেডিও বোতামটি নির্বাচন করুন এবং তারপর "স্পেসিফিক রিসোর্স" এ ক্লিক করুন। ফলস্বরূপ ডায়ালগে, "মিনিম্যালঅ্যাক্টিভিটি" এর অধীনে jni ফোল্ডারটি নির্বাচন করুন।
8. আপনার বিল্ডার তৈরি শেষ করতে প্রয়োগ করুন এবং তারপর ঠিক আছে ক্লিক করুন।

এখন যখনই আপনি jni ফোল্ডারের মধ্যে একটি ফাইল সম্পাদনা করবেন, Eclipse ndk-build চালাবে এবং Eclipse কনসোলে আউটপুট প্রিন্ট করবে।