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

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

গুগল প্লে গেমস সার্ভিসেসের মাধ্যমে অ্যান্ড্রয়েড গেম ডেভেলপমেন্টে স্বাগতম!

প্লে গেমস SDK ক্রস-প্ল্যাটফর্ম গুগল প্লে গেমস পরিষেবা প্রদান করে যা আপনাকে আপনার ট্যাবলেট এবং মোবাইল গেমগুলিতে সহজেই জনপ্রিয় গেমিং বৈশিষ্ট্য যেমন অর্জন, লিডারবোর্ড এবং সংরক্ষিত গেমগুলিকে একীভূত করতে দেয়।

এই প্রশিক্ষণটি আপনাকে অ্যান্ড্রয়েডের জন্য একটি নমুনা গেম অ্যাপ্লিকেশন ইনস্টল করতে এবং দ্রুত আপনার নিজস্ব অ্যান্ড্রয়েড গেম তৈরি করতে সাহায্য করবে। টাইপ-এ-নাম্বার চ্যালেঞ্জ নমুনা অ্যাপটি দেখায় যে কীভাবে আপনি আপনার গেমে সাফল্য এবং লিডারবোর্ড একীভূত করতে পারেন।

শুরু করার আগে

আপনার অ্যাপ প্রস্তুত করতে, নিম্নলিখিত বিভাগগুলির ধাপগুলি সম্পূর্ণ করুন।

অ্যাপের পূর্বশর্ত

আপনার অ্যাপের বিল্ড ফাইলে নিম্নলিখিত মানগুলি ব্যবহার করা হয়েছে কিনা তা নিশ্চিত করুন:

  • উচ্চতর 19 এর একটি minSdkVersion
  • 28 বা তার বেশি ভার্সনের একটি compileSdkVersion

গুগল প্লে কনসোলে আপনার গেম সেট আপ করুন

গুগল প্লে কনসোল হল সেই জায়গা যেখানে আপনি আপনার গেমের জন্য গুগল প্লে গেম পরিষেবা পরিচালনা করেন এবং আপনার গেম অনুমোদন এবং প্রমাণীকরণের জন্য মেটাডেটা কনফিগার করেন। আরও তথ্যের জন্য, গুগল প্লে গেম পরিষেবা সেট আপ করা দেখুন।

আপনার অ্যাপ কনফিগার করুন

আপনার প্রোজেক্ট-লেভেল build.gradle ফাইলে, আপনার buildscript এবং allprojects উভয় বিভাগেই Google এর Maven সংগ্রহস্থল এবং Maven কেন্দ্রীয় সংগ্রহস্থল অন্তর্ভুক্ত করুন:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

আপনার মডিউলের Gradle বিল্ড ফাইলে Play Games SDK-এর জন্য Google Play পরিষেবা নির্ভরতা যোগ করুন, যা সাধারণত app/build.gradle হয়:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

নমুনা অ্যাপ গাইড

এই প্রশিক্ষণটি আপনাকে অ্যান্ড্রয়েডের জন্য একটি নমুনা গেম অ্যাপ ইনস্টল করতে এবং দ্রুত আপনার নিজস্ব অ্যান্ড্রয়েড গেম তৈরি করতে সাহায্য করবে। টাইপ-এ-নাম্বার চ্যালেঞ্জ নমুনা অ্যাপটি দেখায় যে কীভাবে আপনি আপনার গেমে সাফল্য এবং লিডারবোর্ড একীভূত করতে পারেন।

ধাপ ১: নমুনা অ্যাপটি ডাউনলোড করুন

এই ডেভেলপার গাইডের জন্য, আপনাকে টাইপ-এ-নম্বর চ্যালেঞ্জ নমুনা অ্যান্ড্রয়েড অ্যাপ্লিকেশনটি ডাউনলোড করতে হবে।

