برای ادغام بازی خود با سرویس‌های بازی‌های گوگل پلی، ابتدا احراز هویت پلتفرم را پیاده‌سازی کنید. این مورد برای دسترسی به سایر ویژگی‌ها، مانند دستاوردها، جدول امتیازات و رویدادها، ضروری است.
برای رعایت دستورالعمل‌های تجربه کاربری Google Play Games Level Up، بازی شما باید با جریان احراز هویت توصیه‌شده مطابقت داشته باشد.
مقداردهی اولیه و احراز هویت
این یک مرحله ضروری برای مقداردهی اولیه و احراز هویت بازی شماست:
- با مقداردهی اولیه SDK مربوط به Play Games Services v2 در هنگام راه‌اندازی، احراز هویت پلتفرم را پیاده‌سازی کنید. برای اطلاعات بیشتر، به احراز هویت پلتفرم برای بازی‌های اندروید مراجعه کنید. این یک مرحله ضروری برای دسترسی به ویژگی‌های Play Games Services مانند دستاوردها و جدول امتیازات است.
- احراز هویت به عنوان یک فرآیند پس‌زمینه بی‌صدا در طول اجرای بازی اجرا می‌شود.
کاربران فعلی سرویس‌های بازی‌های Play پس از احراز هویت موفقیت‌آمیز، پیام خوشامدگویی را مشاهده خواهند کرد.
ایجاد پروفایل
بازیکنان برای تعامل با پلتفرم به یک پروفایل Play Games Services نیاز دارند. ممکن است برخی از بازیکنان هنگام شروع بازی شما، پروفایل Play Games Services نداشته باشند. از این بازیکنان خواسته می‌شود که یک پروفایل ایجاد کنند.
وقتی یک بازی را بدون نمایه «خدمات بازی‌های Play» اجرا می‌کنید، به‌طور پیش‌فرض، پیام‌های ایجاد نمایه که به‌طور خودکار فعال می‌شوند، به‌طور خودکار ظاهر می‌شوند.
جریان احراز هویت توصیه شده
برای رعایت دستورالعمل‌های ارتقاء سطح تجربه کاربری بازی‌های گوگل پلی، تأیید کنید که با الزامات تداوم پخش‌کننده مطابقت دارید. برای ورود موفقیت‌آمیز بازیکنان به بازی خود، از جریان احراز هویت زیر استفاده کنید:
- در طول مراحل راه‌اندازی بازی، ایجاد پروفایل با فعال‌سازی خودکار را پیاده‌سازی کنید.
- اگر احراز هویت خودکار ناموفق بود یا شما آن را رد کردید، دکمه ورود دستی را نمایش دهید تا بتوانید بعداً احراز هویت کنید.
شناسه بازیکن
شناسه بازیکن، شناسه‌ای برای حساب کاربری بازیکن در سرویس‌های بازی‌های Play است. بازی شما می‌تواند شناسه بازیکن هر بازیکنی را که با استفاده از احراز هویت سرویس‌های بازی‌های Play وارد بازی شما می‌شود، بازیابی کند. ادغام کلاینت بازی ، ادغام سرور بازی و سرویس ذخیره ابری شما می‌توانند از این شناسه برای دسترسی ایمن به داده‌های بازیکن از سرویس‌های بازی‌های Play استفاده کنند.
یک شناسه بازیکن برای یک کاربر وقتی که بازی شما را روی چندین دستگاه انجام می‌دهد، ثابت است. با این حال، همیشه بین بازی‌ها ثابت نیست. برای اطلاعات بیشتر، به شناسه‌های بازیکن نسل بعدی مراجعه کنید.
دامنه‌های OAuth
سرویس‌های بازی‌های پلی (Play Games Services) برای اینکه به بازیکنان اجازه دهند به بازی شما دسترسی به حساب کاربری‌شان را بدهند، به سیستم OAuth متکی هستند. سرویس‌های بازی‌های پلی یک محدوده‌ی منحصر به فرد برای بازی‌ها ( games-lite ) دارد و اگر بازی شما از ویژگی بازی‌های ذخیره شده (save games) استفاده کند، به محدوده‌ی دیگری ( drive.appdata ) متکی است. ویژگی بازی‌های ذخیره شده به حساب گوگل درایو کاربر، جایی که داده‌های بازی ذخیره می‌شوند، دسترسی می‌دهد.
هنگام استفاده از SDK مربوط به Play Games Services v2، می‌توانید محدوده‌های OAuth بیشتری درخواست کنید. اگر به محدوده‌های OAuth بیشتری نیاز دارید، توصیه می‌کنیم requestServerSideAccess را فراخوانی کنید. برای اطلاعات بیشتر، به get the server auth code یا retrieve server authentication codes مراجعه کنید.
سرویس‌های احراز هویت چندگانه
سرویس‌های بازی‌های پلی (Play Games Services) یک هویت بازی برای بازیکنان اندروید فراهم می‌کند، اما لازم نیست تنها هویت متصل به کاربران شما باشد. می‌توانید بازیکنان را با استفاده از سرویس‌های بازی‌های پلی، یک شناسه شبکه اجتماعی و سیستم شناسه درون بازی خودتان، به طور همزمان، احراز هویت کنید.
فراخوانی API
API Recall به بازی‌ها اجازه می‌دهد تا با ذخیره توکن‌های Recall در سرورهای گوگل، لینک‌های بین کاربران PGS و حساب‌های درون بازی آنها را مدیریت کنند. برای کسب اطلاعات بیشتر در مورد فعال‌سازی این ویژگی، به بخش «ادغام API Recall PGS در بازی خود» مراجعه کنید.
ادغام کلاینت بازی
هنگام ادغام احراز هویت در پروژه بازی خود، جریان کاربری زیر را توصیه می‌کنیم:
در طول مراحل راه‌اندازی بازی، بخش ایجاد پروفایل اجرا می‌شود و تلاش می‌کند تا کاربر را احراز هویت کند یا یک حساب کاربری جدید ایجاد کند.
اگر احراز هویت خودکار ناموفق بود یا شما آن را رد کردید، دکمه ورود دستی را نمایش دهید تا بتوانید بعداً احراز هویت کنید.
برای اطلاعات بیشتر در مورد ادغام احراز هویت در پروژه بازی خود، به مستندات مربوط به نوع پروژه خود مراجعه کنید:
ادغام سرور بازی
پس از تأیید احراز هویت بازیکن، می‌توانید با فراخوانی requestServerSideAccess کد تأیید سرور را دریافت کنید. این کد تأیید سرور را به سرور بازی backend خود ارسال کنید تا مستقیماً با سرورهای Play Games Services ارتباط برقرار کنید. این ارتباط به سرور شما اجازه می‌دهد تا به داده‌های بازیکن، از جمله موارد زیر، دسترسی داشته باشد:
- شناسه بازیکن
- پروفایل
- لیست دوستان
- پیشرفت بازی
- دستاوردها
سپس سرور شما از این کد مجوز به همراه REST API برای تعامل ایمن با سرورهای Play Games Services استفاده می‌کند. برای اطلاعات بیشتر، به دسترسی سمت سرور به Play Games Services مراجعه کنید.
سهمیه درخواست ورود
برای درخواست‌های ورود به سیستم در سرویس‌های بازی‌های Play، سهمیه روزانه‌ای وجود دارد. برای اطلاعات بیشتر، به مدیریت سهمیه روزانه خود مراجعه کنید.