بررسی اجمالی مهاجرت

سرویس‌های بازی‌های گوگل پلی، کیت توسعه نرم‌افزاری بازی‌ها نسخه ۱، به Google Sign-In برای اندروید متکی است که منسوخ شده و در سال ۲۰۲۵ از Google Play services Auth SDK ( com.google.android.gms:play-services-auth ) حذف خواهد شد. برنامه‌های جدید بازی می‌توانند تا سال ۲۰۲۵ از games v1 استفاده کنند. حذف Google Sign-In مشکلات وابستگی را برای برنامه‌های بازی‌های موجود ایجاد می‌کند. مهاجرت برنامه‌های بازی‌های موجود از games v1 SDK به games v2 SDK مشکلات وابستگی ایجاد شده توسط حذف Google Sign-In را حل می‌کند.

این سند به شما کمک می‌کند تا تعاملات بین برنامه بازی و SDK های مختلف را درک کنید. این سند همچنین ویژگی‌های برنامه را با ویژگی‌های SDK های بازی‌های Play Games Services نسخه ۱ و ۲ مقایسه می‌کند.

تعاملات SDK

این نمودارها تعامل بین یک برنامه بازی در اندروید، هسته خدمات موبایل گوگل (GMS)، خدمات بازی‌های پلی و یک سرور بازی‌های شخص ثالث (3P) را نشان می‌دهند. این نمودارها نحوه استفاده برنامه از سرویس‌های گوگل برای احراز هویت و ویژگی‌های بازی، در عین تعامل با یک سیستم شخص ثالث جداگانه را برجسته می‌کنند.

بازی‌های نسخه ۲ (فعلی)

تعامل بین یک برنامه بازی در اندروید، GMS Core، سرویس‌های بازی‌های Play و یک سرور بازی‌های شخص ثالث (3P).
تعامل بین یک برنامه بازی در اندروید، GMS Core، سرویس‌های بازی‌های Play و یک سرور بازی شخص ثالث (3P). (برای بزرگنمایی کلیک کنید).

بازی‌های نسخه ۱ (قدیمی)

تعامل بین یک برنامه بازی در اندروید، GMS Core، سرویس‌های بازی‌های Play و یک سرور بازی‌های شخص ثالث (3P).
تعامل بین یک برنامه بازی در اندروید، GMS Core، سرویس‌های بازی‌های Play و یک سرور بازی‌های شخص ثالث (3P). (برای بزرگنمایی کلیک کنید).

