gpg::LeaderboardManager

#include <leaderboard_manager.h>

الحصول على العديد من البيانات المرتبطة بلوحة الصدارة وتعيينها.

ملخّص

الأنواع العلنية
FetchAllCallback	typedef std::function< void(const FetchAllResponse &)> تحدِّد هذه السياسة نوع معاودة الاتصال من FetchAllResponse.
FetchAllScoreSummariesCallback	typedef std::function< void(const FetchAllScoreSummariesResponse &)> تحدِّد هذه السياسة نوع معاودة الاتصال من FetchAllScoreSummariesResponse.
FetchCallback	typedef std::function< void(const FetchResponse &)> تحدد نوع معاودة الاتصال الذي يتلقى FetchResponse.
FetchScorePageCallback	typedef std::function< void(const FetchScorePageResponse &)> تحدِّد هذه السياسة نوع معاودة الاتصال من ScorePageResponse.
FetchScoreSummaryCallback	typedef std::function< void(const FetchScoreSummaryResponse &)> تحدِّد هذه السياسة نوع معاودة الاتصال من FetchScoreSummaryResponse.
ShowAllUICallback	typedef std::function< void(const UIStatus &)> تحدِّد هذه السياسة نوع معاودة الاتصال الذي يتلقّى UIStatus.
ShowUICallback	typedef std::function< void(const UIStatus &)> تحدِّد هذه السياسة نوع معاودة الاتصال الذي يتلقّى UIStatus.