অ্যান্ড্রয়েড স্টুডিওতে নমুনা অ্যাপ্লিকেশনটি ডাউনলোড এবং সেট আপ করতে:

  1. স্যাম্পল ডাউনলোড পৃষ্ঠা থেকে অ্যান্ড্রয়েড স্যাম্পল ডাউনলোড করুন।
  2. android-basic-samples প্রকল্পটি আমদানি করুন। এই প্রকল্পে TypeANumber এবং অন্যান্য Android গেমের নমুনা অন্তর্ভুক্ত রয়েছে। Android Studio-তে এটি করার জন্য:
    1. ফাইল > প্রোজেক্ট আমদানি করুন এ ক্লিক করুন।
    2. আপনার ডেভেলপমেন্ট মেশিনে যে ডিরেক্টরি থেকে android-basic-samples ডাউনলোড করেছেন সেখানে যান। android-basic-samples/build.gradle ফাইলটি নির্বাচন করুন এবং OK এ ক্লিক করুন।
  3. TypeANumber মডিউলে, AndroidManifest.xml খুলুন এবং প্যাকেজের নাম com.google.example.games.tanc থেকে আপনার নিজস্ব একটি ভিন্ন প্যাকেজ নামে পরিবর্তন করুন। নতুন প্যাকেজের নাম com.google , com.example , অথবা com.android দিয়ে শুরু হওয়া উচিত নয়।

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

