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