gpg:: تابلوی امتیازات
#include <leaderboard.h>یک ساختار داده واحد که به شما امکان می دهد به داده های مربوط به وضعیت یک تابلوی امتیاز خاص مانند نام و اعتبار آن دسترسی داشته باشید.
خلاصه
سازندگان و ویرانگرها | |
|---|---|
Leaderboard () | |
Leaderboard (std::shared_ptr< const LeaderboardImpl > impl) سازنده صریح. | |
Leaderboard (const Leaderboard & copy_from) کپی سازنده برای کپی کردن تابلوی امتیازات موجود در تابلوی جدید. | |
Leaderboard ( Leaderboard && move_from) سازنده برای انتقال تابلوی امتیازات موجود به تابلوی جدید. | |
~Leaderboard () |
توابع عمومی | |
|---|---|
IconUrl () const | const std::string & URL منتهی به تصویر نماد این تابلوی امتیازات را برمی گرداند. |
Id () const | const std::string & رشته منحصربه‌فردی را که کنسول برنامه‌نویس Google Play از قبل ایجاد کرده بود، برمی‌گرداند. |
Name () const | const std::string & نام کوتاه تابلوی امتیازات را برمی‌گرداند. |
Order () const | به ترتیب صعودی یا نزولی بهتر است. |
Valid () const | bool زمانی که تابلوی امتیازات بازگشتی پر از داده باشد و با وضعیت پاسخ موفقیت آمیز همراه شود، مقدار true را برمی گرداند. برای تابلوی امتیازات ایجاد شده توسط کاربر خالی از جمعیت یا برای تابلوی پر جمعیت همراه با وضعیت پاسخ ناموفق. |
operator= (const Leaderboard & copy_from) | عملگر انتساب برای تخصیص مقدار این تابلوی امتیازات از تابلوی امتیازات دیگر. |
operator= ( Leaderboard && move_from) | عملگر انتساب برای تخصیص مقدار این تابلوی امتیازات از تابلوی امتیازات دیگر. |
توابع عمومی
IconUrl
const std::string & IconUrl() const
URL منتهی به تصویر نماد این تابلوی امتیازات را برمی گرداند.
فقط زمانی می توان آن را فراخوانی کرد که Leaderboard::Valid() true را برگرداند.
شناسه
const std::string & Id() const
رشته منحصربه‌فردی را که کنسول برنامه‌نویس Google Play از قبل ایجاد کرده بود، برمی‌گرداند.
از آن برای ارجاع به تابلوی امتیازات در مشتری بازی خود استفاده کنید. فقط زمانی می توان آن را فراخوانی کرد که Leaderboard::Valid() true را برگرداند.
تابلوی امتیازات
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
زمانی که تابلوی امتیازات بازگشتی پر از داده باشد و با وضعیت پاسخ موفقیت آمیز همراه شود، مقدار true را برمی گرداند. برای تابلوی امتیازات ایجاد شده توسط کاربر خالی از جمعیت یا برای تابلوی پر جمعیت همراه با وضعیت پاسخ ناموفق.
برای اینکه توابع گیرنده در این تابلوی امتیازات (id، نام، توضیحات و غیره) قابل استفاده باشند، باید درست باشد.
اپراتور=
Leaderboard & operator=( const Leaderboard & copy_from )
عملگر انتساب برای تخصیص مقدار این تابلوی امتیازات از تابلوی امتیازات دیگر.
اپراتور=
Leaderboard & operator=( Leaderboard && move_from )
عملگر انتساب برای تخصیص مقدار این تابلوی امتیازات از تابلوی امتیازات دیگر.
نسخه r-value-reference.
~ تابلوی امتیازات
~Leaderboard()
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],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```"]]