gpg:: Achievement Manager

#include <achievement_manager.h>

داده های مختلف مرتبط با دستاوردها را دریافت و تنظیم می کند.

خلاصه

انواع عمومی

FetchAllCallback typedef
std::function< void(const FetchAllResponse &)>
یک نوع پاسخ به تماس را تعریف می کند که FetchAllResponse دریافت می کند.
FetchCallback typedef
std::function< void(const FetchResponse &)>
یک نوع پاسخ به تماس را که FetchResponse دریافت می کند، تعریف می کند.
ShowAllUICallback typedef
std::function< void(const UIStatus &)>
یک نوع پاسخ به تماس را تعریف می کند که UIStatus دریافت می کند.

توابع عمومی

Fetch (const std::string & achievement_id, FetchCallback callback)
void
به‌طور ناهمزمان داده‌ها را برای یک دستاورد خاص برای بازیکنی که در حال حاضر به سیستم وارد شده است بارگیری می‌کند.
Fetch ( DataSource data_source, const std::string & achievement_id, FetchCallback callback)
void
به‌طور ناهمزمان داده‌ها را برای یک دستاورد خاص برای بازیکنی که در حال حاضر به سیستم وارد شده است بارگیری می‌کند.
FetchAll ( FetchAllCallback callback)
void
به طور ناهمزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر وارد سیستم شده است بارگیری می کند.
FetchAll ( DataSource data_source, FetchAllCallback callback)
void
به طور ناهمزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر وارد سیستم شده است بارگیری می کند.
FetchAllBlocking ()
به طور همزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر به سیستم وارد شده است بارگیری می کند و FetchAllResponse را مستقیماً برمی گرداند.
FetchAllBlocking ( DataSource data_source)
به طور همزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر به سیستم وارد شده است بارگیری می کند و FetchAllResponse را مستقیماً برمی گرداند.
FetchAllBlocking ( Timeout timeout)
به طور همزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر به سیستم وارد شده است بارگیری می کند و FetchAllResponse را مستقیماً برمی گرداند.
FetchAllBlocking ( DataSource data_source, Timeout timeout)
به طور همزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر به سیستم وارد شده است بارگیری می کند و FetchAllResponse را مستقیماً برمی گرداند.
FetchBlocking (const std::string & achievement_id)
به طور همزمان داده ها را برای یک دستاورد خاص که با شناسه رشته شناسایی شده است، برای پخش کننده وارد شده فعلی بارگیری می کند. به طور مستقیم FetchResponse برمی گرداند.
FetchBlocking ( DataSource data_source, const std::string & achievement_id)
به طور همزمان داده ها را برای یک دستاورد خاص که با شناسه رشته شناسایی شده است، برای پخش کننده وارد شده فعلی بارگیری می کند. به طور مستقیم FetchResponse برمی گرداند.
FetchBlocking ( Timeout timeout, const std::string & achievement_id)
به طور همزمان داده ها را برای یک دستاورد خاص که با شناسه رشته شناسایی شده است، برای پخش کننده وارد شده فعلی بارگیری می کند. به طور مستقیم FetchResponse برمی گرداند.
FetchBlocking ( DataSource data_source, Timeout timeout, const std::string & achievement_id)
به طور همزمان داده ها را برای یک دستاورد خاص که با شناسه رشته شناسایی شده است، برای پخش کننده وارد شده فعلی بارگیری می کند. به طور مستقیم FetchResponse برمی گرداند.
Increment (const std::string & achievement_id)
void
یک دستاورد را با تعداد مراحل معین افزایش می دهد.
Increment (const std::string & achievement_id, uint32_t steps)
void
یک دستاورد را با تعداد مراحل معین افزایش می دهد.
Reveal (const std::string & achievement_id)
void
یک دستاورد پنهان را برای بازیکنی که در حال حاضر وارد سیستم شده است نشان دهید.
SetStepsAtLeast (const std::string & achievement_id, uint32_t steps)
void
یک دستاورد را طوری تنظیم کنید که حداقل تعداد مراحل مشخص شده تکمیل شده باشد.
ShowAllUI ( ShowAllUICallback callback)
void
رابط کاربری را به کاربر ارائه می دهد که اطلاعات مربوط به تمام دستاوردها را نمایش می دهد.
ShowAllUI ()
void
منسوخ شده است. ShowAllUI (ShowAllUICallback back callback) را ترجیح دهید. یک رابط کاربری به کاربر ارائه می دهد که اطلاعات مربوط به تمام دستاوردها را نمایش می دهد. رابط کاربری به صورت ناهمزمان در همه سیستم عامل ها نشان داده می شود.
ShowAllUIBlocking ()
رابط کاربری را به کاربر ارائه می دهد که اطلاعات مربوط به تمام دستاوردها را نمایش می دهد.
ShowAllUIBlocking ( Timeout timeout)
رابط کاربری را به کاربر ارائه می دهد که اطلاعات مربوط به تمام دستاوردها را نمایش می دهد.
Unlock (const std::string & achievement_id)
void
یک دستاورد را برای بازیکنی که در حال حاضر به سیستم وارد شده است باز می کند.

