اصالت‌سنجی پلاتفرم برای بازی‌های Android

برای دسترسی به عملکرد «خدمات بازی‌های Google Play»، بازی شما باید حساب بازیکن اصالت‌سنجی‌شده را ارائه دهد. این سند نحوه پیاده‌سازی تجربه اصالت‌سنجی یکپارچه را در بازی‌تان شرح می‌دهد.

کیت توسعه نرم‌افزار «سرویس‌های بازی‌های Play» نسخه ۲ بهبودهایی را به‌همراه دارد که تعداد کاربران اصالت‌سنجی‌شده در بازی شما را افزایش می‌دهد و توسعه را آسان‌تر می‌کند:

  • بهبودها برای کاربران:
    • پس‌از انتخاب حساب پیش‌فرض، کاربران بدون نیاز به تعامل با پیام‌واره اصالت‌سنجی می‌شوند.
    • کاربران دیگر نیازی به بارگیری «برنامه بازی‌های Play» برای اصالت‌سنجی با «سرویس‌های بازی‌های Play» یا ایجاد حساب جدید ندارند.
    • اکنون کاربران می‌توانند حساب‌های «سرویس‌های بازی‌های Play» خود را برای چندین بازی از یک صفحه مدیریت کنند.
  • بهبودها برای توسعه‌دهندگان:
  • کد مشتری دیگر نیازی به مدیریت جریان اصالت‌سنجی یا خروج از سیستم ندارد، زیرا ورود به سیستم به‌طور خودکار هنگام شروع بازی راه‌اندازی می‌شود و مدیریت حساب در تنظیمات سیستم‌عامل انجام می‌شود.

یکپارچه‌سازی مشتری جدید

این بخش نشان می‌دهد که چگونه یکپارچه‌سازی مشتری جدید را با «ورود به سیستم سرویس‌های بازی‌های Play» نسخه ۲ انجام دهید.

افزودن وابستگی

وابستگی کیت توسعه نرم‌افزار «سرویس‌های بازی Play» را به فایل build.gradle سطح ریشه برنامه‌تان اضافه کنید. اگر از Gradle استفاده می‌کنید، می‌توانید وابستگی را به‌صورت زیر اضافه یا به‌روز کنید:

dependencies {
 implementation "com.google.android.gms:play-services-games-v2:+"
}

تعریف شناسه پروژه

برای افزودن شناسه پروژه «کیت توسعه نرم‌افزار سرویس‌های بازی‌های Play» به برنامه‌تان، مراحل زیر را تکمیل کنید:

  1. در فایل AndroidManifest.xml برنامه‌تان، عنصر و مشخصه‌های <meta-data> زیر را به عنصر <application> اضافه کنید:

    <manifest>
      <application>
        <meta-data android:name="com.google.android.gms.games.APP_ID"
                   android:value="@string/game_services_project_id"/>
      </application>
    </manifest>
    

    مرجع منبع رشته @string/game_services_project_id را بااستفاده از شناسه پروژه سرویس‌های بازی بازی‌تان به‌عنوان مقدار تعریف کنید. شناسه پروژه سرویس‌های بازی را می‌توانید زیر نام بازی‌تان در صفحه پیکربندی در «کنسول Google Play» پیدا کنید.

  2. در فایل res/values/strings.xml، مرجع منبع رشته‌ای اضافه کنید و شناسه پروژه‌تان را به‌عنوان مقدار تنظیم کنید. در «کنسول Google Play»، می‌توانید شناسه پروژه‌تان را در زیر نام بازی‌تان در صفحه پیکربندی پیدا کنید. برای مثال:

    <!-- res/values/strings.xml -->
    <resources>
      <!-- Replace 0000000000 with your game's project id. Example value shown above.  -->
      <string translatable="false"  name="game_services_project_id"> 0000000000 </string>
    </resources>
    

مقداردهی اولیه کیت توسعه نرم‌افزار

کیت توسعه نرم‌افزار «بازی‌های Play» را در فراخوانی برگشتی onCreate(..) از کلاس Application مقداردهی اولیه کنید.

import com.google.android.gms.games.PlayGamesSdk;

...

@Override
public void onCreate(){
  super.onCreate();
  PlayGamesSdk.initialize(this);
}

دریافت نتیجه اصالت‌سنجی

وقتی بازی‌تان راه‌اندازی می‌شود، همیشه تلاش می‌کند کاربر را اصالت‌سنجی کند. برای اصالت‌سنجی کاربر، باید درستی‌سنجی کنید که کاربر با موفقیت اصالت‌سنجی شده است و سپس شناسه بازیکن او را دریافت کنید.

برای درستی‌سنجی تلاش برای اصالت‌سنجی، با GamesSignInClient.isAuthenticated() تماس بگیرید و از addOnCompleteListener برای بازیابی نتایج استفاده کنید. برای مثال:

