با Play Games Services for Android شروع کنید

پس از منسوخ شدن رابط برنامه‌نویسی کاربردی ورود گوگل (Google Sign-In API)، ما در سال ۲۰۲۶ کیت توسعه نرم‌افزاری بازی‌ها نسخه ۱ (games v1 SDK) را حذف خواهیم کرد. پس از فوریه ۲۰۲۵، شما قادر به انتشار عناوینی که به تازگی با کیت توسعه نرم‌افزاری بازی‌ها نسخه ۱ (games v1 SDK) ادغام شده‌اند، در گوگل پلی نخواهید بود. توصیه می‌کنیم به جای آن از کیت توسعه نرم‌افزاری بازی‌ها نسخه ۲ (games v2 SDK) استفاده کنید.
در حالی که عناوین موجود با بازی‌های قبلی نسخه ۱ ادغام‌شده تا چند سال دیگر به کار خود ادامه می‌دهند، توصیه می‌شود از ژوئن ۲۰۲۵ به نسخه ۲ مهاجرت کنید .
این راهنما برای استفاده از SDK نسخه ۱ سرویس بازی‌های Play Games Services است. برای اطلاعات بیشتر در مورد آخرین نسخه SDK، به مستندات نسخه ۲ مراجعه کنید.

به توسعه بازی‌های اندروید با سرویس‌های بازی‌های گوگل پلی خوش آمدید!

کیت توسعه نرم‌افزاری Play Games، سرویس‌های بازی‌های گوگل پلی را برای پلتفرم‌های مختلف ارائه می‌دهد که به شما امکان می‌دهد به راحتی ویژگی‌های بازی‌های محبوب مانند دستاوردها، جدول امتیازات و بازی‌های ذخیره‌شده را در بازی‌های تبلت و موبایل خود ادغام کنید.

این آموزش شما را راهنمایی می‌کند تا یک برنامه بازی نمونه برای اندروید نصب کنید و به سرعت شروع به ساخت بازی اندروید خود کنید. برنامه نمونه چالش تایپ اعداد نشان می‌دهد که چگونه می‌توانید دستاوردها و جدول امتیازات را در بازی خود ادغام کنید.

قبل از اینکه شروع کنی

برای آماده‌سازی برنامه خود، مراحل بخش‌های زیر را تکمیل کنید.

پیش‌نیازهای برنامه

مطمئن شوید که فایل ساخت برنامه شما از مقادیر زیر استفاده می‌کند:

• یک minSdkVersion از 19 یا بالاتر
• یک compileSdkVersion با 28 یا بالاتر

بازی خود را در کنسول گوگل پلی تنظیم کنید

کنسول گوگل پلی جایی است که شما سرویس‌های بازی‌های گوگل پلی را برای بازی خود مدیریت می‌کنید و فراداده‌ها را برای تأیید و احراز هویت بازی خود پیکربندی می‌کنید. برای اطلاعات بیشتر، به راه‌اندازی سرویس‌های بازی‌های گوگل پلی مراجعه کنید.

برنامه خود را پیکربندی کنید

در فایل build.gradle در سطح پروژه، مخزن Maven گوگل و مخزن مرکزی Maven را هم در بخش‌های buildscript و هم allprojects خود وارد کنید:

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

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

وابستگی سرویس‌های Google Play برای Play Games SDK را به فایل Gradle build ماژول خود که معمولاً app/build.gradle است، اضافه کنید:

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

نمونه راهنمای برنامه

این آموزش شما را راهنمایی می‌کند تا یک برنامه بازی نمونه برای اندروید نصب کنید و به سرعت شروع به ساخت بازی اندروید خود کنید. برنامه نمونه چالش تایپ اعداد نشان می‌دهد که چگونه می‌توانید دستاوردها و جدول امتیازات را در بازی خود ادغام کنید.

مرحله ۱: دانلود برنامه نمونه

برای این راهنمای توسعه‌دهندگان، باید نمونه برنامه اندروید چالش تایپ عدد را دانلود کنید.

برای دانلود و راه‌اندازی برنامه نمونه در اندروید استودیو:

