Tham khảo SDK

Điểm số và lưu trữ

Sao chép trang

Bảng xếp hạng mà không có máy chủ riêng của bạn, và ba loại lưu trữ. Lưu trữ đám mây theo người chơi đến bất kỳ điện thoại nào; lưu trữ thiết bị và an toàn ở lại trên thiết bị này.

#Điểm số

Mỗi ứng dụng có một bảng xếp hạng. Chỉ có một người chơi'điểm cao nhất của bạn được tính.

#Lia.submitScore(score, options)

Ghi lại điểm số. Nếu nó vượt qua người chơi'điểm cao nhất, nó trở thành điểm cao nhất của họ.

const { best } = await Lia.submitScore(1280);

Tham số	Loại
`score`	số	Một số nguyên, 0 đến 1,000,000,000,000. Càng cao càng tốt.
`options.idempotencyKey`	chuỗi	Tùy chọn (SDK 1.5). Xem Khóa không đổi.

Giải quyết với { best }: người chơi'điểm cao nhất hiện tại. Lỗi: bad_score, bad_idempotency_key, not_open.

#Lia.leaderboard()

Phần trên 50, và vị trí của người chơi này.

const { top, me } = await Lia.leaderboard();

Giải quyết với:

{
  "top": [
    { "rank": 1, "name": "amara", "score": 4210, "me": false },
    { "rank": 2, "name": "kofi", "score": 3990, "me": true }
  ],
  "me": { "rank": 2, "score": 3990 }
}

name là tên người dùng Lia. Các liên kết sẽ được trao cho người đến trước. me là null cho đến khi người chơi có điểm số.

#Lưu trữ

	Ở đâu	Giới hạn	Đối với
`Lia.cloudStorage`	Lia'máy chủ, mỗi người chơi	1024 khóa, giá trị lên đến 4096 ký tự	Tiến trình và cài đặt theo người chơi đến bất kỳ điện thoại nào
`Lia.deviceStorage`	Chiếc điện thoại này, cho ứng dụng của bạn	5 MB trong tất cả	Bộ nhớ đệm và bản nháp
`Lia.secureStorage`	Chiếc điện thoại này'kho lưu trữ bảo mật (Keychain trên iPhone)	10 mục, giá trị lên đến 2048 ký tự	Tokens và bí mật

Mỗi ứng dụng chỉ xem được khóa riêng của nó. Các khóa được 1 đến 128 của các chữ cái, chữ số, _ và -; giá trị là văn bản (lưu JSON với JSON.stringify). Khóa và giá trị sai sẽ bị từ chối với bad_key, bad_keys hoặc bad_value.

#Lia.cloudStorage

Trên Lia'máy chủ, cho người chơi này trong ứng dụng của bạn, trên bất kỳ điện thoại nào. Kiểm tra và chia sẻ bản phát hành.

await Lia.cloudStorage.setItem("progress", JSON.stringify({ level: 7, coins: 120 }));
const progress = JSON.parse((await Lia.cloudStorage.getItem("progress")) ?? "{}");

Phương pháp	Giải quyết với
`Lia.cloudStorage.setItem(key, value, options)`	`true`. Thất bại với `storage_full` tại 1024 khóa.
`Lia.cloudStorage.getItem(key)`	Giá trị, hoặc `null`.
`Lia.cloudStorage.getItems(keys)`	Một đối tượng chứa các khóa tồn tại và giá trị của chúng. 1 đến 100 khóa.
`Lia.cloudStorage.removeItem(key, options)`	`true`
`Lia.cloudStorage.removeItems(keys, options)`	`true`. 1 đến 100 khóa.
`Lia.cloudStorage.getKeys()`	Tất cả những người chơi này'khóa, được sắp xếp.

Các ghi chép có tùy chọn { idempotencyKey } cuối cùng (SDK 1.5), vì vậy một lần thử lại muộn của một ghi viết cũ sẽ không bao giờ ghi đè lên một giá trị mới hơn. Xem Khóa không đổi.

Lỗi: not_open (gọi init() đầu tiên), storage_full, bad_item, bad_keys, bad_idempotency_key.

#Lia.deviceStorage

Chỉ trên điện thoại này, cho ứng dụng của bạn. Biến mất nếu người đó xóa Lia hoặc chuyển sang điện thoại khác.

Phương pháp	Giải quyết với
`Lia.deviceStorage.setItem(key, value)`	`true`. Giá trị lên đến 1,048,576 ký tự; tất cả những gì ứng dụng của bạn lưu trữ cùng nhau (các khóa và giá trị) lên đến 5 MB, hoặc `storage_full`.
`Lia.deviceStorage.getItem(key)`	Giá trị, hoặc `null`.
`Lia.deviceStorage.removeItem(key)`	`true`
`Lia.deviceStorage.clear()`	`true`. Xóa toàn bộ ứng dụng của bạn'khóa trên điện thoại này.

#Lia.secureStorage

Trên điện thoại'kho lưu trữ bảo mật (Keychain trên iPhone), cho ứng dụng của bạn.

Phương pháp	Giải quyết với
`Lia.secureStorage.setItem(key, value)`	`true`. Giá trị lên đến 2048 ký tự; tối đa 10 mục, hoặc `storage_full`.
`Lia.secureStorage.getItem(key)`	Giá trị, hoặc `null`.
`Lia.secureStorage.removeItem(key)`	`true`
`Lia.secureStorage.clear()`	`true`

Trang của bạn'riêng của họ localStorage cũng hoạt động, nhưng nó'mà liên quan đến Lia'mà trình duyệt web và có thể bị xóa; nên ưu tiên những cái này.

Được dịch tự động. Tiếng Anh là nguồn tin cậy. Đọc bằng tiếng Anh