الدوال العامة
Fetch(const std::string & leaderboard_id, FetchCallback callback)	void تُحمِّل بيانات لوحة الصدارة بشكل غير متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا.
Fetch(DataSource data_source, const std::string & leaderboard_id, FetchCallback callback)	void تُحمِّل بيانات لوحة الصدارة بشكل غير متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا.
FetchAll(FetchAllCallback callback)	void تُحمِّل البيانات بشكل غير متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا.
FetchAll(DataSource data_source, FetchAllCallback callback)	void تُحمِّل البيانات بشكل غير متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا.
FetchAllBlocking()	FetchAllResponse تُحمِّل البيانات بشكلٍ متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchAllResponse.
FetchAllBlocking(DataSource data_source)	FetchAllResponse تُحمِّل البيانات بشكلٍ متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchAllResponse.
FetchAllBlocking(Timeout timeout)	FetchAllResponse تُحمِّل البيانات بشكلٍ متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchAllResponse.
FetchAllBlocking(DataSource data_source, Timeout timeout)	FetchAllResponse تُحمِّل البيانات بشكلٍ متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchAllResponse.
FetchAllScoreSummaries(const std::string & leaderboard_id, FetchAllScoreSummariesCallback callback)	void لجلب جميع ملخّصات النتائج للوحة الصدارة بشكل غير متزامن.
FetchAllScoreSummaries(DataSource data_source, const std::string & leaderboard_id, FetchAllScoreSummariesCallback callback)	void لجلب جميع ملخّصات النتائج للوحة الصدارة بشكل غير متزامن.
FetchAllScoreSummariesBlocking(const std::string & leaderboard_id)	FetchAllScoreSummariesResponse يجلب بشكل متزامن جميع ملخصات النتائج للوحة الصدارة معينة، مع عرض FetchAllScoreSummariesResponse مباشرةً.
FetchAllScoreSummariesBlocking(DataSource data_source, const std::string & leaderboard_id)	FetchAllScoreSummariesResponse يجلب بشكل متزامن جميع ملخصات النتائج للوحة الصدارة معينة، مع عرض FetchAllScoreSummariesResponse مباشرةً.
FetchAllScoreSummariesBlocking(Timeout timeout, const std::string & leaderboard_id)	FetchAllScoreSummariesResponse يجلب بشكل متزامن جميع ملخصات النتائج للوحة الصدارة معينة، مع عرض FetchAllScoreSummariesResponse مباشرةً.
FetchAllScoreSummariesBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id)	FetchAllScoreSummariesResponse يجلب بشكل متزامن جميع ملخصات النتائج للوحة الصدارة معينة، مع عرض FetchAllScoreSummariesResponse مباشرةً.
FetchBlocking(const std::string & leaderboard_id)	FetchResponse تُحمِّل بيانات لوحة الصدارة بشكل متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchResponse.
FetchBlocking(DataSource data_source, const std::string & leaderboard_id)	FetchResponse تُحمِّل بيانات لوحة الصدارة بشكل متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchResponse.
FetchBlocking(Timeout timeout, const std::string & leaderboard_id)	FetchResponse تُحمِّل بيانات لوحة الصدارة بشكل متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchResponse.
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id)	FetchResponse تُحمِّل بيانات لوحة الصدارة بشكل متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا.
FetchScorePage(const ScorePage::ScorePageToken & token, FetchScorePageCallback callback)	void يؤدي ذلك إلى عرض بيانات لصفحة نتائج يتم تحديدها من خلال رمز مميّز لصفحة النتائج بشكل غير متزامن.
FetchScorePage(DataSource data_source, const ScorePage::ScorePageToken & token, FetchScorePageCallback callback)	void يؤدي ذلك إلى عرض بيانات لصفحة نتائج يتم تحديدها من خلال رمز مميّز لصفحة النتائج بشكل غير متزامن.
FetchScorePage(const ScorePage::ScorePageToken & token, uint32_t max_results, FetchScorePageCallback callback)	void يؤدي ذلك إلى عرض بيانات لصفحة نتائج يتم تحديدها من خلال رمز مميّز لصفحة النتائج بشكل غير متزامن.
FetchScorePage(DataSource data_source, const ScorePage::ScorePageToken & token, uint32_t max_results, FetchScorePageCallback callback)	void يؤدي ذلك إلى عرض بيانات لصفحة نتائج يتم تحديدها من خلال رمز مميّز لصفحة النتائج بشكل غير متزامن.
FetchScorePageBlocking(const ScorePage::ScorePageToken & token)	FetchScorePageResponse يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.
FetchScorePageBlocking(DataSource data_source, const ScorePage::ScorePageToken & token)	FetchScorePageResponse يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.
FetchScorePageBlocking(Timeout timeout, const ScorePage::ScorePageToken & token)	FetchScorePageResponse يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.
FetchScorePageBlocking(const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.
FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken & token)	FetchScorePageResponse يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.
FetchScorePageBlocking(DataSource data_source, const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.
FetchScorePageBlocking(Timeout timeout, const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.
FetchScorePageBlocking(DataSource data_source, Timeout timeout, const ScorePage::ScorePageToken & token, uint32_t max_results)	FetchScorePageResponse يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.
FetchScoreSummary(const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection, FetchScoreSummaryCallback callback)	void يجلب هذا التطبيق جميع البيانات بشكل غير متزامن لملخص محدّد لنتيجة لوحة الصدارة، والذي يضم مجموعة محددة من لوحة الصدارة والمدة الزمنية المحدّدة.
FetchScoreSummary(DataSource data_source, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection, FetchScoreSummaryCallback callback)	void يجلب هذا التطبيق جميع البيانات بشكل غير متزامن لملخص محدّد لنتيجة لوحة الصدارة، والذي يضم مجموعة محددة من لوحة الصدارة والمدة الزمنية المحدّدة.
FetchScoreSummaryBlocking(const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)	FetchScoreSummaryResponse يجلب بشكل متزامن جميع البيانات لملخص محدد لنتيجة لوحة الصدارة، مع عرض FetchScoreSummaryResponse مباشرةً.
FetchScoreSummaryBlocking(DataSource data_source, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)	FetchScoreSummaryResponse يجلب بشكل متزامن جميع البيانات لملخص محدد لنتيجة لوحة الصدارة، مع عرض FetchScoreSummaryResponse مباشرةً.
FetchScoreSummaryBlocking(Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)	FetchScoreSummaryResponse يجلب بشكل متزامن جميع البيانات لملخص محدد لنتيجة لوحة الصدارة، مع عرض FetchScoreSummaryResponse مباشرةً.
FetchScoreSummaryBlocking(DataSource data_source, Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection collection)	FetchScoreSummaryResponse يجلب بشكل متزامن جميع البيانات لملخص محدد لنتيجة لوحة الصدارة، مع عرض FetchScoreSummaryResponse مباشرةً.
ScorePageToken(const std::string & leaderboard_id, LeaderboardStart start, LeaderboardTimeSpan time_span, LeaderboardCollection collection) const	ScorePage::ScorePageToken الحصول على رمز مميز لصفحة النتائج خاص بلوحة صدارة محددة، بدءًا من النتيجة أو اللاعب وصولاً إلى فترة زمنية ومجموعة محددة.
ShowAllUI(ShowAllUICallback callback)	void تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن جميع لوحات الصدارة.
ShowAllUI()	void تمت إزالة هذا العمود. اختَر ShowAllUI(ShowAllUICallback callback) يعرض واجهة مستخدم للمستخدم تعرِض معلومات عن جميع لوحات الصدارة. يتم عرض واجهة المستخدم بشكل غير متزامن على جميع الأنظمة الأساسية.
ShowAllUIBlocking()	UIStatus تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن جميع لوحات الصدارة.
ShowAllUIBlocking(Timeout timeout)	UIStatus تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن جميع لوحات الصدارة.
ShowUI(const std::string & leaderboard_id, ShowUICallback callback)	void تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.
ShowUI(const std::string & leaderboard_id, LeaderboardTimeSpan time_span, ShowUICallback callback)	void تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.
ShowUI(const std::string & leaderboard_id)	void تمت إزالة هذا العمود. أفضِّل ShowUI(ShowUICallback callback). يعرض واجهة المستخدم للمستخدم وتعرض معلومات عن لوحة صدارة محدّدة. يتم عرض واجهة المستخدم بشكل غير متزامن على جميع الأنظمة الأساسية.
ShowUIBlocking(const std::string & leaderboard_id)	UIStatus تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.
ShowUIBlocking(const std::string & leaderboard_id, LeaderboardTimeSpan time_span)	UIStatus تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.
ShowUIBlocking(Timeout timeout, const std::string & leaderboard_id)	UIStatus تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.
ShowUIBlocking(Timeout timeout, const std::string & leaderboard_id, LeaderboardTimeSpan time_span)	UIStatus تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.
SubmitScore(const std::string & leaderboard_id, uint64_t score)	void أرسل النتيجة إلى لوحة الصدارة للّاعب المسجّل حاليًا الدخول إليه.
SubmitScore(const std::string & leaderboard_id, uint64_t score, const std::string & metadata)	void أرسِل النتيجة إلى لوحة الصدارة المرتبطة برقم تعريف وبيانات وصفية محددة (مثل إجراء نفّذه اللاعب للحصول على النتيجة) للّاعب الذي سجّل دخوله حاليًا.

الهياكل
gpg::LeaderboardManager::FetchAllResponse	يحتوي على البيانات وحالات الاستجابة لجميع لوحات الصدارة.
gpg::LeaderboardManager::FetchAllScoreSummariesResponse	يحتوي على جميع البيانات وحالات الاستجابة لكل ملخّصات نتائج لوحة الصدارة.
gpg::LeaderboardManager::FetchResponse	يحتفظ ببيانات ليدربورد، إلى جانب حالة الاستجابة.
gpg::LeaderboardManager::FetchScorePageResponse	يعرض حالة الاستجابة والبيانات من صفحة النتيجة التي تم الوصول إليها.
gpg::LeaderboardManager::FetchScoreSummaryResponse	البيانات وحالة الاستجابة لملخّص نتيجة محدّدَين في قائمة الصدارة

الأنواع العلنية

FetchAllCallback

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

تحدِّد هذه السياسة نوع معاودة الاتصال من FetchAllResponse.

FetchAllScoreSummariesCallback

std::function< void(const FetchAllScoreSummariesResponse &)> FetchAllScoreSummariesCallback

تحدِّد هذه السياسة نوع معاودة الاتصال من FetchAllScoreSummariesResponse.

FetchCallback

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

تحدد نوع معاودة الاتصال الذي يتلقى FetchResponse.

يتوفّر هذا النوع من معاودة الاتصال لدوال Fetch(*) أدناه.

FetchScorePageCallback

std::function< void(const FetchScorePageResponse &)> FetchScorePageCallback

تحدِّد هذه السياسة نوع معاودة الاتصال من ScorePageResponse.

FetchScoreSummaryCallback

std::function< void(const FetchScoreSummaryResponse &)> FetchScoreSummaryCallback

تحدِّد هذه السياسة نوع معاودة الاتصال من FetchScoreSummaryResponse.

ShowAllUICallback

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

تحدِّد هذه السياسة نوع معاودة الاتصال الذي يتلقّى UIStatus.

يتم توفير نوع معاودة الاتصال هذا في الدالة ShowAllUI* أدناه.

ShowUICallback

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

تحدِّد هذه السياسة نوع معاودة الاتصال الذي يتلقّى UIStatus.

يتم توفير نوع معاودة الاتصال هذا في الدالة ShowUI* أدناه.

الدوال العامة

استدعاء

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

تُحمِّل بيانات لوحة الصدارة بشكل غير متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا.

يتم استدعاء استدعاء FetchCallback المقدّم عند اكتمال العملية. يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لاستدعاء Fetch(DataSource data_source, const std::string& leaderboard_id, FetchCallback callback)، مع تحديد DataSource على النحو التالي CACHE_OR_NETWORK.

استدعاء

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

تُحمِّل بيانات لوحة الصدارة بشكل غير متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا.

يتم استدعاء استدعاء FetchCallback المقدّم عند اكتمال العملية. حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY.

FetchAll

void FetchAll(
  FetchAllCallback callback
)

تُحمِّل البيانات بشكل غير متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا.

يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لاستدعاء FetchAll(DataSource data_source, FetchAllCallback callback)، مع تحديد data_source على أنّه CACHE_OR_NETWORK.

FetchAll

void FetchAll(
  DataSource data_source,
  FetchAllCallback callback
)

تُحمِّل البيانات بشكل غير متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY.

FetchAllBlocking

FetchAllResponse FetchAllBlocking()

تُحمِّل البيانات بشكلٍ متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchAllResponse.

في حال عدم تحديد data_source أو انتهاء المهلة، يتم جعل استدعاء الدالة هذه مكافئًا لاستدعاء FetchAllResponse FetchAllBlock (مهلة Data_source data_source، وانتهاء المهلة)، مع تحديد data_source على أنّه CACHE_OR_NETWORK، والمهلة المحدَّدة على أنّها 10 سنوات.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source
)

تُحمِّل البيانات بشكلٍ متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchAllResponse.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. يؤدي عدم تحديد المهلة إلى جعل استدعاء الدالة هذا مكافئًا لاستدعاء FetchAllResponseFetchAllBlocking(DataSource data_source, Timeout timeout)، مع تحديد قيمة data_source المحدَّدة، والمهلة المحدَّدة على أنّها 10 سنوات.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  Timeout timeout
)

