ایونت (یونیتی)

ایونت یا رویداد چیست؟

رویدادهای بازی مثل جمع کردن سکه، رفتن به مرحله خاصی از بازی و … که در یک بازه زمانی مشخص برگزار می‌شود. این امکان برای توسعه دهنده‌های بازی‌ها فراهم شده است که بتوانند ایونت‌های بازی خود را در صفحات اصلی کافه بازار در دسترس کاربران قرار دهند.

از طریق صفحه جزییات ایونت می‌توانید توضیحات ایونت، زمان باقی مانده، عکس و ویدیوی مرتبط با ایونت را نمایش دهید.

پیاده‌سازی

برای استفاده از امکانات سرویس ایونت، طبق راهنمای ذکر شده در مستندات، ابتدا کتابخانه GameHub را به پروژه خود اضافه کنید.

نصب و اتصال

۱. دریافت لیست ایونت های فعال در کافه بازار

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

var result = await gameHub.GetEvents();
Debug.Log(result.ToString());

خروجی:

{
  "events": [
    {
      "eventId": "1", //String
      "startTimestamp": "1644654639", //String
      "endTimestamp": "1647335148" //String
    }
  ]
}

۲. اعلان انجام ایونت توسط کاربر

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

مقادیر ورودی:

eventId (String): آیدی ایونت که از طریق کافه بازار در اختیار شما قرار گرفته است

var result = await gameHub.EventDoneNotify("1");
Debug.Log(result.ToString());

خروجی:

دریافت ریسپانس کد ۲۰۰