গুগল প্লে কনসোল হল সেই জায়গা যেখানে আপনি আপনার গেমের জন্য গুগল প্লে গেমস পরিষেবা পরিচালনা করেন এবং আপনার গেম অনুমোদন এবং প্রমাণীকরণের জন্য মেটাডেটা কনফিগার করেন।

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

  1. আপনার ওয়েব ব্রাউজারটি Google Play Console এর দিকে নির্দেশ করুন এবং সাইন ইন করুন। আপনি যদি আগে Google Play Console এর জন্য নিবন্ধন না করে থাকেন, তাহলে আপনাকে তা করতে বলা হবে।
  2. আপনার গেমটি গুগল প্লে কনসোলে যোগ করতে এই নির্দেশাবলী অনুসরণ করুন।
    1. আপনার অ্যাপে Google API ব্যবহার করেন কিনা জিজ্ঞাসা করা হলে, "আমি এখনও আমার গেমে কোনও Google API ব্যবহার করি না" নির্বাচন করুন।
    2. এই ডেভেলপার গাইডের উদ্দেশ্যে, আপনি আপনার নিজস্ব গেমের বিবরণ দিয়ে ফর্মটি পূরণ করতে পারেন। সুবিধার জন্য, আপনি ডাউনলোড পৃষ্ঠায় প্রদত্ত প্লেসহোল্ডার আইকন এবং স্ক্রিনশট ব্যবহার করতে পারেন।
  3. আপনার Android অ্যাপের জন্য একটি OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করতে এই নির্দেশাবলী অনুসরণ করুন।
    1. আপনার অ্যান্ড্রয়েড অ্যাপ লিঙ্ক করার সময়, নমুনা প্যাকেজের নাম পরিবর্তন করার সময় আপনি পূর্বে যে প্যাকেজের নামটি ব্যবহার করেছিলেন তা নির্দিষ্ট করতে ভুলবেন না।
    2. যদি আপনার কাছে ইতিমধ্যেই একটি নতুন কীস্টোর এবং স্বাক্ষরিত সার্টিফিকেট না থাকে, তাহলে আপনি Android Studio-তে Generate Signed APK উইজার্ড ব্যবহার করে একটি নতুন কীস্টোর এবং স্বাক্ষরিত সার্টিফিকেট তৈরি করতে পারেন। Generate Signed APK উইজার্ড কীভাবে চালাবেন তা শিখতে, Android Studio-তে আপনার অ্যাপ সাইন করা দেখুন।
  4. পরবর্তী সময়ের জন্য নিম্নলিখিত তথ্যগুলি রেকর্ড করতে ভুলবেন না:
    1. আপনার অ্যাপ্লিকেশন আইডি: এটি এমন একটি স্ট্রিং যা আপনার ক্লায়েন্ট আইডির শুরুতে শুধুমাত্র সংখ্যা (সাধারণত ১২ বা তার বেশি) নিয়ে গঠিত।
    2. আপনার স্বাক্ষরকারী শংসাপত্র: আপনার API অ্যাক্সেস সেট আপ করার সময় আপনি কোন শংসাপত্রটি ব্যবহার করেছিলেন তা লক্ষ্য করুন (যে শংসাপত্রটির SHA1 ফিঙ্গারপ্রিন্ট আপনি দিয়েছেন)। আপনার অ্যাপটি পরীক্ষা করার সময় বা প্রকাশ করার সময় আপনার অ্যাপটিতে স্বাক্ষর করার জন্য একই শংসাপত্র ব্যবহার করা উচিত।
  5. টাইপ-এ-নম্বর চ্যালেঞ্জের জন্য কৃতিত্ব কনফিগার করুন:
    1. গুগল প্লে কনসোলে "অ্যাচিভমেন্টস" ট্যাবটি নির্বাচন করুন।
    2. নিম্নলিখিত নমুনা কৃতিত্বগুলি যোগ করুন:
      নাম বিবরণ বিশেষ নির্দেশনা
      প্রাইম এমন একটি স্কোর পান যা একটি মৌলিক সংখ্যা। কোনটিই নয়
      নম্র ০ স্কোর করার অনুরোধ করুন। কোনটিই নয়
      অহংকারী হইও না, বাছা। যেকোনো মোডে ৯৯৯৯ স্কোরের অনুরোধ করুন। কোনটিই নয়
      ওহ, উর তে উবের লিট! ১৩৩৭ স্কোর পাবে। এটিকে একটি লুকানো অর্জন করে তুলুন।
      বিরক্ত খেলাটি ১০ বার খেলুন। ১০টি ধাপ আনলক করে এটিকে একটি ক্রমবর্ধমান অর্জন করে তুলুন।
      সত্যিই সত্যিই বিরক্ত খেলাটি ১০০ বার খেলুন। ১০০টি ধাপ আনলক করে এটিকে একটি ক্রমবর্ধমান অর্জন করে তুলুন।
    3. আপনার তৈরি প্রতিটি অর্জনের জন্য আইডি (দীর্ঘ বর্ণানুক্রমিক স্ট্রিং) রেকর্ড করুন।
    4. আপনার গেমের জন্য উপযুক্ত সাফল্যগুলি কনফিগার করুন। আরও জানতে, সাফল্যের পিছনের ধারণাগুলি এবং Android এ সাফল্যগুলি কীভাবে বাস্তবায়ন করবেন তা দেখুন।
  6. টাইপ-এ-নম্বর চ্যালেঞ্জের জন্য লিডারবোর্ড কনফিগার করুন:
    1. গুগল প্লে কনসোলে লিডারবোর্ড ট্যাবটি নির্বাচন করুন।
    2. দুটি নমুনা লিডারবোর্ড যোগ করুন: একটির নাম "সহজ উচ্চ স্কোর" এবং অন্যটির নাম "হার্ড উচ্চ স্কোর"। উভয় লিডারবোর্ডেই 0 দশমিক স্থান সহ পূর্ণসংখ্যা স্কোর বিন্যাস ব্যবহার করা উচিত এবং "Larger" এর ক্রমবিন্যাসের ধরণটি আরও ভালো ।
    3. আপনার তৈরি প্রতিটি লিডারবোর্ডের জন্য আইডি (দীর্ঘ বর্ণমালার স্ট্রিং) রেকর্ড করুন।
    4. আপনার গেমের জন্য উপযুক্ত লিডারবোর্ড কনফিগার করুন। আরও জানতে, লিডারবোর্ডের পিছনের ধারণাগুলি এবং Android এ লিডারবোর্ডগুলি কীভাবে বাস্তবায়ন করবেন তা দেখুন।
  7. আপনার গেমের জন্য টেস্ট অ্যাকাউন্ট যোগ করুন । এই ধাপটি শুধুমাত্র সেইসব অ্যাপের জন্য প্রয়োজন যেগুলো এখনও Google Play Console-এ প্রকাশিত হয়নি। অ্যাপটি প্রকাশের আগে, শুধুমাত্র Google Play Console-এ তালিকাভুক্ত টেস্ট অ্যাকাউন্টগুলি লগ ইন করতে পারবে। তবে, একবার একটি অ্যাপ্লিকেশন প্রকাশিত হয়ে গেলে, সকলেই লগ ইন করতে পারবেন।