تُحمِّل البيانات بشكلٍ متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchAllResponse.

حدد المهلة كعدد عشوائي من المللي ثانية. يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لاستدعاء FetchAllResponseFetchAllBlocking(DataSource data_source, Timeout timeout)، مع تحديد data_source على أنّه CACHE_OR_NETWORK، والمهلة التي تتضمّن القيمة التي حدَّدتها.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source,
  Timeout timeout
)

تُحمِّل البيانات بشكلٍ متزامن لجميع لوحات الصدارة للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchAllResponse.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. حدد المهلة كعدد عشوائي من المللي ثانية.

FetchAllScoreSummaries

void FetchAllScoreSummaries(
  const std::string & leaderboard_id,
  FetchAllScoreSummariesCallback callback
)

لجلب جميع ملخّصات النتائج للوحة الصدارة بشكل غير متزامن.

يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لـ FetchAllScoreSummaries(DataSource data_source, Cont std::string& leaderboard_id, FetchAllScoreSummariesCallback callback)، مع data_source المحدد على CACHE_OR_NETWORK.

FetchAllScoreSummaries

void FetchAllScoreSummaries(
  DataSource data_source,
  const std::string & leaderboard_id,
  FetchAllScoreSummariesCallback callback
)

لجلب جميع ملخّصات النتائج للوحة الصدارة بشكل غير متزامن.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY.

