Bảng xếp hạng mới - Nội bộ

Tài liệu liên quan

Giới thiệu mô-đun lưu trữ dữ liệu phiên bản lịch sử

Mô-đun lưu trữ dữ liệu

Được giới thiệu chi tiết trong tài liệu trên, ở đây sẽ giới thiệu ngắn gọn về mô-đun lưu trữ dữ liệu.Lưu trữ dữ liệu là một mô-đun tùy chọn, sau khi kích hoạt, nhà phát triển bản đồ có thể sử dụng bảng dữ liệu trên máy chủ để lưu trữ dữ liệu, thường được sử dụng cho các chức năng như đồng bộ hóa dữ liệu giữa các bản đồ, các trận đấu, bảng xếp hạng, v.v. Bài viết này sẽ tập trung giới thiệu việc sử dụng bảng dữ liệu mới cho chức năng bảng xếp hạng.

Cổng vào

Tải mô-đun lưu trữ dữ liệu từ danh sách mô-đun, sau đó có thể bắt đầu cấu hình thông tin cột của bốn loại bảng dữ liệu:

Giới thiệu bảng mới

Giống như tất cả các bảng dữ liệu, bạn cần chỉ định một cột “Key” cho mỗi bảng, tức là khóa chính (Primary Key) của bảng. Dữ liệu cột Key phải duy nhất, là cột chỉ mục của toàn bộ bảng. Thông qua việc tìm kiếm Key, bạn có thể xác định hàng dữ liệu được chỉ định của bảng được chỉ định. Khi chỉnh sửa nhiều lần hàng dữ liệu có cùng Key bằng hình ảnh, dữ liệu được chỉnh sửa sau sẽ luôn ghi đè lên dữ liệu trước đó.

Bảng xếp hạng

Bảng xếp hạng là một loại bảng đặc biệt có nhiều cột, bạn có thể tùy chỉnh một số cột để lưu trữ thông tin bổ sung, chẳng hạn như điểm, thời gian tồn tại, tổng thời gian chơi, v.v. Tuy nhiên, bảng xếp hạng phải có một cột dữ liệu (cột Giá trị) để sắp xếp theo thứ tự tăng dần hoặc giảm dần.

Chọn UID làm Key, bảng xếp hạng sẽ tự động chuyển đổi cột Key thành thẻ người chơi:

Bảng biểu đồ

Bảng dữ liệu xếp hạng 1

Bảng dữ liệu nhiều cột

Bảng nhiều cột là một loại bảng hỗ trợ dữ liệu nhiều cột (khác với bảng dữ liệu trước đây chỉ hỗ trợ dữ liệu một cột). Bạn có thể lưu trữ nhiều loại dữ liệu dưới một Key. Trong kịch bản đồ họa, còn cung cấp API để chỉnh sửa bảng xếp hạng và bảng liên kết. Khi KEY giống nhau (ví dụ: đều là UUID của người chơi), bạn có thể chỉnh sửa bảng xếp hạng và bảng dữ liệu nhiều cột cùng lúc bằng một đồ họa cụ thể.

Biểu đồ minh họa

Bảng dữ liệu nhiều cột1

Chức năng bảng xếp hạng

Kích hoạt chức năng

Để kích hoạt chức năng bảng xếp hạng, bạn phải kích hoạt mô-đun lưu trữ dữ liệu trong dự án và tạo ít nhất một bảng dữ liệu bảng xếp hạng.

Sau khi chuẩn bị xong, trong giao diện bản đồ phát hành của Trung tâm sáng tạo, chỉnh sửa bản đồ sắp phát hành, bạn sẽ thấy cài đặt liên quan đến bảng xếp hạng:

Khi bật chức năng này, nút bảng xếp hạng sẽ xuất hiện trên giao diện chi tiết bản đồ của bạn, người chơi có thể xem thông tin bảng xếp hạng do bạn chỉnh sửa tại đây:

Biên tập bảng xếp hạng

Trong giao diện biên tập bảng xếp hạng bản đồ được đăng ở trên, bạn có thể và tạm thời chỉ có thể chọn một bảng dữ liệu để hiển thị thông tin bảng xếp hạng. (Mặc dù bạn có thể sử dụng nhiều bảng để lưu trữ dữ liệu trong dự án)

Bạn có thể chỉnh sửa các nội dung khác của bảng xếp hạng: bao gồm việc hiển thị bảng xếp hạng bên ngoài, sử dụng các cột nào làm kiểu bảng xếp hạng, thứ tự của chúng như thế nào.

