تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
gpg::ليدربورد
#include <leaderboard.h>
يشير ذلك المصطلح إلى بنية بيانات واحدة تتيح لك الوصول إلى بيانات حول حالة لوحة صدارة معيَّنة، مثل اسمه وصلاحيته.
ملخّص
وظائف عامة
|
IconUrl() const
|
const std::string &
تعرض عنوان URL الذي يؤدي إلى صورة رمز ليدربورد هذا. |
Id() const
|
const std::string &
عرض السلسلة الفريدة التي أنشأتها Google Play Console مسبقًا.
|
Name() const
|
const std::string &
تعرض الاسم المختصر للوحة الصدارة.
|
Order() const
|
لعرض ما إذا كان الترتيب التصاعدي أم التنازلي أفضل.
|
Valid() const
|
bool
تعرض القيمة "صحيح" عندما تكون لوحة الصدارة المعروضة مملوءة بالبيانات وتكون مصحوبة بحالة استجابة ناجحة؛ "خطأ" في لوحة الصدارة التي لم تتم تعبئتها بواسطة المستخدم أو للوحة معبأة مصحوبة بحالة استجابة غير ناجحة
|
operator=(const Leaderboard & copy_from)
|
عامل تشغيل التخصيص لتحديد قيمة لوحة الصدارة هذه من لوحة صدارة أخرى.
|
operator=(Leaderboard && move_from)
|
عامل تشغيل التخصيص لتحديد قيمة لوحة الصدارة هذه من لوحة صدارة أخرى.
|
وظائف عامة
IconUrl
const std::string & IconUrl() const
Id
const std::string & Id() const
عرض السلسلة الفريدة التي أنشأتها Google Play Console مسبقًا.
ويمكنك استخدامه للإشارة إلى لوحة صدارة في برنامج لعبتك. ولا يمكن طلبه إلا عندما تعرض الدالة Leaderboard::Valid() القيمة "صحيح".
قائمة الصدارة
Leaderboard()
قائمة الصدارة
Leaderboard(
std::shared_ptr< const LeaderboardImpl > impl
)
الدالة الإنشائية الواضحة.
قائمة الصدارة
Leaderboard(
const Leaderboard & copy_from
)
نسخ الدالة الإنشائية لنسخ لوحة صدارة حالية إلى لوحة جديدة
قائمة الصدارة
Leaderboard(
Leaderboard && move_from
)
أداة إنشاء لنقل لوحة صدارة حالية إلى لوحة جديدة.
إصدار r-value-reference.
الاسم
const std::string & Name() const
تعرض الاسم المختصر للوحة الصدارة.
حتى 100 حرف. ولا يمكن طلبه إلا عند عرض الدالة Achievement::Valid() على true.
طلب
LeaderboardOrder Order() const
لعرض ما إذا كان الترتيب التصاعدي أم التنازلي أفضل.
القيم المحتملة هي "LARGER_IS_BETTER" أو "SMALLER_IS_BETTER". يضع LARGER_IS_BETTER نتائج أكبر في الأعلى (ترتيب تنازلي). smallER_IS_BETTER تضع درجات أصغر في الأعلى (تصاعديًا). ولا يمكن طلبه إلا عند عرض الدالة Achievement::Valid() على true.
صحيح
bool Valid() const
تعرض القيمة "صحيح" عندما تكون لوحة الصدارة المعروضة مملوءة بالبيانات وتكون مصحوبة بحالة استجابة ناجحة؛ "خطأ" في لوحة الصدارة التي لم تتم تعبئتها بواسطة المستخدم أو للوحة معبأة مصحوبة بحالة استجابة غير ناجحة
يجب أن يكون هذا صحيحًا بالنسبة إلى دوال getter في لوحة الصدارة هذه (المعرّف، والاسم، والوصف، وما إلى ذلك) لتكون قابلة للاستخدام.
operator=
Leaderboard & operator=(
const Leaderboard & copy_from
)
عامل تشغيل التخصيص لتحديد قيمة لوحة الصدارة هذه من لوحة صدارة أخرى.
operator=
Leaderboard & operator=(
Leaderboard && move_from
)
عامل تشغيل التخصيص لتحديد قيمة لوحة الصدارة هذه من لوحة صدارة أخرى.
إصدار r-value-reference.
~لوحة الصدارة
~Leaderboard()
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# gpg::Leaderboard Class Reference\n\ngpg::Leaderboard\n================\n\n`#include \u003cleaderboard.h\u003e`\n\nA single data structure allowing you to access data about the status of a specific leaderboard, such as its name and validity.\n\nSummary\n-------\n\n| ### Constructors and Destructors ||\n|---|---|\n| [Leaderboard](#classgpg_1_1_leaderboard_1ae00cee7b5871b60ed0f8cf8ed2aeb4a6)`()` ||\n| [Leaderboard](#classgpg_1_1_leaderboard_1a9c87f8487ea39d307bea77c2f624387e)`(std::shared_ptr\u003c const LeaderboardImpl \u003e impl)` Explicit constructor. ||\n| [Leaderboard](#classgpg_1_1_leaderboard_1a943d7e864d459b1605794a6fabef1653)`(const `[Leaderboard](/games/services/cpp/api/class/gpg/leaderboard#classgpg_1_1_leaderboard)` & copy_from)` Copy constructor for copying an existing leaderboard into a new one. ||\n| [Leaderboard](#classgpg_1_1_leaderboard_1a10a16a9c1fccb70e8f231813d093b3a2)`(`[Leaderboard](/games/services/cpp/api/class/gpg/leaderboard#classgpg_1_1_leaderboard)` && move_from)` Constructor for moving an existing leaderboard into a new one. ||\n| [~Leaderboard](#classgpg_1_1_leaderboard_1aeeae550785fca1d79c8187ae12610123)`()` ||\n\n| ### Public functions ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [IconUrl](#classgpg_1_1_leaderboard_1a74076db7d71675e2e6228cb2f396e5c5)`() const ` | `const std::string &` Returns the URL leading to the image of the icon for this [Leaderboard](/games/services/cpp/api/class/gpg/leaderboard#classgpg_1_1_leaderboard). |\n| [Id](#classgpg_1_1_leaderboard_1ab30ace9344a5443519b8d70bb4947085)`() const ` | `const std::string &` Returns the unique string that the Google Play Developer Console generated beforehand. |\n| [Name](#classgpg_1_1_leaderboard_1a237846a501cea52e6a9142ee892af697)`() const ` | `const std::string &` Returns the short name of the leaderboard. |\n| [Order](#classgpg_1_1_leaderboard_1a008e480040a730e6729368a9c694f717)`() const ` | [LeaderboardOrder](/games/services/cpp/api/namespace/gpg#namespacegpg_1a17d647fceb4fee77f693520405f75cb9) Returns whether ascending or descending order is better. |\n| [Valid](#classgpg_1_1_leaderboard_1a510984968ca31ed44aafb18dec22a159)`() const ` | `bool` Returns true when the returned leaderboard is populated with data and is accompanied by a successful response status; false for an unpopulated user-created leaderboard or for a populated one accompanied by an unsuccessful response status. |\n| [operator=](#classgpg_1_1_leaderboard_1a4e893a80cc728b346368ff002a9f10a1)`(const `[Leaderboard](/games/services/cpp/api/class/gpg/leaderboard#classgpg_1_1_leaderboard)` & copy_from)` | [Leaderboard](/games/services/cpp/api/class/gpg/leaderboard#classgpg_1_1_leaderboard)` &` Assignment operator for assigning this leaderboard's value from another leaderboard. |\n| [operator=](#classgpg_1_1_leaderboard_1a2c99314b97150d4e24a6b7b0a399139d)`(`[Leaderboard](/games/services/cpp/api/class/gpg/leaderboard#classgpg_1_1_leaderboard)` && move_from)` | [Leaderboard](/games/services/cpp/api/class/gpg/leaderboard#classgpg_1_1_leaderboard)` &` Assignment operator for assigning this leaderboard's value from another leaderboard. |\n\nPublic functions\n----------------\n\n### IconUrl\n\n```c++\nconst std::string & IconUrl() const \n``` \nReturns the URL leading to the image of the icon for this [Leaderboard](/games/services/cpp/api/class/gpg/leaderboard#classgpg_1_1_leaderboard).\n\nIt can only be called when [Leaderboard::Valid()](/games/services/cpp/api/class/gpg/leaderboard#classgpg_1_1_leaderboard_1a510984968ca31ed44aafb18dec22a159) returns true. \n\n### Id\n\n```c++\nconst std::string & Id() const \n``` \nReturns the unique string that the Google Play Developer Console generated beforehand.\n\nUse it to refer to a leaderboard in your game client. It can only be called when [Leaderboard::Valid()](/games/services/cpp/api/class/gpg/leaderboard#classgpg_1_1_leaderboard_1a510984968ca31ed44aafb18dec22a159) returns true. \n\n### Leaderboard\n\n```c++\n Leaderboard()\n``` \n\n### Leaderboard\n\n```c++\n Leaderboard(\n std::shared_ptr\u003c const LeaderboardImpl \u003e impl\n)\n``` \nExplicit constructor. \n\n### Leaderboard\n\n```c++\n Leaderboard(\n const Leaderboard & copy_from\n)\n``` \nCopy constructor for copying an existing leaderboard into a new one. \n\n### Leaderboard\n\n```c++\n Leaderboard(\n Leaderboard && move_from\n)\n``` \nConstructor for moving an existing leaderboard into a new one.\n\nr-value-reference version. \n\n### Name\n\n```c++\nconst std::string & Name() const \n``` \nReturns the short name of the leaderboard.\n\nUp to 100 characters. It can only be called when [Achievement::Valid()](/games/services/cpp/api/class/gpg/achievement#classgpg_1_1_achievement_1aaabe36b88537ecef60d5eff48c98038c) returns true. \n\n### Order\n\n```c++\nLeaderboardOrder Order() const \n``` \nReturns whether ascending or descending order is better.\n\nPossible values are \"LARGER_IS_BETTER\" or \"SMALLER_IS_BETTER\". LARGER_IS_BETTER places larger scores at the top (descending). SMALLER_IS_BETTER places smaller scores at the top (ascending). It can only be called when [Achievement::Valid()](/games/services/cpp/api/class/gpg/achievement#classgpg_1_1_achievement_1aaabe36b88537ecef60d5eff48c98038c) returns true. \n\n### Valid\n\n```c++\nbool Valid() const \n``` \nReturns true when the returned leaderboard is populated with data and is accompanied by a successful response status; false for an unpopulated user-created leaderboard or for a populated one accompanied by an unsuccessful response status.\n\nIt must be true for the getter functions on this leaderboard (id, Name, Description, etc.) to be usable. \n\n### operator=\n\n```c++\nLeaderboard & operator=(\n const Leaderboard & copy_from\n)\n``` \nAssignment operator for assigning this leaderboard's value from another leaderboard. \n\n### operator=\n\n```c++\nLeaderboard & operator=(\n Leaderboard && move_from\n)\n``` \nAssignment operator for assigning this leaderboard's value from another leaderboard.\n\nr-value-reference version. \n\n### \\~Leaderboard\n\n```c++\n ~Leaderboard()\n```"]]