FetchAllScoreSummariesBlocking

FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking(
  const std::string & leaderboard_id
)

يجلب بشكل متزامن جميع ملخصات النتائج للوحة الصدارة معينة، مع عرض FetchAllScoreSummariesResponse مباشرةً.

يؤدي عدم تحديد data_source والمهلة إلى جعل استدعاء الدالة هذا مكافئًا لـ FetchAllScoreSummariesResponse FetchAllScoreSummariesBlock( DataSource data_source, Cont std::string& leaderboard_id)، مع تحديد data_source على أنّه CACHE_OR_NETWORK، ومُهلتها على 10 سنوات.

FetchAllScoreSummariesBlocking

FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking(
  DataSource data_source,
  const std::string & leaderboard_id
)

يجلب بشكل متزامن جميع ملخصات النتائج للوحة الصدارة معينة، مع عرض FetchAllScoreSummariesResponse مباشرةً.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. يؤدي عدم تحديد المهلة إلى جعل استدعاء الدالة هذا مكافئًا لـ FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocked(DataSource data_source,Const std::string& Leaderboard_id)، مع قيمة data_source المحددة، والمهلة المحدّدة على مدار 10 سنوات.

FetchAllScoreSummariesBlocking

FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking(
  Timeout timeout,
  const std::string & leaderboard_id
)

يجلب بشكل متزامن جميع ملخصات النتائج للوحة الصدارة معينة، مع عرض FetchAllScoreSummariesResponse مباشرةً.

تحديد المهلة بالمللي ثانية. يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لـ FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocked(DataSource data_source, std::string Cont &leaderboard_id)، مع تحديد data_source باعتباره CACHE_OR_NETWORK، وانتهاء المهلة التي تحتوي على القيمة التي حدّدتها لها.