سازه ها

gpg:: AchievementManager:: FetchAllResponse

همه داده ها را برای همه دستاوردها به همراه وضعیت پاسخ نگهداری می کند.

gpg:: AchievementManager:: FetchResponse

شامل داده ها و وضعیت پاسخ برای یک دستاورد واحد است.

انواع عمومی

FetchAllCallback

std::function< void(const FetchAllResponse &)> FetchAllCallback

یک نوع پاسخ به تماس را تعریف می کند که FetchAllResponse دریافت می کند.

این نوع برگشت به توابع FetchAll(*) در زیر ارائه شده است.

FetchCallback

std::function< void(const FetchResponse &)> FetchCallback

یک نوع پاسخ به تماس را که FetchResponse دریافت می کند، تعریف می کند.

این نوع برگشت به توابع Fetch(*) در زیر ارائه شده است.

نمایش AllUICallback

std::function< void(const UIStatus &)> ShowAllUICallback

یک نوع پاسخ به تماس را تعریف می کند که UIStatus دریافت می کند.

این نوع پاسخ تماس برای تابع ShowAllUI* در زیر ارائه شده است.

توابع عمومی

واکشی

void Fetch(
  const std::string & achievement_id,
  FetchCallback callback
)

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

پس از اتمام عملیات، FetchCallback ارائه شده را فراخوانی می کند. مشخص نکردن data_source این فراخوانی تابع را با فراخوانی Fetch(DataSource data_source, const std::string& id, FetchCallback) با data_source به‌عنوان CACHE_OR_NETWORK برابر می‌کند.

واکشی

void Fetch(
  DataSource data_source,
  const std::string & achievement_id,
  FetchCallback callback
)

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

پس از اتمام عملیات، FetchCallback ارائه شده را فراخوانی می کند. منبع داده را به عنوان CACHE_OR_NETWORK یا NETWORK_ONLY مشخص کنید.

FetchAll

void FetchAll(
  FetchAllCallback callback
)

به طور ناهمزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر وارد سیستم شده است بارگیری می کند.

پس از اتمام عملیات، FetchAllCallback ارائه شده را فراخوانی می کند. مشخص نکردن data_source ، این فراخوانی تابع را با فراخوانی FetchAll(DataSource data_source, FetchAllCallback) با data_source به‌عنوان CACHE_OR_NETWORK برابر می‌کند.

FetchAll

void FetchAll(
  DataSource data_source,
  FetchAllCallback callback
)

به طور ناهمزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر وارد سیستم شده است بارگیری می کند.

پس از اتمام عملیات، FetchAllCallback ارائه شده را فراخوانی می کند. data_source به عنوان CACHE_OR_NETWORK یا NETWORK_ONLY مشخص کنید.

FetchAllBlocking

FetchAllResponse FetchAllBlocking()

به طور همزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر به سیستم وارد شده است بارگیری می کند و FetchAllResponse را مستقیماً برمی گرداند.

تعیین نه data_source و نه timeout این فراخوانی تابع را معادل فراخوانی FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout) می‌کند، با data_source به‌عنوان CACHE_OR_NETWORK مشخص می‌شود، و timeout مشخص شده به عنوان 10 سال تعیین می‌شود.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source
)

به طور همزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر به سیستم وارد شده است بارگیری می کند و FetchAllResponse را مستقیماً برمی گرداند.

data_source به عنوان CACHE_OR_NETWORK یا NETWORK_ONLY مشخص کنید. مشخص نکردن timeout ، این فراخوانی تابع را معادل فراخوانی FetchAllBlocking FetchAllResponse (DataSource data_source, Timeout timeout) می کند، با مقدار data_source مشخص شده شما، و timeout تعیین شده به عنوان 10 سال تعیین شده است.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  Timeout timeout
)

به طور همزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر به سیستم وارد شده است بارگیری می کند و FetchAllResponse را مستقیماً برمی گرداند.

timeout به عنوان تعداد دلخواه میلی ثانیه مشخص کنید. مشخص نکردن data_source ، این فراخوانی تابع را با فراخوانی FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout) با data_source به‌عنوان CACHE_OR_NETWORK مشخص می‌کند، و timeout حاوی مقدار مشخص‌شده شما است.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source,
  Timeout timeout
)

