Khái niệm

Mỗi người chơi đến với trạng thái đã đăng nhập như một người chơi của ứng dụng của bạn, với một ID chỉ dành riêng cho ứng dụng của bạn. Các token phiên cho phép máy chủ của bạn biết ai đang yêu cầu.

#Người chơi

Mọi người không bao giờ đăng nhập vào ứng dụng của bạn: Lia làm thay họ. Lần đầu tiên ai đó mở ứng dụng của bạn, Lia tạo cho họ một người chơi của nó. Lia.init() cung cấp cho bạn:

{
  "player": { "id": "p_3f9c0a6d1b2e4f5a6b7c", "name": "amara" },
  "session": "lias_eyJhcHAiOi…",
  "exp": 1761998400000,
  "mode": "live"
}

• player.id là người này'id của nó trong ứng dụng của bạn. Nó luôn giữ nguyên mỗi lần họ mở ứng dụng, trên bất kỳ điện thoại nào. Nó'giả danh: nó'chỉ dành cho ứng dụng của bạn, không bao giờ tài khoản Lia của họ, và một ứng dụng khác sẽ có một id khác nhau cho cùng một người. Sử dụng nó như khóa cho mọi thứ bạn lưu trữ về một người chơi.
• player.name là tên người dùng Lia của họ, không có @. Nó'công khai và có thể thay đổi; Lia sẽ giữ nó cập nhật mỗi lần họ mở ứng dụng của bạn. Hiển thị nó, nhưng đừng'không thể khóa bất cứ thứ gì trên nó.

Lia không cung cấp người dùng cho ứng dụng của bạn'email, số điện thoại, số dư hoặc bất kỳ thông tin nào khác về tài khoản của họ.

#Phiên

Trang của bạn có thể'chứng minh ai là người gửi đến máy chủ của bạn: bất kỳ ai cũng có thể gửi một yêu cầu đến máy chủ của bạn, giả vờ là bất kỳ người chơi nào. Vì vậy Lia cấp cho trang web của bạn một token phiên làm việc, được ký bởi Lia, mà máy chủ của bạn kiểm tra với Lia.

• Lia.init() câu trả lời với một session và khi nó kết thúc, exp (mili giây kể từ 1970).
• Một phiên kéo dài 15 phút. Nhận một cái mới với Lia.session() mỗi khi bạn cần; nó trả lời { session, exp }.
• Một phiên đặt tên cho ứng dụng của bạn, người chơi và chế độ (thử nghiệm hoặc trực tiếp). Một mã thông báo từ ứng dụng khác, từ chế độ khác hoặc đã hết hạn không hợp lệ.

// In your page: send a fresh session with anything your server must trust.
const { session } = await Lia.session();
await fetch("/api/claim", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ session, chargeId }),
});

Máy chủ của bạn gửi token đến POST /session/verify với khóa bí mật của bạn và nhận lại id người chơi:

{ "valid": true, "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "mode": "live", "exp": 1761998400000 }

#Chế độ

Mỗi phiên đều ở trong một chế độ, test hoặc live, và mọi khóa đều như vậy. Khóa thử nghiệm chỉ xác minh các phiên bản thử nghiệm và khóa live chỉ xác minh các phiên bản live. Xem Kiểm tra và trực tiếp.

#Lia'các bản ghi riêng của người chơi

Một số thứ Lia lưu trữ theo người chơi trong ứng dụng của bạn, vì vậy bạn không thể'bạn cần một máy chủ cho chúng:

• Họ điểm số cao nhất và đặt trên bảng xếp hạng.
• Họ lưu trữ đám mây: lên đến 1024 khóa.
• Liệu họ đã cho phép thông báo của bạn.
• Họ phí, thưởng và xem video, mà máy chủ của bạn có thể tra cứu.

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