FetchAllScoreSummariesBlocking

FetchAllScoreSummariesResponse FetchAllScoreSummariesBlocking(
  DataSource data_source,
  Timeout timeout,
  const std::string & leaderboard_id
)

يجلب بشكل متزامن جميع ملخصات النتائج للوحة الصدارة معينة، مع عرض FetchAllScoreSummariesResponse مباشرةً.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. تحديد المهلة بالمللي ثانية.

FetchBlocking

FetchResponse FetchBlocking(
  const std::string & leaderboard_id
)

تُحمِّل بيانات لوحة الصدارة بشكل متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchResponse.

في حال عدم تحديد مصدر data_source أو انتهاء المهلة، تصبح استدعاء الدالة هذه مكافئًا لاستدعاء FetchResponse FetchBlock(DataSource data_source, Timeout(Timeout) (مهلة المهلة))، مع تحديد data_source على أنّه CACHE_OR_NETWORK، وتحديد المهلة على أنّها 10 سنوات.

FetchBlocking

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

تُحمِّل بيانات لوحة الصدارة بشكل متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchResponse.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. يؤدي عدم تحديد المهلة إلى جعل استدعاء الدالة هذه مكافئًا لاستدعاء FetchResponse FetchBlocked(DataSource data_source, Timeout(Timeout)) في القيمة المحدّدة لـ data_source، والمهلة المحدّدة على أنّها 10 سنوات.

FetchBlocking

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

تُحمِّل بيانات لوحة الصدارة بشكل متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا، ما يؤدي مباشرةً إلى عرض FetchResponse.

حدد المهلة كعدد عشوائي من المللي ثانية. يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لاستدعاء FetchResponse FetchBlock(DataSource data_source, TimeoutTimeout) (مهلة المهلة)، مع تحديد data_source على أنّه CACHE_OR_NETWORK، والمهلة التي تتضمّن القيمة التي حدَّدتها.

FetchBlocking

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

تُحمِّل بيانات لوحة الصدارة بشكل متزامن للمشغّل الذي سجّلت الدخول إليه حاليًا.

عرض FetchResponse مباشرةً. حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. حدد المهلة كعدد عشوائي من المللي ثانية.

FetchScorePage

void FetchScorePage(
  const ScorePage::ScorePageToken & token,
  FetchScorePageCallback callback
)

يؤدي ذلك إلى عرض بيانات لصفحة نتائج يتم تحديدها من خلال رمز مميّز لصفحة النتائج بشكل غير متزامن.

في حال عدم تحديد data_source أو max_results، يؤدي ذلك إلى جعل استدعاء الدالة هذه مكافئًا لـ FetchScorePage(DataSource data_source, Cont ScorePage::ScorePageToken& icon, uint32_t max_results, FetchScorePageCallback Callback)، مع data_source المحددة كـ CACHE_OR_NETWORK، وmax_results المحددة على أنها 20.

FetchScorePage

void FetchScorePage(
  DataSource data_source,
  const ScorePage::ScorePageToken & token,
  FetchScorePageCallback callback
)

يؤدي ذلك إلى عرض بيانات لصفحة نتائج يتم تحديدها من خلال رمز مميّز لصفحة النتائج بشكل غير متزامن.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. في حال عدم تحديد max_results، يؤدي عدم تحديد max_results إلى أن تكون استدعاء الدالة هذه مكافئًا لـ FetchScorePage(DataSource data_source, Cont ScorePage::ScorePageToken& icon, uint32_t max_results, FetchScorePageCallback), مع القيمة المحددة لـ data_source، وmax_results المحددة على أنها 20.

FetchScorePage

void FetchScorePage(
  const ScorePage::ScorePageToken & token,
  uint32_t max_results,
  FetchScorePageCallback callback
)

يؤدي ذلك إلى عرض بيانات لصفحة نتائج يتم تحديدها من خلال رمز مميّز لصفحة النتائج بشكل غير متزامن.

تحدّد max_results الحد الأقصى لعدد النتائج التي يجب تضمينها في صفحة النتائج الناتجة، والذي قد لا يزيد عن 25 نتيجة. يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لـ FetchScorePage(DataSource data_source, Cont ScorePage::ScorePageToken& icon, uint32_t max_results, FetchScorePageCallback callback)، مع data_source المحددة كـ CACHE_OR_NETWORK، وmax_results التي تحتوي على القيمة المحددة.

FetchScorePage

void FetchScorePage(
  DataSource data_source,
  const ScorePage::ScorePageToken & token,
  uint32_t max_results,
  FetchScorePageCallback callback
)