Chọn đa ngôn ngữ, bạn có thể chỉnh sửa thủ công thông tin đa ngôn ngữ của tiêu đề bảng xếp hạng:

Các ngôn ngữ không được điền sẽ sử dụng tên cột bảng mặc định.

Sau khi hoàn tất chỉnh sửa, trang web thông tin bản đồ sẽ hiển thị bảng xếp hạng hiện tại của bạn, các ngôn ngữ đa ngôn ngữ sẽ không được hiển thị trong bảng xếp hạng:

Biểu tượng

Sử dụng biểu tượng vào thời điểm thích hợp, chẳng hạn như khi người chơi ghi điểm hoặc khi kết thúc mỗi ván đấu, để lưu trữ dữ liệu vào bảng xếp hạng.

Lưu ý rằng phải là biểu tượng liên quan đến bảng xếp hạng, tham số SheetName mới có thể đọc được bảng xếp hạng đã tạo.

Để thuận tiện hơn cho việc chỉnh sửa hai loại bảng nhiều cột được giới thiệu trong bài hướng dẫn này, chúng tôi đã thêm loại dữ liệu Tuple, một loại bảng đặc biệt. Loại Tuple hỗ trợ tự động nhận dạng giá trị của bảng dữ liệu hoặc bảng xếp hạng được chỉ định để tạo thành một bảng đặc biệt có các phần tử thuộc loại dữ liệu được chỉ định.

Tuple sẽ tự động đọc tất cả các bảng và sử dụng loại dữ liệu của cột bảng làm loại dữ liệu của mục danh sách:

Đối với bảng dữ liệu xếp hạng, một khi cột dữ liệu tùy chỉnh được tạo mới, giá trị thực tế sẽ chứa N cột dữ liệu, do đó cũng sẽ tạo thành một tuple:

Vì vậy, khi sử dụng thực tế, tuple có thể có lồng nhau:

Tuple không tự động cập nhật thông tin như tên cột của bảng, vì vậy khi có thay đổi, cần phải làm mới tuple theo cách thủ công.

Mã

Ví dụ mã:

1. Viết

WriteDBLeaderboardAssociationValue(``"rank"``, ``"test_uid_1"``, {``60``, ``"1:00"``}, ``""``, out var c, out var d)
go

2. Đọc

ReadDBLeaderboardAssociationValue(``"rank"``, ``"test_uid_1"``, out var data, ``""``, out var a, out var b)``var data_normal List<object> = data[``2``] as List<object>``LogWarning(data_normal[``1``])
go

Danh sách API liên quan

1. SetTuple
2. GetTuple
3. WriteDBLeaderboardAssociationValue
4. RemoveFromLeaderboardDataStoreByKey
5. ReadDBLeaderboardAssociationValue
6. WriteToLeaderboardDataStore
7. RemoveFromLeaderboardDataStoreByKey
8. ReadFromLeaderboardDataStore

Đặc biệt, đối với hàm: ReadDBLeaderboardAssociationValue, giá trị trả về của nó là một tuple:

Kết quả: Loại là {rankname_value}Tuple

• {rank, key, value}
• rank: int
• key: string
• value: tuple
• {value, GameCompletionTime}

Đối với hàm: WriteDBLeaderboardAssociationValue, tham số Key và Value:

• Key: Nên chuyển đổi UID của người chơi thành chuỗi ký tự làm khóa, để có thể hiển thị ký hiệu của người chơi trong craftland
• Value：Loại là {rankname} Tuple. Sau khi chọn SheetName, nhấp đúp vào Value để nhanh chóng thêm khối tương ứng
  Để biết thêm thông tin về các tham số và hướng dẫn API, vui lòng sử dụng: Hướng dẫn trên trang web chính thức

Gỡ lỗi cục bộ

Khi chỉnh sửa bản đồ, không thể lấy dữ liệu của người chơi trực tuyến, nhưng Craftland Studio PC cung cấp cách xem dữ liệu được lưu trữ trong quá trình gỡ lỗi thông qua json cục bộ.

Sau khi lưu trữ dữ liệu trong quá trình gỡ lỗi, nhấp vào tùy chọn trong hình để chuyển đến thư mục json cục bộ, thông tin bảng dữ liệu sẽ được lưu trữ dưới dạng json, để nhà phát triển có thể kiểm tra xem logic có chính xác hay không.