برنامه انحلال

این سند، برنامه‌ی منسوخ شدن SDK نسخه ۱ سرویس‌های بازی‌های Play را فهرست می‌کند.

پس از منسوخ شدن API ورود به سیستم گوگل (GSI) و تعطیلی برنامه‌ریزی‌شده، ما SDK و APIهای Play Games Services v1 را منسوخ می‌کنیم. برای دریافت جدیدترین ویژگی‌ها، باید بازی خود را به SDK Play Games Services v2 منتقل کنید.

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

تاریخ	منسوخ شدن نقطه عطف	تأثیر	توسعه‌دهنده عمل
مه ۲۰۲۶	حذف API GSI	اگر یک بازی ویژگی‌های جدیدی مانند لایوآپ‌ها، ماموریت‌ها یا نقشه‌ها را اضافه کند که به احراز هویت گوگل وابسته نباشند، به جز API نسخه ۱ سرویس‌های بازی‌های Play، این ویژگی‌ها همچنان به کار خود ادامه خواهند داد. اگر بازی شما از یک SDK شخص ثالث یا یک SDK گوگل غیر از Play Games Services v1 استفاده می‌کند که نیاز به ارتقاء احراز هویت دارد، ارتقاء به آخرین نسخه آن SDK ممکن است باعث خطاهای کامپایل شود.	هنگام مواجهه با خطای کامپایل، مسیر حل ذکر شده در اینجا را دنبال کنید. مطمئن شوید که درست پس از انتشار راهکار در اواخر سه‌ماهه دوم ۲۰۲۶، طبق مسیر راهکار ذکر شده در اینجا، به Play Games Services v2 مهاجرت می‌کنید.
۱۵ ژوئن ۲۰۲۶	حذف API نسخه ۱ سرویس‌های بازی‌های پلی	یک کیت توسعه نرم‌افزار (SDK) جدید برای Play Games Services v1 با APIهای حذف‌شده‌ی GSI منتشر خواهد شد و هیچ رفع اشکال یا به‌روزرسانی دیگری برای ویژگی‌های موجود Play Games Services v1 ارائه نخواهد شد. اگر یک بازی نسخه ۱ موجود به آخرین نسخه Play Games Services v1 ارتقا یابد، عملکردهای Play Games Services در این نسخه جدید از کار خواهند افتاد.	بازی‌های Play Games Services نسخه ۱ نباید SDK نسخه ۱ خود را به com.google.android.gms:play-services-games:25.0.0 ارتقا دهند، که باعث حذف APIهای نسخه ۱ می‌شود. هر بازی‌ای که به Play Games Services v2 مهاجرت نکرده باشد، ممکن است با خطاهای کامپایل مواجه شود، زیرا play-services-auth از ماه مه 2026 دیگر GSI ارائه نمی‌دهد. طبق جدول زمانی ذکر شده در بخش قبلی، بازی‌ها می‌توانند نسبت به ارتقاء سایر SDKها هوشیار باشند و اطمینان حاصل کنند که سایر SDKها تا زمانی که به Play Games Services v2 مهاجرت نکنند، از SDK جدید Credential Manager استفاده نمی‌کنند.
مه ۲۰۲۷	خاموش شدن نسخه ۱ سرویس‌های بازی‌های پلی	تمام ترافیک از سرویس‌های بازی‌های Play نسخه ۱ بدون کامپایل کردن بازی مسدود شده است. APIهای موجود Play Games Services v1 در محیط عملیاتی از کار می‌افتند.	تنها گزینه این است که قبل از این مهلت به Play Games Services v2 مهاجرت کنید تا از اختلالات ورود و ثبت‌نام بازیکن جلوگیری شود.

• پس از سپتامبر ۲۰۲۵، SDK و APIهای نسخه ۱ بازی‌ها منسوخ می‌شوند. عناوین موجود با ادغام‌های قبلی نسخه ۱ همچنان به کار خود ادامه می‌دهند. گوگل پلی از انتشار عناوین جدیدی که از SDK و APIهای نسخه ۱ استفاده می‌کنند، جلوگیری می‌کند.

• از ۱۵ ژوئن ۲۰۲۶، APIهای منسوخ‌شده از SDK حذف خواهند شد.

• از ژوئن ۲۰۲۷، SDK نسخه ۱ بازی‌ها حذف خواهد شد. فراخوانی این APIها، حتی اگر از نسخه‌های قبلی SDK استفاده کنید، با شکست مواجه خواهد شد.

جدول زیر نسخه‌های v1 (SDK) بازی‌ها، تاریخ‌های منسوخ شدن و راهنماهای مهاجرت آنها را فهرست می‌کند:

نسخه SDK	تاریخ انتشار	راهنمای مهاجرت
بازی‌های خدماتی: نسخه ۲۴.۰.۰	۱۲ سپتامبر ۲۰۲۵ منسوخ شده	مهاجرت به نسخه ۲ (جاوا یا کاتلین)
نسخه ۰.۱۰.۱۵ یونیتی	۱۷ سپتامبر ۲۰۲۵ منسوخ شده	مهاجرت به نسخه ۲ (یونیتی)
بازی‌های خدماتی: نسخه ۲۵.۰.۰	۱۵ ژوئن ۲۰۲۶ رابط برنامه‌نویسی کاربردی (API) نسخه ۱ سرویس‌های بازی‌های پلی از کیت توسعه نرم‌افزار (SDK) حذف شد.	مهاجرت به نسخه ۲ (جاوا یا کاتلین)

