Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
gpg::Hình chữ nhật dài
#include <leaderboard.h>
Một cấu trúc dữ liệu duy nhất cho phép bạn truy cập dữ liệu về trạng thái của một bảng xếp hạng cụ thể, chẳng hạn như tên và tính hợp lệ của bảng xếp hạng đó.
Tóm tắt
Hàm công khai
|
IconUrl() const
|
const std::string &
Trả về URL dẫn đến hình ảnh của biểu tượng cho Bảng xếp hạng này. |
Id() const
|
const std::string &
Trả về chuỗi duy nhất mà Bảng điều khiển dành cho nhà phát triển trên Google Play đã tạo trước đó.
|
Name() const
|
const std::string &
Trả về tên ngắn của bảng xếp hạng.
|
Order() const
|
Trả về thứ tự tăng dần hay giảm dần tốt hơn.
|
Valid() const
|
bool
Trả về true khi bảng xếp hạng được trả về có dữ liệu và kèm theo trạng thái phản hồi thành công; false cho bảng xếp hạng do người dùng tạo không được điền hoặc cho bảng xếp hạng được điền sẵn kèm theo trạng thái phản hồi không thành công.
|
operator=(const Leaderboard & copy_from)
|
Toán tử gán để chỉ định giá trị của bảng xếp hạng này từ một bảng xếp hạng khác.
|
operator=(Leaderboard && move_from)
|
Toán tử gán để chỉ định giá trị của bảng xếp hạng này từ một bảng xếp hạng khác.
|
Hàm công khai
IconUrl
const std::string & IconUrl() const
Id
const std::string & Id() const
Trả về chuỗi duy nhất mà Bảng điều khiển dành cho nhà phát triển trên Google Play đã tạo trước đó.
Hãy sử dụng thuộc tính này để tham chiếu đến một bảng xếp hạng trong ứng dụng trò chơi của bạn. Phương thức này chỉ có thể được gọi khi Leaderboard::Valid() trả về giá trị true.
Bảng dẫn
Leaderboard()
Bảng dẫn
Leaderboard(
std::shared_ptr< const LeaderboardImpl > impl
)
Bảng dẫn
Leaderboard(
const Leaderboard & copy_from
)
Sao chép hàm khởi tạo để sao chép một bảng xếp hạng hiện có sang một bảng xếp hạng mới.
Bảng dẫn
Leaderboard(
Leaderboard && move_from
)
Hàm khởi tạo để di chuyển một bảng xếp hạng hiện có sang một bảng xếp hạng mới.
phiên bản tham chiếu r-value.
Tên
const std::string & Name() const
Trả về tên ngắn của bảng xếp hạng.
Tối đa 100 ký tự. Hệ thống chỉ có thể gọi lệnh khi Achievement::Valid() trả về giá trị true.
Đặt
LeaderboardOrder Order() const
Trả về thứ tự tăng dần hay giảm dần tốt hơn.
Giá trị có thể là "LARGER_IS_BETTER" hoặc "SmallER_IS_BETTER". LARGER_IS_BETTER đặt điểm số lớn hơn ở trên cùng (giảm dần). SmallER_IS_BETTER đặt điểm số nhỏ hơn ở trên cùng (tăng dần). Hàm này chỉ có thể được gọi khi Achievement::Valid() trả về giá trị true.
Hợp lệ
bool Valid() const
Trả về true khi bảng xếp hạng được trả về có dữ liệu và kèm theo trạng thái phản hồi thành công; false cho bảng xếp hạng do người dùng tạo không được điền hoặc cho bảng xếp hạng được điền sẵn kèm theo trạng thái phản hồi không thành công.
Giá trị này phải đúng thì các hàm getter trên bảng xếp hạng này (mã nhận dạng, Tên, Nội dung mô tả, v.v.) mới có thể sử dụng được.
operator=
Leaderboard & operator=(
const Leaderboard & copy_from
)
Toán tử gán để chỉ định giá trị của bảng xếp hạng này từ một bảng xếp hạng khác.
operator=
Leaderboard & operator=(
Leaderboard && move_from
)
Toán tử gán để chỉ định giá trị của bảng xếp hạng này từ một bảng xếp hạng khác.
phiên bản tham chiếu r-value.
~Hình chữ nhật dài
~Leaderboard()
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],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```"]]
