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 trong công cụ quản lý phát triển.

Gửi điểm số

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.

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:

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.

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.

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.

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: PlayerLeaderboards .

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, Dịch hình ảnh (sprite) và cũng như plugin Văn bản thích ứng.

Tải xuống một ví dụ


Kho lưu trữ