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

به توسعه بازی اندروید با خدمات بازی های Google Play خوش آمدید!

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

این آموزش شما را راهنمایی می کند تا یک نمونه برنامه بازی اندروید را نصب کنید و به سرعت شروع به ساخت بازی اندروید خود کنید. برنامه نمونه چالش Type-a-Number نشان می دهد که چگونه می توانید دستاوردها و تابلوهای امتیازات را در بازی خود ادغام کنید.

قبل از شروع

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

پیش نیازهای اپلیکیشن

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

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

بازی خود را در کنسول Google Play تنظیم کنید

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

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

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

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

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

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

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

نمونه راهنمای اپلیکیشن

این آموزش شما را راهنمایی می کند تا یک نمونه برنامه بازی اندروید را نصب کنید و به سرعت شروع به ساخت بازی اندروید خود کنید. برنامه نمونه چالش Type-a-Number نشان می دهد که چگونه می توانید دستاوردها و تابلوهای امتیازات را در بازی خود ادغام کنید.

مرحله 1: برنامه نمونه را دانلود کنید

برای این راهنمای توسعه‌دهنده، باید نمونه برنامه اندروید Type-a-Number Challenge را دانلود کنید.

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

1. نمونه های اندروید را از صفحه دانلود نمونه دانلود کنید.
2. پروژه android-basic-samples را وارد کنید. این پروژه شامل TypeANumber و سایر نمونه های بازی اندروید می باشد. برای انجام این کار در Android Studio:
   1. روی File > Import Project کلیک کنید.
   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 شروع شود.

مرحله 2: بازی را در کنسول Google Play تنظیم کنید

کنسول Google Play جایی است که شما خدمات بازی‌های Google Play را برای بازی خود مدیریت می‌کنید و ابرداده‌ها را برای تأیید و تأیید اعتبار بازی خود پیکربندی می‌کنید.

برای راه اندازی نمونه بازی در کنسول Google Play:

1. مرورگر وب خود را به سمت کنسول Google Play قرار دهید و وارد شوید. اگر قبلاً برای کنسول Google Play ثبت نام نکرده اید، از شما خواسته می شود این کار را انجام دهید.
2. این دستورالعمل ها را دنبال کنید تا بازی خود را به کنسول Google Play اضافه کنید .
   1. وقتی از شما پرسیده شد که آیا از Google APIs در برنامه خود استفاده می کنید، I don't use any Google APIs را در بازی خود انتخاب کنید.
   2. برای اهداف این راهنمای توسعه دهنده، می توانید فرم را با جزئیات بازی خود پر کنید. برای راحتی، می‌توانید از نمادها و اسکرین‌شات‌های مکان‌نمای موجود در صفحه دانلودها استفاده کنید.
3. برای ایجاد شناسه مشتری OAuth 2.0 برای برنامه Android خود، این دستورالعمل ها را دنبال کنید.
   1. هنگام پیوند دادن برنامه Android خود، مطمئن شوید که نام بسته ای را که قبلاً هنگام تغییر نام بسته نمونه استفاده می کردید، مشخص کنید.
   2. اگر قبلاً ندارید، می‌توانید از Generate Signed APK Wizard در Android Studio برای ایجاد یک فروشگاه کلید جدید و گواهی امضا شده استفاده کنید. برای یادگیری نحوه اجرای جادوگر Generate Signed APK, به امضای برنامه خود در Android Studio مراجعه کنید.
4. حتما اطلاعات زیر را برای بعد ثبت کنید:
   1. شناسه برنامه شما: این رشته ای است که فقط از ارقام (معمولاً 12 یا بیشتر) در ابتدای شناسه مشتری شما تشکیل شده است.
   2. گواهی امضای شما: توجه داشته باشید که هنگام تنظیم دسترسی API (گواهینامه ای که اثر انگشت SHA1 آن را ارائه کرده اید) از کدام گواهی استفاده کرده اید. هنگام آزمایش یا انتشار برنامه، باید از همان گواهی برای امضای برنامه خود استفاده کنید.
5. پیکربندی دستاوردها برای چالش Type-a-Number:
   1. تب Achievements را در Google Play Console انتخاب کنید.
   2. دستاوردهای نمونه زیر را اضافه کنید:

      نام	توضیحات	دستورالعمل های ویژه
      نخست	نمره ای بگیرید که یک عدد اول است.	هیچ کدام
      فروتن	امتیاز 0 را درخواست کنید.	هیچ کدام
      مغرور نشو بچه	در هر حالت امتیاز 9999 را درخواست کنید.	هیچ کدام
      OMG UR TEH UBER LEET!	امتیاز 1337 را دریافت کنید.	این را به یک دستاورد پنهان تبدیل کنید.
      بی حوصله	بازی را 10 بار انجام دهید.	با 10 مرحله برای باز کردن قفل، این را به یک دستاورد افزایشی تبدیل کنید.
      واقعا واقعا خسته شده	بازی را 100 بار انجام دهید.	با 100 مرحله برای باز کردن قفل، این را به یک دستاورد افزایشی تبدیل کنید.

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

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

برای اجرای بازی باید شناسه اپلیکیشن را به عنوان منبعی در پروژه اندروید خود پیکربندی کنید. همچنین باید متادیتای بازی‌ها را در 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"/>
   

مرحله 4: بازی خود را تست کنید

برای اطمینان از اینکه سرویس‌های بازی‌های Google Play به درستی در بازی شما کار می‌کنند، قبل از انتشار برنامه در Google Play آن را آزمایش کنید.

برای اجرای بازی خود در دستگاه تست فیزیکی:

1. بررسی کنید که حساب آزمایشی را که برای ورود به برنامه استفاده می‌کنید تنظیم کرده‌اید (همانطور که در مرحله 2 توضیح داده شد).
2. یک APK را صادر کنید و آن را با همان گواهی که برای راه‌اندازی پروژه در کنسول Google Play استفاده کردید، امضا کنید. برای صادر کردن یک APK امضا شده در Android Studio، روی Build > Generate Signed APK کلیک کنید.
3. با استفاده از ابزار adb ، APK امضا شده را روی دستگاه تست فیزیکی خود نصب کنید. برای یادگیری نحوه نصب یک برنامه، به اجرای روی دستگاه مراجعه کنید.