يؤدي ذلك إلى عرض بيانات لصفحة نتائج يتم تحديدها من خلال رمز مميّز لصفحة النتائج بشكل غير متزامن.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. تحدد max_results الحد الأقصى لعدد النتائج المراد تضمينها في صفحة النتيجة الناتجة، والذي قد لا يزيد عن 25.

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  const ScorePage::ScorePageToken & token
)

يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.

في حال عدم تحديد data_source أو انتهاء المهلة أو max_results، يؤدي ذلك إلى جعل استدعاء الدالة هذه مكافئًا لاستدعاء FetchScorePageResponse FetchScorePageBlock(DataSource data_source, Timeoutآخر,Const ScorePage::ScorePageToken& الرمز، uint32_t max_results)، مع تحديد data_source على أنّه CACHE_OR_NETWORK، المهلة المحددة على 10 سنوات، وmax_results.

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  DataSource data_source,
  const ScorePage::ScorePageToken & token
)

يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.

في حال عدم تحديد أي مهلة أو max_results، تصبح استدعاء الدالة هذه مكافئًا لاستدعاء FetchScorePageResponse FetchScorePageBlocked(DataSource data_source, Timeout, Authenticator, Cont ScorePage::ScorePageToken& icon, uint32_t max_results)

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  Timeout timeout,
  const ScorePage::ScorePageToken & token
)

يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.

تحديد المهلة بالمللي ثانية. في حال عدم تحديد data_source أو max_results، تصبح استدعاء الدالة هذه مكافئًا لاستدعاء FetchScorePageResponse FetchScorePageBlocked(DataSource data_source, Timeout,Timeout, Cont ScorePage::ScorePageToken& icon, uint32_t max_results)، مع data_source المحددة كـ CACHE_OR_NETWORK، وانتهاء المهلة التي تحتوي على القيمة المحددة، وmax_results المحددة على أنّها 20.

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  const ScorePage::ScorePageToken & token,
  uint32_t max_results
)

يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.

حدِّد قيمة تصل إلى 25 لقيمة max_results. يؤدي تحديد مصدر data_source أو المهلة إلى جعل استدعاء الدالة هذه مكافئًا لاستدعاء FetchScorePageResponse FetchScorePageBlocked(DataSource data_source, Timeout,Const ScorePage::ScorePageToken& icon, uint32_t max_results)، مع تحديد data_source على أنه CACHE_OR_NETWORK، ومهلة محددة على 10 سنوات، وmax_results التي تحتوي على القيمة المحددة.

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  DataSource data_source,
  Timeout timeout,
  const ScorePage::ScorePageToken & token
)

يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. تحديد المهلة بالمللي ثانية. يؤدي عدم تحديد max_value إلى استدعاء الدالة max_value لاستدعاء FetchScorePageResponse FetchScorePageBlocked(DataSource data_source, Timeout,آخر, Cont ScorePage::ScorePageToken& icon, uint32_t max_results)، مع data_source والمهلة اللذان يحتويان على القيم المحددة، وmax_results المحددة على أنّها 20.

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  DataSource data_source,
  const ScorePage::ScorePageToken & token,
  uint32_t max_results
)

يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY، وmax_results كقيمة تصل إلى 25. يؤدي عدم تحديد المهلة إلى جعل استدعاء الدالة هذه مكافئًا لاستدعاء FetchScorePageResponse FetchScorePageBanner(DataSource data_source, Timeout,آخر, Cont ScorePage:ScorePageToken& icon, uint32_t max_results)، مع data_source وmax_results اللذان يحتويان على القيم المحددة، والمهلة المحدّدة على أنّها 10 سنوات.

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  Timeout timeout,
  const ScorePage::ScorePageToken & token,
  uint32_t max_results
)

يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.

حدد المهلة بالملي ثانية، وmax_results كقيمة تصل إلى 25. يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لاستدعاء FetchScorePageResponse FetchScorePageBlocked(DataSource data_source, Timeout,آخر, Cont ScorePage::ScorePageToken& icon, uint32_t max_results)، مع المهل وmax_results التي تحتوي على القيم المحددة، وdata_source المحددة كـ CACHE_OR_NETWORK.

FetchScorePageBlocking

FetchScorePageResponse FetchScorePageBlocking(
  DataSource data_source,
  Timeout timeout,
  const ScorePage::ScorePageToken & token,
  uint32_t max_results
)

يتم عرض البيانات بشكل متزامن لصفحة نتائج محدّدة بالرمز المميز لصفحة النتائج، ما يؤدي مباشرةً إلى عرض FetchScorePageResponse.

