Tham khảo SDK

Thông báo, lời mời và phòng chờ

Sao chép trang

Lia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.share và Lia.lobby.

#Thông báo

Máy chủ của bạn gửi thông báo với POST /notifications. Trang của bạn chỉ yêu cầu quyền. Xem Thông báo.

#Lia.requestNotifications()

Hỏi người dùng, trong Lia'bảng thanh toán riêng của bạn, để cho phép ứng dụng của bạn gửi thông báo cho họ. Nếu họ đã làm rồi, nó sẽ trả lời ngay lập tức mà không hỏi.

const { allowed } = await Lia.requestNotifications();

Giải quyết với { allowed }. Lia.notificationsAllowed cũng được cập nhật.

Lỗi	Khi nào
`notifications_off`	Ứng dụng của bạn có thể không gửi thông báo (đội Lia đã tắt chúng cho nó).
`busy`	Một trong những Lia'các màn hình đang mở.

#Mời

Xem Mời và liên kết.

#Lia.inviteFriend(options)

Mở Lia'bộ chọn bạn bè. Mỗi bạn bè được chọn sẽ nhận được một thẻ trong cuộc trò chuyện Lia của họ mở ứng dụng của bạn với startParam của bạn. Tấm bảng cũng cho phép người đó chia sẻ liên kết mời của bạn ở bất cứ đâu.

const { invited } = await Lia.inviteFriend({ startParam: "room-k3x9" });

Tùy chọn	Loại
`startParam`	chuỗi	Tùy chọn. 1 đến 64 chữ cái, số, `_` và `-`.
`idempotencyKey`	chuỗi	Tùy chọn (SDK 1.5). Với cùng một khóa, mỗi người bạn nhận được lời mời đó'thẻ một lần. Xem Khóa không đổi.

Giải quyết với { invited }: true một khi ai đó được mời hoặc liên kết được chia sẻ. Ứng dụng của bạn sẽ không bao giờ biết ai.

Lỗi: bad_start_param, bad_idempotency_key, busy.

#Lia.inviteLink(startParam)

Ứng dụng của bạn'được thương hiệu hóa lialabs.app liên kết khởi động, với startParam tùy chọn. Bất kỳ ai cũng có thể mở nó: với Lia, nó mở ứng dụng của bạn với startParam; không có, nó trỏ đến Cửa hàng Ứng dụng. Gọi nó sau Lia.init().

const link = Lia.inviteLink("room-k3x9");
// "https://your-app.lialabs.app/play?start=room-k3x9"

Trả về một chuỗi (không phải là một lời hứa). Ném not_ready trước init() đã trả lời, và bad_start_param cho một startParam mà không'phù hợp.

Mở điện thoại'bảng chia sẻ với văn bản của bạn, cho bất kỳ ứng dụng nào trên điện thoại. Kết thúc với null một khi bảng tính đóng.

await Lia.share("I scored 1280 in Tilt Runner. Beat me: " + Lia.inviteLink());

Tham số	Loại
`text`	chuỗi	Tối đa 500 ký tự.

Lỗi: bad_text.

#Phòng chờ

Bảng công khai mà bất kỳ ai trên Lia có thể tìm thấy (SDK 1.6). Máy chủ của bạn liệt kê và đặt chỗ cho họ; xem Bảng công khai.

#Lia.lobby

#Lia.lobby.tables(options)

Các bảng mở trong ứng dụng của bạn, mới nhất trước. Không phải người chơi'các bảng riêng của bạn, bảng đầy đủ hoặc hết hạn, hoặc của bất kỳ ai họ chặn hoặc người đã chặn họ.

const { tables, next } = await Lia.lobby.tables({ stake: 5 });
// [{ id: "t8k2d", game: "your-app", host: { name: "amara" }, seats: 2, taken: 1, title: "Quick game", stake: 5, pot: 0, createdAt, expiresAt }]
const more = next ? await Lia.lobby.tables({ stake: 5, cursor: next }) : null;

Tùy chọn	Loại
`stake`	số	Tùy chọn. Chỉ các bảng tại mức cược này, trong LIA (`0` cho các bản miễn phí).
`cursor`	chuỗi	Tùy chọn. `next` từ trang trước.
`limit`	số	Tùy chọn. 1 đến 50, 20 theo mặc định.

Giải quyết với { tables, next }: next là con trỏ để xem thêm, hoặc null. Mỗi bảng:

Trường	Loại
`id`	chuỗi	Bảng'id, như đã liệt kê trên máy chủ của bạn.
`game`	chuỗi	Ứng dụng của bạn'id của nó.
`host`	đối tượng	`{ name }`: chủ's Lia tên người dùng.
`seats`, `taken`	số	Tổng số ghế, và ghế đã được chiếm (chủ bàn'được bao gồm).
`title`	chuỗi hoặc null	Tối đa 40 ký tự.
`stake`, `pot`	số	Trong LIA, khai báo các loại như máy chủ của bạn liệt kê (để hiển thị).
`createdAt`, `expiresAt`	số	Miligiây kể từ 1970.

Ngồi xuống, gửi bàn's id đến máy chủ của bạn, nơi đặt người chơi với POST /lobby/tables/:id/sit. Một người đã chọn bảng của bạn trong Lia'lobby riêng của họ đến với Lia.startParam được đặt thành lobby-<table id>: đặt họ theo cùng một cách.

Lỗi: bad_stake, bad_cursor, bad_session (phiên làm việc không't được gia hạn), not_in_lia.

#Lia.lobby.report(playerId, reason, options)

Báo cáo người chơi cho đội Lia. Họ'cũng bị chặn đối với người báo cáo, vì vậy cả hai không thể nhìn thấy nhau'bảng dữ liệu lại.

await Lia.lobby.report("p_3f9c0a6d1b2e4f5a6b7c", "unfair", { tableId: "t8k2d", note: "Left every game when losing" });

Tham số	Loại
`playerId`	chuỗi	Người chơi'id của nó trong ứng dụng của bạn.
`reason`	chuỗi	`"name"`, `"unfair"`, `"abuse"` hoặc `"other"`.
`options.tableId`	chuỗi	Tùy chọn. Bàn nào đã xảy ra.
`options.note`	chuỗi	Tùy chọn, tối đa 300 ký tự.

Giải quyết với { reported: true }. Lỗi: bad_reason, unknown_player, slow_down (nhiều hơn 20 báo cáo trong một ngày), bad_note, bad_tableId.

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