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
|
ShowAllUIBlocking()
|
تعرض للمستخدم واجهة مستخدم تعرض معلومات عن جميع الإنجازات.
|
ShowAllUIBlocking(Timeout timeout)
|
تعرض للمستخدم واجهة مستخدم تعرض معلومات عن جميع الإنجازات.
|
Unlock(const std::string & achievement_id)
|
void
فتح إنجاز للّاعب الذي يسجّل الدخول حاليًا
|
بُنى |
|
---|---|
gpg:: |
يحتوي على جميع البيانات الخاصة بجميع الإنجازات، إلى جانب حالة الردّ. |
gpg:: |
يحتوي على البيانات وحالة الاستجابة لإنجاز واحد. |
الأنواع العامة
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) تكشف عنه أيضًا.