1. نمونه‌های اندروید را از صفحه دانلود نمونه‌ها دانلود کنید.
2. پروژه android-basic-samples را وارد کنید. این پروژه شامل TypeANumber و سایر نمونه‌های بازی اندروید است. برای انجام این کار در اندروید استودیو:
   1. روی فایل > وارد کردن پروژه کلیک کنید.
   2. به پوشه‌ای که android-basic-samples در دستگاه توسعه خود دانلود کرده‌اید، بروید. فایل android-basic-samples/build.gradle را انتخاب کرده و روی تأیید کلیک کنید.
3. در ماژول TypeANumber ، AndroidManifest.xml را باز کنید و نام بسته را از com.google.example.games.tanc به یک نام بسته دلخواه تغییر دهید. نام بسته جدید نباید با com.google ، com.example یا com.android شروع شود.

مرحله ۲: بازی را در کنسول گوگل پلی تنظیم کنید

کنسول گوگل پلی جایی است که شما سرویس‌های بازی‌های گوگل پلی را برای بازی خود مدیریت می‌کنید و فراداده‌ها را برای تأیید و احراز هویت بازی خود پیکربندی می‌کنید.

برای تنظیم بازی نمونه در کنسول گوگل پلی:

1. مرورگر وب خود را به کنسول گوگل پلی هدایت کنید و وارد سیستم شوید. اگر قبلاً در کنسول گوگل پلی ثبت نام نکرده‌اید، از شما خواسته می‌شود که این کار را انجام دهید.
2. برای افزودن بازی خود به کنسول گوگل پلی، این دستورالعمل‌ها را دنبال کنید.
   1. وقتی از شما پرسیده شد که آیا از APIهای گوگل در برنامه خود استفاده می‌کنید، گزینه «من هنوز از هیچ API گوگلی در بازی خود استفاده نمی‌کنم» را انتخاب کنید.
   2. برای استفاده از این راهنمای توسعه‌دهندگان، می‌توانید فرم را با جزئیات بازی خودتان پر کنید. برای راحتی، می‌توانید از آیکون‌ها و تصاویر موجود در صفحه دانلودها استفاده کنید.
3. برای ایجاد یک شناسه کلاینت OAuth 2.0 برای برنامه اندروید خود، این دستورالعمل‌ها را دنبال کنید.
   1. هنگام لینک کردن برنامه اندروید خود، مطمئن شوید که نام دقیق بسته‌ای را که قبلاً هنگام تغییر نام بسته نمونه استفاده کرده‌اید، مشخص کنید.
   2. اگر از قبل گواهی‌نامه‌ی امضا شده و کلید اصلی (keystore) ندارید، می‌توانید از ویزارد Generate Signed APK در اندروید استودیو برای تولید آن استفاده کنید. برای یادگیری نحوه‌ی اجرای ویزارد Generate Signed APK، به بخش امضای برنامه در اندروید استودیو مراجعه کنید.
4. حتماً اطلاعات زیر را برای بعداً ثبت کنید:
   1. شناسه برنامه شما: این رشته‌ای است که فقط از اعداد (معمولاً ۱۲ یا بیشتر) تشکیل شده و در ابتدای شناسه کلاینت شما قرار می‌گیرد.
   2. گواهی امضای شما: توجه داشته باشید که هنگام تنظیم دسترسی به API خود از کدام گواهی استفاده کرده‌اید (گواهینامه‌ای که اثر انگشت SHA1 آن را ارائه کرده‌اید). شما باید هنگام آزمایش یا انتشار برنامه خود از همان گواهی برای امضای برنامه خود استفاده کنید.