حدد مصدر البيانات على النحو التالي: CACHE_OR_NETWORK أو NETWORK_ONLY. حدِّد "المهلة" كعدد عشوائي من المللي ثانية. حدِّد max_results كقيمة تصل إلى 25.

FetchScoreSummary

void FetchScoreSummary(
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection,
  FetchScoreSummaryCallback callback
)

يجلب هذا التطبيق جميع البيانات بشكل غير متزامن لملخص محدّد لنتيجة لوحة الصدارة، والذي يضم مجموعة محددة من لوحة الصدارة والمدة الزمنية المحدّدة.

حدد DAILY أو WEEKLY أو ALL_TIME للنطاق الزمني. يمكنك تحديد "علني" أو "اجتماعي" للمجموعة. يؤدي عدم تحديد data_source إلى جعل استدعاء الدالة هذا مكافئًا لـ FetchScoreSummary(DataSource data_source, Cont std::string& leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection, FetchScoreSummaryCallback callback)، مع ضبط data_source على أنّه CACHE_OR_NETWORK، وجمع البيانات وtime_span التي تتضمّن القيم المحددة.

FetchScoreSummary

void FetchScoreSummary(
  DataSource data_source,
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection,
  FetchScoreSummaryCallback callback
)

يجلب هذا التطبيق جميع البيانات بشكل غير متزامن لملخص محدّد لنتيجة لوحة الصدارة، والذي يضم مجموعة محددة من لوحة الصدارة والمدة الزمنية المحدّدة.

حدد CACHE_OR_NETWORK أو NETWORK_ONLY لـ data_source. تحديد DAILY أو WEEKLY أو ALL_TIME للنطاق الزمني يمكنك تحديد "علني" أو "اجتماعي" للمجموعة.

FetchScoreSummaryBlocking

FetchScoreSummaryResponse FetchScoreSummaryBlocking(
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection
)

يجلب بشكل متزامن جميع البيانات لملخص محدد لنتيجة لوحة الصدارة، مع عرض FetchScoreSummaryResponse مباشرةً.

حدد DAILY أو WEEKLY أو ALL_TIME للنطاق الزمني. يمكنك تحديد "علني" أو "اجتماعي" للمجموعة. يؤدي عدم تحديد مصدر data_source والمهلة إلى جعل هذه الدالة معادِلة لاستدعاء FetchScoreSummaryResponse FetchScoreSummaryBlocked(DataSource data_source, Timeout,Const std::string& leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection) مع تحديد data_source على أنّه CACHE_OR_NETWORK، والمهلة المحدّدة على أنّها 10 سنوات، والقيم المحدّدة لمجموعتك.

FetchScoreSummaryBlocking

FetchScoreSummaryResponse FetchScoreSummaryBlocking(
  DataSource data_source,
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection
)

يجلب بشكل متزامن جميع البيانات لملخص محدد لنتيجة لوحة الصدارة، مع عرض FetchScoreSummaryResponse مباشرةً.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. حدد DAILY أو WEEKLY أو ALL_TIME للنطاق الزمني. يمكنك تحديد "علني" أو "اجتماعي" للمجموعة. يؤدي عدم تحديد المهلة إلى جعل هذه الدالة معادِلة لاستدعاء FetchScoreSummaryResponse FetchScoreSummaryBlocked(DataSource data_source, Timeout, const std::string&leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection) مع قيمة data_source المحددة، والمهلة المحدّدة على أنّها 10 سنوات، والقيم المحدّدة لـ time_span والجمع.

FetchScoreSummaryBlocking

FetchScoreSummaryResponse FetchScoreSummaryBlocking(
  Timeout timeout,
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection
)

يجلب بشكل متزامن جميع البيانات لملخص محدد لنتيجة لوحة الصدارة، مع عرض FetchScoreSummaryResponse مباشرةً.

تحديد المهلة بالمللي ثانية. حدد DAILY أو WEEKLY أو ALL_TIME للنطاق الزمني. يمكنك تحديد "علني" أو "اجتماعي" للمجموعة. يؤدي عدم تحديد data_source إلى جعل هذه الدالة معادِلة لاستدعاء FetchScoreSummaryResponse FetchScoreSummaryBlocked(DataSource data_source, Timeout, const std::string& leaderboard_id, LeaderboardTimeSpan time_span, LeaderboardCollection) مع تحديد مهلة 10 سنوات والقيم المحدّدة لـ data_source وtime_span والجمع.

FetchScoreSummaryBlocking

FetchScoreSummaryResponse FetchScoreSummaryBlocking(
  DataSource data_source,
  Timeout timeout,
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection
)