در ادامه خلاصه‌ای از اجزا و SDKها آمده است:

  • اپلیکیشن بازی‌ها.
    • این نشان دهنده برنامه بازی کاربر است که روی یک دستگاه دارای سیستم عامل اندروید اجرا می‌شود.
    • شامل دو جزء اصلی است:
      • SDK بازی‌های نسخه ۱ یا نسخه ۲. SDK سمت کلاینت که مسئول تعامل با سرویس‌های بازی‌های Play است.
      • کیت توسعه نرم‌افزاری احراز هویت. کیت توسعه نرم‌افزاری احراز هویت سرویس‌های گوگل پلی مسئول مدیریت جریان‌های احراز هویت و مجوزدهی کاربر در بازی‌های نسخه ۱ است.
    • هر دو SDK با استفاده از AIDL (زبان تعریف رابط اندروید) ارتباط برقرار می‌کنند که نشان‌دهنده الگوی ارتباطی بین فرآیندها یا سرویس‌های مختلف است.
  • GMS Core همچنین با نام سرویس‌های گوگل پلی (Google Play Services) شناخته می‌شود.
    • این لایه اختصاصی گوگل در اندروید است.
    • برنامه بازی‌ها از دو ماژول GMS Core استفاده می‌کند:
      • ماژول بازی‌ها. ویژگی‌های خاص بازی، مانند جدول امتیازات، دستاوردها و مدیریت وضعیت بازی را ارائه می‌دهد.
      • ماژول احراز هویت (Auth Module): عملیات احراز هویت و مجوزدهی کاربر را مدیریت می‌کند.
    • SDK های بازی و Auth در برنامه بازی ها با استفاده از رابط های AIDL با ماژول های مربوطه ارتباط برقرار می کنند که نشان دهنده ارتباط بین فرآیندی (IPC) است.

  • دروازه خدمات بازی‌های پلی.
    • یک دروازه منطقی که واسطه ارتباط بین GMS Core و سرور Play Games Services است.
    • درخواست‌های API، تبدیل داده‌ها و احراز هویت برای ارتباط با سرور را مدیریت می‌کند.
  • سرور سرویس‌های بازی‌های پلی.
    • نشان‌دهنده سرویس‌های بک‌اند Play Games Services است که مسئول ذخیره‌سازی داده‌های بازی، مدیریت حساب‌های کاربری و تسهیل ویژگی‌های چندنفره هستند.
  • دروازه بازی‌های شخص ثالث.
    • اگر برنامه بازی‌های شما به عنوان یک برنامه شخص ثالث (3P) واجد شرایط باشد، کتابخانه کلاینت از طریق سرورهای بازی‌های شخص ثالث با سرورهای Play Games Services ارتباط برقرار می‌کند.
    • دلالت بر این دارد که برنامه می‌تواند با یک ارائه‌دهنده خدمات متفاوت نیز احراز هویت کند.
  • سرور بازی‌های شخص ثالث.
    • نشان دهنده یک سرور خارجی اختیاری است که برنامه بازی می‌تواند با آن تعامل داشته باشد، احتمالاً برای ویژگی‌های سفارشی یا مدیریت داده‌ها.
    • ارتباط با برنامه از طریق دروازه بازی‌های شخص ثالث انجام می‌شود.

مقایسه ویژگی‌ها

این جدول مقایسه‌ای از ویژگی‌های بین SDKهای بازی نسخه ۱ و ۲ را ارائه می‌دهد:


ویژگی

بازی‌ها نسخه ۱ SDK

بازی‌ها نسخه ۲ SDK

احراز هویت

ادغام با play-services-auth الزامی است.

ساده و روان؛ بدون نیاز به play-services-auth .

مجوز

کد اضافی برای موفقیت، شکست و تلاش مجدد.

مدیریت شده توسط SDK

توکن دسترسی به سرور

می‌تواند با GoogleSigninClient محدوده‌های اضافی OAuth 2.0 را درخواست کند.

کد اضافی برای مدیریت خطا در هنگام احراز هویت.

می‌تواند هنگام درخواست دسترسی سمت سرور به APIهای وب سرویس‌های بازی‌های Play، سه حوزه هویت پایه OAuth 2.0 را با GamesSignInClient درخواست کند.

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


فرآیند ورود

از GoogleSigninClient استفاده می‌کند.

کد اضافی برای مدیریت کد تکراری برای احراز هویت خودکار و مدیریت خطا.

از GamesSignInClient استفاده می‌کند.

SDK کد تکراری، احراز هویت خودکار و مدیریت خطا را مدیریت می‌کند.

پاپ‌آپ خوش‌آمدگویی

کد اضافی مورد نیاز است.
توسعه‌دهندگان می‌توانند محل قرارگیری و زمان‌بندی آن را کنترل کنند.

بدون نیاز به کد اضافی. رابط کاربری یکپارچه در تمام بازی‌های پیکربندی شده با games v2 SDK.

وابستگی‌ها

به play-services-auth نیاز دارد.

ماژول Games مسئولیت مجوزدهی و احراز هویت را بر عهده دارد. نیازی به اضافه کردن هیچ وابستگی اضافی ندارید.
خروج از سیستم

از GoogleSignInClient.signOut استفاده می‌کند.

API خروج از سیستم پشتیبانی نمی‌شود.

چندین حساب کاربری و تنظیمات مربوط به هر بازی در سرویس‌های بازی‌های پلی

مدیریت حساب کاربری در داخل بازی شما امکان‌پذیر است.

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