gpg::AchievementManager

#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 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(*) أدناه.

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

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) أيضًا.