آمار بازی در بازی‌های یونیتی

این مبحث نحوه استفاده از آمار بازی سرویس‌های Play Games در بازی‌های Unity را شرح می‌دهد. فرض بر این است که شما پروژه خود و افزونه Google Play Games را برای Unity، همانطور که در راهنمای شروع به کار بحث شده است، راه‌اندازی کرده‌اید.

آمار بازی را ایجاد کنید

وقتی پروژه و افزونه خود را راه‌اندازی می‌کنید، Game Stats را در کنسول Google Play ایجاد کنید و سپس افزونه را با منابع اندروید برای Game Stats خود به‌روزرسانی کنید. برای جزئیات بیشتر در مورد ایجاد Game Stats در کنسول Play، به راهنمای Game Stats مراجعه کنید.

ادغام سمت کلاینت

یکپارچه‌سازی سمت کلاینت برای PlayerGameEvent شامل ساخت شیء رویداد در Csharp، در نقاط شروع و ارسال آنها با استفاده از توابع آپلود ارائه شده توسط SDK می‌شود.

به طور مشابه، برای رویداد progressUpdate ، پیشرفت به‌روزرسانی‌شده را با استفاده از ویژگی currentProgress به همراه ویژگی‌های تعریف‌شده‌ی اضافی ثبت کنید و آن‌ها را با استفاده از توابع آپلود ارائه شده توسط SDK ارسال کنید.

رویدادها

ادغام سمت کلاینت برای PlayerGameEvent عبارتند از:

رویداد بازی Build Player

وحدت

// Build the PlayerGameEvent
var playerEvent = new PlayerGameEvent.Builder("matchCompleted")
   .AddProperty("matchId", "Match_A")
   .AddProperty("gameMode", "Battle_B")
   .AddProperty("mapId", "Location_XYZ")
   .AddProperty("isWinner", true)
   .AddProperty("playerElimination", 2)
   .Build();
var events = new List();
// ... populate list ...

progressUpdate ساختبه‌روزرسانی رویداد بازی بازیکن

وحدت

// Build the PlayerGameEvent
var progressEvent = new PlayerGameEvent.Builder("progressUpdate")
   .AddProperty("currentProgress", 52)
   // Add other properties if needed
   .Build();
var events = new List();
// ... populate list ...

ضبط رویداد و آپلود

وحدت

// Buffers the event locally.
PlayGamesPlatform.Instance.RecordEvent(playerEvent);

// Buffers the events locally, (List version)
PlayGamesPlatform.Instance.RecordEvents(events);

// This submits the events to PGS
PlayGamesPlatform.Instance.RequestEventsUpload();

توجه: هر رویداد آپلود شده در مقایسه با طرحواره اعلام شده در کنسول اعتبارسنجی می‌شود. اگر رویداد آپلود شده حاوی ویژگی‌ها یا انواع داده مربوطه متفاوت از موارد اعلام شده در کنسول باشد، رویداد ارسال نمی‌شود و پاسخ مربوطه در پاسخ فراخوانی API ارسال می‌شود. در صورت آپلود دسته‌ای، هر رویداد آپلود شده در مقایسه با طرحواره اعلام شده اعتبارسنجی می‌شود و رویدادهایی که طرحواره را رعایت نکنند، ارسال نمی‌شوند و در پاسخ با دلیل عدم موفقیت نشان داده می‌شوند.