5. پیکربندی دستاوردها برای چالش نوع-عدد:
   1. برگه دستاوردها را در کنسول گوگل پلی انتخاب کنید.
   2. دستاوردهای نمونه زیر را اضافه کنید:

      نام	توضیحات	دستورالعمل‌های ویژه
      نخست	نمره‌ای بگیرید که عدد اول باشد.	هیچکدام
      فروتن	درخواست نمره ۰.	هیچکدام
      مغرور نشو بچه	در هر دو حالت، امتیاز ۹۹۹۹ را درخواست کنید.	هیچکدام
      خدای من، تو خیلی باحالی!	امتیاز ۱۳۳۷ را کسب کنید.	این را به یک دستاورد پنهان تبدیل کنید.
      حوصله سر رفته	بازی را 10 بار انجام دهید.	این را به یک دستاورد تدریجی با 10 مرحله برای باز کردن قفل تبدیل کنید.
      واقعاً خیلی حوصله سر رفته	این بازی را ۱۰۰ بار انجام دهید.	این را به یک دستاورد تدریجی با ۱۰۰ مرحله برای باز کردن قفل تبدیل کنید.

   3. شناسه‌های (رشته‌های طولانی الفبایی-عددی) هر دستاوردی را که ایجاد کرده‌اید، ثبت کنید.
   4. دستاوردهایی را پیکربندی کنید که برای بازی شما مناسب باشند. برای کسب اطلاعات بیشتر، به مفاهیم پشت دستاوردها و نحوه پیاده‌سازی دستاوردها در اندروید مراجعه کنید.
6. جدول امتیازات چالش تایپ عدد را پیکربندی کنید:
   1. تب Leaderboards را در کنسول گوگل پلی انتخاب کنید.
   2. دو جدول امتیازات نمونه اضافه کنید: یکی با نام «نمرات آسان» و دیگری با نام «نمرات سخت». هر دو جدول امتیازات باید از قالب‌بندی امتیاز صحیح با صفر رقم اعشار استفاده کنند و نوع مرتب‌سازی آنها « هر چه بزرگتر بهتر» باشد .
   3. شناسه‌ها (رشته‌های طولانی الفبایی-عددی) را برای هر جدول امتیازاتی که ایجاد کرده‌اید، ثبت کنید.
   4. جدول امتیازات را متناسب با بازی خود پیکربندی کنید. برای کسب اطلاعات بیشتر، به مفاهیم پشت جدول امتیازات و نحوه پیاده‌سازی آن در اندروید مراجعه کنید.
7. حساب‌های آزمایشی برای بازی خود اضافه کنید . این مرحله فقط برای برنامه‌هایی که هنوز در کنسول گوگل پلی منتشر نشده‌اند، لازم است. قبل از انتشار برنامه، فقط حساب‌های آزمایشی ذکر شده در کنسول گوگل پلی می‌توانند وارد سیستم شوند. با این حال، پس از انتشار برنامه، همه مجاز به ورود به سیستم هستند.

مرحله ۳: کد خود را تغییر دهید

برای اجرای بازی، باید شناسه برنامه را به عنوان یک منبع در پروژه اندروید خود پیکربندی کنید. همچنین باید فراداده‌های بازی را در AndroidManifest.xml اضافه کنید.

1. res/values/ids.xml را باز کنید و شناسه‌های جایگزین را جایگزین کنید. اگر در حال ساخت یک بازی اندروید از ابتدا هستید، ابتدا باید این فایل را ایجاد کنید.
   1. شناسه برنامه خود را در منبع app_id مشخص کنید.
   2. هر شناسه دستاوردی را که قبلاً ایجاد کرده‌اید، در منبع مربوط به achievement_* مشخص کنید.
   3. شناسه هر جدول امتیازات را که قبلاً ایجاد کرده‌اید، در منبع leaderboard_* مربوطه مشخص کنید.
2. فایل AndroidManifest.xml را باز کنید و نام بسته خود را در ویژگی package عنصر manifest وارد کنید. اگر در حال ساخت یک بازی اندروید از ابتدا هستید، مطمئن شوید که کد زیر را نیز درون عنصر 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 صادر کنید و آن را با همان گواهی‌نامه‌ای که برای راه‌اندازی پروژه در کنسول گوگل پلی استفاده کرده‌اید، امضا کنید. برای صادر کردن یک APK امضا شده در اندروید استودیو، روی Build > Generate Signed APK کلیک کنید.
3. با استفاده از ابزار adb فایل APK امضا شده را روی دستگاه آزمایشی فیزیکی خود نصب کنید. برای یادگیری نحوه نصب برنامه، به بخش «اجرا روی دستگاه» مراجعه کنید.