gpg::AchievementManager

#include <achievement_manager.h>

الحصول على بيانات مختلفة متعلقة بالإنجازات وجمعها

ملخّص

الأنواع العامة
FetchAllCallback تعريف الكتابة
std::function< void(const FetchAllResponse &)>
تحدِّد هذه السياسة نوع معاودة الاتصال الذي يتلقّى رمز FetchAllResponse.
FetchCallback تعريف الكتابة
std::function< void(const FetchResponse &)>
تحدِّد هذه السياسة نوع معاودة الاتصال الذي يتلقّى رمز FetchResponse.
ShowAllUICallback تعريف الكتابة
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): تعرض واجهة مستخدم تعرض معلومات عن جميع الإنجازات. يتم عرض واجهة المستخدم بشكل غير متزامن على جميع الأنظمة الأساسية.
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(*) أدناه.

ShowAllUICallback

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 المقدَّم عند اكتمال العملية. حدِّد data_source على أنّه 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): تعرض واجهة مستخدم تعرض معلومات عن جميع الإنجازات. يتم عرض واجهة المستخدم بشكل غير متزامن على جميع الأنظمة الأساسية.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking()

تعرض للمستخدم واجهة مستخدم تعرض معلومات عن جميع الإنجازات.

ويتم عرض UIStatus بشكل متزامن. عدم تحديد timeout يجعل استدعاء هذه الدالة مكافئًا لاستدعاء ShowAllUIBlocking(Timeout timeout) مع تحديد timeout على أنه 10 سنوات.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking(
  Timeout timeout
)

تعرض للمستخدم واجهة مستخدم تعرض معلومات عن جميع الإنجازات.

ويتم عرض UIStatus بشكل متزامن. حدِّد timeout كعدد عشوائي من المللي ثانية.

فتح القفل

void Unlock(
  const std::string & achievement_id
)

فتح إنجاز للّاعب الذي يسجّل الدخول حاليًا

وإذا كان الإنجاز مخفيًا، فإن حزمة تطوير البرامج (SDK) تكشف عنه أيضًا.