ধাপ ৩: আপনার কোড পরিবর্তন করুন

গেমটি চালানোর জন্য, আপনার অ্যান্ড্রয়েড প্রোজেক্টে অ্যাপ্লিকেশন আইডিটিকে একটি রিসোর্স হিসেবে কনফিগার করতে হবে। আপনাকে AndroidManifest.xml এ গেমস মেটাডেটা যোগ করতে হবে।

  1. res/values/ids.xml খুলুন এবং প্লেসহোল্ডার আইডিগুলি প্রতিস্থাপন করুন। আপনি যদি শুরু থেকে একটি অ্যান্ড্রয়েড গেম তৈরি করেন, তাহলে আপনাকে প্রথমে এই ফাইলটি তৈরি করতে হবে।
    1. app_id রিসোর্সে আপনার অ্যাপ্লিকেশন আইডি উল্লেখ করুন।
    2. সংশ্লিষ্ট achievement_* রিসোর্সে আপনার আগে তৈরি করা প্রতিটি achievement ID উল্লেখ করুন।
    3. সংশ্লিষ্ট leaderboard_* রিসোর্সে আপনার আগে তৈরি করা প্রতিটি লিডারবোর্ড আইডি উল্লেখ করুন।
  2. AndroidManifest.xml খুলুন এবং manifest এলিমেন্টের package অ্যাট্রিবিউটে আপনার প্যাকেজের নাম লিখুন। যদি আপনি শুরু থেকে একটি অ্যান্ড্রয়েড গেম তৈরি করেন, তাহলে নিশ্চিত করুন যে আপনি application এলিমেন্টের ভিতরে নিম্নলিখিত কোডটিও যোগ করেছেন: 
    <meta-data android:name="com.google.android.gms.games.APP_ID"
    android:value="@string/app_id" />
<meta-data android:name="com.google.android.gms.version"
   android:value="@integer/google_play_services_version"/>

ধাপ ৪: আপনার খেলাটি পরীক্ষা করুন

আপনার গেমে গুগল প্লে গেমস পরিষেবা সঠিকভাবে কাজ করছে কিনা তা নিশ্চিত করতে, গুগল প্লেতে প্রকাশ করার আগে অ্যাপ্লিকেশনটি পরীক্ষা করে দেখুন।

আপনার শারীরিক পরীক্ষার ডিভাইসে গেমটি চালানোর জন্য:

  1. অ্যাপে লগ ইন করার জন্য আপনি যে পরীক্ষা অ্যাকাউন্টটি ব্যবহার করছেন তা সেট আপ করেছেন কিনা তা যাচাই করুন (ধাপ ২-এ বর্ণিত হিসাবে)।
  2. একটি APK রপ্তানি করুন এবং Google Play Console-এ প্রকল্পটি সেট আপ করার জন্য যে সার্টিফিকেট ব্যবহার করেছিলেন সেই একই সার্টিফিকেট দিয়ে স্বাক্ষর করুন। Android Studio-তে একটি স্বাক্ষরিত APK রপ্তানি করতে, Build > Generate Signed APK এ ক্লিক করুন।
  3. adb টুল ব্যবহার করে আপনার ফিজিক্যাল টেস্ট ডিভাইসে স্বাক্ষরিত APK ইনস্টল করুন। অ্যাপ্লিকেশন ইনস্টল করার পদ্ধতি জানতে, "একটি ডিভাইসে চালানো" দেখুন।