به طور همزمان تمام داده های دستاورد را برای پخش کننده ای که در حال حاضر به سیستم وارد شده است بارگیری می کند و FetchAllResponse را مستقیماً برمی گرداند.

data_source به عنوان CACHE_OR_NETWORK یا NETWORK_ONLY مشخص کنید. مهلت زمانی را به عنوان تعداد دلخواه میلی ثانیه مشخص کنید.

FetchBlocking

FetchResponse FetchBlocking(
  const std::string & achievement_id
)

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

نامشخص گذاشتن data_source و timeout باعث می‌شود که این فراخوانی تابعی معادل فراخوانی FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id) ، با data_source مشخص شده به‌عنوان CACHE_OR_NETWORK ، و timeout مشخص شده به عنوان 10 سال تعیین شده است.

FetchBlocking

FetchResponse FetchBlocking(
  DataSource data_source,
  const std::string & achievement_id
)

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

data_source به عنوان CACHE_OR_NETWORK یا NETWORK_ONLY مشخص کنید. نامشخص ماندن timeout ، این فراخوانی تابع را با فراخوانی FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id) با مقدار data_source مشخص شده شما، و timeout تعیین شده به عنوان 10 سال برابر می‌کند.

FetchBlocking

FetchResponse FetchBlocking(
  Timeout timeout,
  const std::string & achievement_id
)

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

timeout به عنوان تعداد دلخواه میلی ثانیه مشخص کنید. نامشخص گذاشتن data_source باعث می‌شود که این فراخوانی تابعی معادل فراخوانی FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id) ، با data_source مشخص شده به‌عنوان CACHE_OR_NETWORK ، و timeout حاوی مقدار مشخص‌شده شما باشد.

FetchBlocking

FetchResponse FetchBlocking(
  DataSource data_source,
  Timeout timeout,
  const std::string & achievement_id
)

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

data_source به عنوان CACHE_OR_NETWORK یا NETWORK_ONLY مشخص کنید. timeout به عنوان تعداد دلخواه میلی ثانیه مشخص کنید.

افزایش

void Increment(
  const std::string & achievement_id
)

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

تعریف نشده گذاشتن افزایش باعث می شود که مقدار آن به 1 پیش فرض شود. دستاورد باید یک دستاورد افزایشی باشد. هنگامی که یک دستاورد به حداکثر تعداد مراحل رسید، به طور خودکار قفل آن باز می شود. هر گونه افزایش بیشتر نادیده گرفته می شود.

افزایش

void Increment(
  const std::string & achievement_id,
  uint32_t steps
)

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

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

آشکار کند

void Reveal(
  const std::string & achievement_id
)

یک دستاورد پنهان را برای بازیکنی که در حال حاضر وارد سیستم شده است نشان دهید.

اگر دستاورد قبلاً باز شده باشد، این هیچ تأثیری نخواهد داشت.

SetStepsAtLeast

void SetStepsAtLeast(
  const std::string & achievement_id,
  uint32_t steps
)

یک دستاورد را طوری تنظیم کنید که حداقل تعداد مراحل مشخص شده تکمیل شده باشد.

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

ShowAllUI

void ShowAllUI(
  ShowAllUICallback callback
)

رابط کاربری را به کاربر ارائه می دهد که اطلاعات مربوط به تمام دستاوردها را نمایش می دهد.

به طور ناهمزمان ShowAllUICallback فراخوانی می کند.

ShowAllUI

void ShowAllUI()

منسوخ شده است. ShowAllUI (ShowAllUICallback back callback) را ترجیح دهید. یک رابط کاربری به کاربر ارائه می دهد که اطلاعات مربوط به تمام دستاوردها را نمایش می دهد. رابط کاربری به صورت ناهمزمان در همه سیستم عامل ها نشان داده می شود.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking()

رابط کاربری را به کاربر ارائه می دهد که اطلاعات مربوط به تمام دستاوردها را نمایش می دهد.

به طور همزمان یک UIStatus را برمی گرداند. عدم تعیین timeout ، این فراخوانی تابع را معادل فراخوانی ShowAllUIBlocking(Timeout timeout) با 10 سال تعیین timeout می کند.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking(
  Timeout timeout
)

رابط کاربری را به کاربر ارائه می دهد که اطلاعات مربوط به تمام دستاوردها را نمایش می دهد.

به طور همزمان یک UIStatus را برمی گرداند. timeout به عنوان تعداد دلخواه میلی ثانیه مشخص کنید.

باز کردن قفل

void Unlock(
  const std::string & achievement_id
)

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

اگر دستاورد پنهان باشد، SDK نیز آن را آشکار می کند.