--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/games/doc/en/sdk/construct-3/leaderboards.md - https://yandex.com/dev/games/doc/hi/sdk/construct-3/leaderboards.md - https://yandex.com/dev/games/doc/ko/sdk/construct-3/leaderboards.md - https://yandex.com/dev/games/doc/ru/sdk/construct-3/leaderboards.md - https://yandex.com/dev/games/doc/tr/sdk/construct-3/leaderboards.md - https://yandex.com/dev/games/doc/vi/sdk/construct-3/leaderboards.md - https://yandex.com/dev/games/doc/zh/sdk/construct-3/leaderboards.md - href: vi/sdk/construct-3/leaderboards.md type: text/markdown title: Markdown version - href: ../../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/games/doc/vi/llms.txt # Bảng xếp hạng Bạn có thể hiển thị các bảng xếp hạng cá nhân hóa trên trang chơi với kết quả của những người chơi xuất sắc và vị trí trong bảng xếp hạng của người dùng đã đăng nhập. Để các yêu cầu được mô tả dưới đây hoạt động, hãy kiểm tra rằng bạn đã tạo [bảng xếp hạng](https://yandex.com/dev/games/doc/vi/sdk/sdk-leaderboard.md) trong công cụ quản lý phát triển. ## Gửi điểm số {% note info "Ghi chú" %} Yêu cầu chỉ có sẵn cho người dùng đã đăng nhập. Được gợi ý nên đăng nhập trước và sử dụng bảng xếp hạng chỉ khi người dùng đã cung cấp thông tin cá nhân. ![](../../_images/construct-3/leaderboards/player-pre-auth.png) {% endnote %} Sử dụng hành động **Set leaderboard score** để gửi điểm mới vào bảng xếp hạng với các tham số: #| || Name | `string` | Tên kỹ thuật của bảng xếp hạng. || || Score | `number` | Điểm của người chơi trong bảng xếp hạng. || || Additional data | `string` | Dữ liệu meta không bắt buộc, được gửi cùng với điểm. || |# Ví dụ, việc gửi điểm vào bảng xếp hạng có thể được thực hiện như sau: ![](../../_images/construct-3/leaderboards/leaderboard-set-score-example.png) {% note info "Ghi chú" %} Yêu cầu chỉ có thể được gửi không vượt quá một lần mỗi giây, ngược lại nó sẽ bị loại vì lỗi. Được gợi ý sử dụng gửi điểm với điều kiện đặc biệt **On a deferred event**. ![](../../_images/construct-3/leaderboards/leaderboard-debounce-example.png) {% endnote %} ## Lập ký bảng xếp hạng Để hiển thị xếp hạng người dùng, sử dụng vòng lặp **For each player in leaderboard** với các tham số: #| || Name | `string` | Tên kỹ thuật của bảng xếp hạng. || || Top positions | `number` | Số lượng yêu cầu lấy ra từ đầu bảng xếp hạng. || || Request player position | `boolean` | Xác định liệu vị trí của người dùng sẽ được yêu cầu hay không. || || Positions around player | `number` | Số lượng yêu cầu lấy ra dưới và trên người dùng trong bảng. || |# Plugin sẽ yêu cầu dữ liệu về bảng xếp hạng qua SDK của Yandex Games, sau đó vòng lặp sẽ bắt đầu. Quá trình này chiếm một khoảng thời gian. Được gợi ý là để lại một biểu tượng tải trên màn hình cho đến khi quá trình hoàn tất. {% note warning "Cảnh báo" %} Hãy chắc chắn rằng vòng lặp này không được gọi liên tục. Được gợi ý sử dụng nó trong các hàm hoặc cảm ứng. {% endnote %} Trong vòng lặp, bạn sẽ có trải nghiệm truy cập vào các biểu thức từ danh sách: **Player** và **Leaderboards** . ![](../../_images/construct-3/leaderboards/player-expressions.png) ![](../../_images/construct-3/leaderboards/leaderboards-expressions.png) ## Ví dụ bảng xếp hạng Ví dụ thực hiện hiển thị bảng xếp hạng: - Bánh xe tải trước khi hiển thị bảng xếp hạng. - Hiển thị điểm và tên. - Hiển thị ảnh đại diện của người chơi. - Hiển thị vị trí của người chơi trong bảng xếp hạng. Ví dụ này sử dụng [Bản địa hóa văn bản](https://yandex.com/dev/games/doc/vi/sdk/construct-3/text-localization.md), [Dịch hình ảnh (sprite)](https://yandex.com/dev/games/doc/vi/sdk/construct-3/sprite.md) và cũng như plugin [Văn bản thích ứng](https://yandex.com/dev/games/doc/vi/sdk/construct-3/adaptive-text.md). ![](../../_images/construct-3/leaderboards/leaderboard-example.png) [Tải xuống một ví dụ](https://drive.google.com/file/d/1dVlhKonwFrBjzMQn3u8D2hhW7w_hlzN_/edit) --- Kho lưu trữ