SDK 参考

通知、邀请和大厅

复制页面

Lia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.share and Lia.lobby.

#通知

您的服务器通过 POST /notifications。您的页面只需请求权限。参见通知.

#Lia.requestNotifications()

在Lia中询问用户'自己的表格，让你的应用可以给他们发送通知。如果他们已经这样做过，它会立即回答而不会询问。

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

以 { allowed }. Lia.notificationsAllowed 也被更新了。

错误	何时
`notifications_off`	您的应用程序可能无法发送通知（Lia 团队已将其关闭）。
`busy`	Lia 的另一个'的屏幕已打开。

#邀请

查看邀请和链接.

#Lia.inviteFriend(options)

打开 Lia'的好友选择器。每个被选中的好友会在他们的 Lia 聊天中收到一张卡片，点击后打开你的应用并使用你的 startParam。该面板还允许人们将你的邀请链接分享到任何地方。

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

选项	类型
`startParam`	字符串	可选。1 到 64 个字母、数字， `_` 和 `-`.
`idempotencyKey`	字符串	可选 (SDK 1.5)。使用相同的密钥，每个朋友都会获得该邀请'的卡片一次。参见幂等性密钥.

以 { invited }: true 一旦有人被邀请或链接被分享。您的应用永远不会知道是谁。

错误： bad_start_param, bad_idempotency_key, busy.

#Lia.inviteLink(startParam)

您的应用程序'的品牌化 lialabs.app 启动链接，带有一个可选的startParam。任何人都可以打开它：使用Lia，它会用startParam 打开你的应用；不使用的话，它会指向应用商店。在调用它时 Lia.init().

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

返回一个字符串（不是承诺）。抛出 not_ready 之前 init() 已经回答，而且 bad_start_param 对于一个 startParam，它'不要适合。

打开手机'的分享表单，与你的文字一起，用于手机上的任何应用。以 null 一旦表格关闭。

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

参数	类型
`text`	字符串	最多500 个字符。

错误： bad_text.

#大厅

任何在 Lia 上的人都可以找到的公共表格 (SDK 1.6)。你的服务器列出并安排它们；参见公共表格.

#Lia.lobby

#Lia.lobby.tables(options)

你应用中打开的表格，按最新排序。永远不是玩家'自己的表格，完整的或过期的，或者任何他们阻止的人或阻止他们的人的表格。

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;

选项	类型
`stake`	数字	可选。仅在此下注金额的表格，在 LIA（`0` 对于免费的）。
`cursor`	字符串	可选。 `next` 从上一页。
`limit`	数字	可选。1 到 50, 20 默认。

以 { tables, next }: next 是更多光标，或 null。每个表格：

字段	类型
`id`	字符串	表格'的id，如您的服务器所列。
`game`	字符串	您的应用程序'的id。
`host`	对象	`{ name }`: 主机's Lia 的用户名。
`seats`, `taken`	数字	总共的座位数，以及已占用的座位（主机'包含）。
`title`	字符串或空值	最多40 个字符。
`stake`, `pot`	数字	在LIA中，按照你的服务器列出的（用于显示）。
`createdAt`, `expiresAt`	数字	自1970. 以来的毫秒数

坐下，发送桌子's id 到你的服务器，它会将玩家安排到 POST /lobby/tables/:id/sit。在Lia中选择了你的表格的人'自己的大厅到达时有 Lia.startParam 设置为 lobby-<table id>: 让他们以相同的方式就座。

错误： bad_stake, bad_cursor, bad_session （会话没有't 被续订）， not_in_lia.

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

向 Lia 团队举报一名玩家。他们'也对报告者进行了阻止，因此他们彼此看不到对方'的表格再次。

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

参数	类型
`playerId`	字符串	玩家'的应用中的id。
`reason`	字符串	`"name"`, `"unfair"`, `"abuse"` 或 `"other"`.
`options.tableId`	字符串	可选。发生该情况的桌子。
`options.note`	字符串	可选，最多 300 个字符。

以 { reported: true }。错误： bad_reason, unknown_player, slow_down （一天内超过 20 次报告）， bad_note, bad_tableId.

自动翻译。英语是真实来源。阅读英文