يجلب بشكل متزامن جميع البيانات لملخص محدد لنتيجة لوحة الصدارة، مع عرض FetchScoreSummaryResponse مباشرةً.

حدد data_source على أنه CACHE_OR_NETWORK أو NETWORK_ONLY. تحديد المهلة بالمللي ثانية. حدد DAILY أو WEEKLY أو ALL_TIME للنطاق الزمني. يمكنك تحديد "علني" أو "اجتماعي" للمجموعة.

ScorePageToken

ScorePage::ScorePageToken ScorePageToken(
  const std::string & leaderboard_id,
  LeaderboardStart start,
  LeaderboardTimeSpan time_span,
  LeaderboardCollection collection
) const 

الحصول على رمز مميز لصفحة النتائج خاص بلوحة صدارة محددة، بدءًا من النتيجة أو اللاعب وصولاً إلى فترة زمنية ومجموعة محددة.

يتم استخدام ScorePageToken في دوال ليدربورد المتنوعة التي تسمح بالتقسيم ضمن صفحات النتائج. سوف تبدأ الرموز المميزة التي أنشأتها هذه الدالة دائمًا في بداية النطاق المطلوب.

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 كعدد عشوائي من المللي ثانية.

ShowUI

void ShowUI(
  const std::string & leaderboard_id,
  ShowUICallback callback
)

تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.

وتستدعي ShowUICallback بشكل غير متزامن.

ShowUI

void ShowUI(
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span,
  ShowUICallback callback
)

تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.

وتستدعي ShowUICallback بشكل غير متزامن، وتختار في البداية LeaderboardTimeSpan الذي تم تمريره.

ShowUI

void ShowUI(
  const std::string & leaderboard_id
)

تمت إزالة هذا العمود. أفضِّل ShowUI(ShowUICallback callback). يعرض واجهة المستخدم للمستخدم وتعرض معلومات عن لوحة صدارة محدّدة. يتم عرض واجهة المستخدم بشكل غير متزامن على جميع الأنظمة الأساسية.

ShowUIBlocking

UIStatus ShowUIBlocking(
  const std::string & leaderboard_id
)

تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.

وتعرض UIStatus بشكل متزامن. في حال عدم تحديد timeout، تصبح استدعاء الدالة هذه مكافئًا لاستدعاء ShowUIBlocking(const string& leaderboard_id, Timeout timeout) مع تحديد timeout على أنها 10 سنوات.

ShowUIBlocking

UIStatus ShowUIBlocking(
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span
)

تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.

وتعرض UIStatus بشكل متزامن. في حال عدم تحديد timeout، تصبح استدعاء الدالة هذه مكافئًا لاستدعاء ShowUIBlocking(const string& leaderboard_id, Timeout timeout) مع تحديد timeout على أنها 10 سنوات. في البداية، ستختار واجهة المستخدم LeaderboardTimeSpan التي تم تمريرها.

ShowUIBlocking

UIStatus ShowUIBlocking(
  Timeout timeout,
  const std::string & leaderboard_id
)

تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.

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

ShowUIBlocking

UIStatus ShowUIBlocking(
  Timeout timeout,
  const std::string & leaderboard_id,
  LeaderboardTimeSpan time_span
)

تقدِّم للمستخدم واجهة مستخدم تعرض معلومات عن لوحة صدارة معيّنة.

وتعرض UIStatus بشكل متزامن. حدِّد timeout كعدد عشوائي من المللي ثانية. في البداية، ستختار واجهة المستخدم LeaderboardTimeSpan التي تم تمريرها.

SubmitScore

void SubmitScore(
  const std::string & leaderboard_id,
  uint64_t score
)

أرسل النتيجة إلى لوحة الصدارة للّاعب المسجّل حاليًا الدخول إليه.

ويتم تجاهل النتيجة إذا كانت أسوأ (على النحو المحدّد في إعدادات لوحة الصدارة) من النتيجة التي تم إرسالها سابقًا للّاعب نفسه.

SubmitScore

void SubmitScore(
  const std::string & leaderboard_id,
  uint64_t score,
  const std::string & metadata
)

أرسِل النتيجة إلى لوحة الصدارة المرتبطة برقم تعريف وبيانات وصفية محددة (مثل إجراء نفّذه اللاعب للحصول على النتيجة) للّاعب الذي سجّل دخوله حاليًا.

ويتم تجاهل النتيجة إذا كانت أسوأ (كما هو موضح في إعدادات لوحة الصدارة) من النتيجة التي تم إرسالها سابقًا للّاعب نفسه.