نمونه‌ای از تأثیر حذف GSI API

سناریویی را در نظر بگیرید که در آن یک SDK، SDK1، لیستی از دوستان را از حساب گوگل یک بازیکن بازیابی می‌کند. برای استفاده از این ویژگی، بازیکنان باید حساب گوگل خود را با استفاده از SDK احراز هویت گوگل تأیید کنند.

ممکن است در شرایط زیر نیاز به به‌روزرسانی SDK احراز هویت گوگل داشته باشید:

• یک اشکال بحرانی در جریان احراز هویت برطرف شد.
• تجربیات جدید کلید عبور ارائه شده توسط Credential Manager SDK را پیاده‌سازی کنید.

جدول زیر سه سناریو برای به‌روزرسانی یکپارچه‌سازی احراز هویت بازی شما را شرح می‌دهد:

• سناریوی ۱: SDK1 به جدیدترین SDK احراز هویت گوگل ارتقا می‌یابد.
• سناریوی دوم: SDK1 با Credential Manager ادغام می‌شود و SDK احراز هویت گوگل بدون تغییر باقی می‌ماند.
• سناریو ۳: SDK1 با Credential Manager ادغام می‌شود و SDK مربوط به احراز هویت گوگل را حذف می‌کند.

ویژگی	سناریوی ۱	سناریوی ۲	سناریوی ۳
سناریوهای ارتقاء مجوز	از حذف APIهای GSI و ارتقاء بازی به آخرین SDK مربوط به احراز هویت اطلاعی ندارم. عملکرد احراز هویت موجود از کار می‌افتد و SDK1 مجبور به ادغام SDK مدیریت اعتبارنامه می‌شود. بازی آخرین نسخه را با جدیدترین SDK مربوط به احراز هویت و SDK مربوط به مدیریت اعتبارنامه منتشر می‌کند.	با توجه به حذف GSI API، SDK1، SDK مربوط به احراز هویت را ارتقا نمی‌دهد، اما قابلیت احراز هویت گوگل را با استفاده از SDK مدیریت اعتبار در آخرین نسخه خود، فعال می‌کند.	در آخرین نسخه، SDK1 با استفاده از Credential Manager SDK، قابلیت احراز هویت گوگل را فعال می‌کند و SDK مربوط به احراز هویت را به طور کامل حذف می‌کند.
کیت توسعه نرم‌افزاری خدمات بازی‌های پلی (Play Games Services v1 SDK)	بدون تغییر	بدون تغییر	بدون تغییر
وقتی بازی کامپایل می‌شود چه اتفاقی می‌افتد؟	سرویس‌های بازی‌های Play نسخه ۱ به یکپارچه‌سازی SDK احراز هویت جداگانه نیاز دارد -> از آنجایی که SDK احراز هویت بدون APIهای GSI ارتقا یافته است، سرویس‌های بازی‌های Play نسخه ۱ از کار خواهند افتاد. بازی هنگام کامپایل دچار خطا می‌شود. سپس بازی سعی می‌کند مسیر وضوح تصویر را دنبال کند.	بازی خطاهای زمان کامپایل می‌گیرد	سپس بازی سعی می‌کند مسیر وضوح تصویر را دنبال کند.
تجربه احتمالی بازیکن	ناموجود. از آنجایی که بازی قادر به کامپایل نیست، بنابراین انتشاری در کار نیست.	بازیکن هنگام احراز هویت با استفاده از Play Games Services نسخه ۱، انتخابگر حساب Play Games Services را می‌بیند. بازیکن هنگام احراز هویت با استفاده از ویژگی SDK1، برگه پایانی Credential Manager را مشاهده می‌کند.	بازیکن هنگام احراز هویت با استفاده از Play Games Services نسخه ۱، انتخابگر حساب Play Games Services را می‌بیند. بازیکن هنگام احراز هویت با استفاده از ویژگی SDK1، برگه پایانی Credential Manager را مشاهده می‌کند.
مسیر وضوح تصویر برای توسعه‌دهنده بازی	بفهمید کدام SDK باعث ارتقاء SDK مربوط به احراز هویت می‌شود. نسخه SDK مربوط به SDK1 را به حالت اولیه برگردانید. بازی آنها را با ویژگی مورد نظرشان دوباره کامپایل کنید. اگر ویژگی جدید بازی نیاز به ارتقاء به SDK1 دارد، با SDK1 صحبت کنید تا سناریوهای ۲ یا ۳ را برای نسخه خود اتخاذ کند.	هیچی با این حال، اگر از دکمه ورود با گوگل نیز استفاده می‌کنید، ممکن است مجبور شوید از دو نوع جریان ورود با گوگل برای بازیکنان استفاده کنید.	هیچی با این حال، اگر از دکمه ورود با گوگل نیز استفاده می‌کنید، ممکن است مجبور شوید از دو نوع جریان ورود با گوگل برای بازیکنان استفاده کنید.
نتیجه نهایی برای خدمات بازی‌های Play نسخه ۱	بازی نیازی به ارتقا به Play Games Services v2 ندارد، اما SDK1 هنوز قدیمی است.	بازی نیازی به ارتقا از Play Games Services نسخه ۱ به نسخه ۲ ندارد.	بازی نیازی به ارتقا از Play Games Services نسخه ۱ به نسخه ۲ ندارد.