GamesSignInClient gamesSignInClient = PlayGames.getGamesSignInClient(getActivity());

gamesSignInClient.isAuthenticated().addOnCompleteListener(isAuthenticatedTask -> {
  boolean isAuthenticated =
    (isAuthenticatedTask.isSuccessful() &&
     isAuthenticatedTask.getResult().isAuthenticated());

  if (isAuthenticated) {
    // Continue with Play Games Services
  } else {
    // Show a sign-in button to ask players to authenticate. Clicking it should
    // call GamesSignInClient.signIn().
  }
});

جلوگیری از ایجاد خودکار نمایه

می‌توانید پیام‌واره‌های ایجاد نمایه را که به‌طور خودکار راه‌اندازی می‌شوند ازطریق فایل مانیفست غیرفعال کنید. این کار به کاربران بدون نمایه «خدمات بازی‌های Play» اجازه می‌دهد بدون اینکه از آن‌ها خواسته شود نمایه «خدمات بازی‌های Play» ایجاد کنند، به بار کردن بازی ادامه دهند. برای اطلاعات بیشتر، گزینه‌های ایجاد نمایه را ببینید.

برای استفاده از این ویژگی، مطمئن شوید که شرایط زیر برآورده شده باشد:

  • هیچ نمایه «سرویس‌های بازی‌های Play» در هیچ‌کدام از «حساب‌های Google» که در دستگاه به سیستم وارد شده‌اند وجود ندارد.
  • بازی شما با کیت توسعه نرم‌افزار «سرویس‌های بازی‌های Play» نسخه com.google.android.gms:play-services-games-v2:21.0.0 یا بالاتر ادغام شده است.

برای جلوگیری از پیام‌واره‌های ایجاد نمایه که به‌طور خودکار راه‌اندازی می‌شوند، مراحل زیر را تکمیل کنید:

  1. در فایل AndroidManifest.xml، برچسب com.google.android.gms.games.SUPPRESS_GAME_PROFILE_CREATION را در عنصر <meta-data> و مشخصه‌ها را به عنصر <application> اضافه کنید:

    <application>
        ...
        <meta-data
            android:name="com.google.android.gms.games.SUPPRESS_GAME_PROFILE_CREATION"
            android:value="true" />
        ...
    </application>
    

    تنظیم این پرچم روی true به «سرویس‌های بازی‌های Play» اطلاع می‌دهد که بازی شما فرایند ایجاد نمایه را مدیریت خواهد کرد. درنتیجه، «سرویس‌های بازی‌های Play» میانای کاربر ایجاد نمایه را به‌طور خودکار برای کاربران دستگاه که نمایه «سرویس‌های بازی‌های Play» ندارند نمایش نخواهد داد.

  2. وقتی هرکدام از میاناهای برنامه‌سازی کاربردی «خدمات بازی‌های Play» را فراخوانی می‌کنید، GamesClientStatusCodes.SIGN_IN_REQUIRED رمز وضعیت نشان می‌دهد که فراخوانی ناموفق بوده است زیرا کاربر به‌دلیل نداشتن نمایه «خدمات بازی‌های Play» نتوانسته است به‌طور خودکار اصالت‌سنجی شود.

    این کار به کاربران بدون نمایه «خدمات بازی‌های Play» اجازه می‌دهد با روش‌های اصالت‌سنجی پیاده‌سازی‌شده شما ادامه دهند بدون اینکه بلافاصله از آن‌ها خواسته شود نمایه «خدمات بازی‌های Play» ایجاد کنند. ایجاد نمایه را می‌توان با تماس با GamesSignInService.signin() شروع کرد.

    import com.google.android.gms.games.PlayGames;
    ...
    
    // Get the achievements client using Play Games services.
    AchievementsClient achievementsClient = PlayGames.getAchievementsClient(getActivity());
    achievementsClient.getAchievementsIntent()
        .addOnFailureListener(
            new OnFailureListener() {
              @Override
              public void onFailure(@NonNull Exception exception) {
                int statusCode = ((ApiException) exception).getStatusCode();
                if (statusCode == GamesClientStatusCodes.SIGN_IN_REQUIRED) {
                  // SIGN_IN_REQUIRED: The user needs to sign in with Play Games Services.
                  // Call GamesSignInService.signin() to prompt for
                  // authentication at a suitable time which will trigger the
                  // profile creation UI.
                  // (e.g., after a tutorial). Use GamesSignInService.isAuthenticated() to check auth status.
                }
              }
            });
  3. پس‌از افزودن برچسب توقف، از پنجره logcat برای درستی‌سنجی افزودن استفاده کنید. خروجی logcat حاوی پیامی مشابه پیام زیر است: «بازی از پیام‌واره ایجاد خودکار نمایه انصراف داده است (بااستفاده از مانیفست)».