概念

通知

复制页面

玩家可以选择是否允许你的应用通知他们。你的服务器在 Lia 设定的限制内发送每条通知，这样那些说好的人会很高兴他们这么做了。

#它们如何工作

这个人允许他们您的页面调用 Lia.requestNotifications() 在合适的时候，并Lia会在自己的表格中询问。人们也可以从其⋯菜单中打开或关闭你的应用的通知。
您的服务器发送一个POST /notifications 与玩家的ID，文本和一个可选的 startParam.
它会到达他们的手机在您的应用名称下，作为推送消息和Lia的铃声。点击它会用您的 startParam.

#提问

在通知明显对用户有帮助时提问：他们的回合，送货，朋友加入。不要't 在你的应用打开时询问。

if (!Lia.notificationsAllowed) {
  const { allowed } = await Lia.requestNotifications();
  if (allowed) tellYourServer(); // so it knows it may notify this player
}

如果他们已经允许了它们， requestNotifications() 答案 { allowed: true } 无需询问。
如果你的应用程序可能根本不会发送通知（Lia团队已关闭了它们），则会失败并显示 notifications_off.
Lia.notificationsAllowed 说明当前的情况，以及 notificationsChanged 当某人更改它时触发事件，无论是通过你的请求还是⋯菜单。

Lia不能'当有人允许或停止通知时告诉您的服务器。自己告诉它，或者直接发送并处理 not_allowed.

#发送中

{ "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "text": "It's your move against @amara.", "startParam": "match-8k2d" }

查看 POST /notifications 对于每个字段和答案。

#限制

通知是人们给予您的应用的特权，因此Lia会保持其数量很少：

限制	直播	测试
谁	允许你的应用的玩家'的通知	允许他们的人
一天，从你的应用到一个人	您的应用程序'的每日数量，3，除非Lia团队更改了它	那个数字，以及至少 20
从您的应用到一个人	1小时	30 秒
一天，所有应用总共到一个人	6	不计入
文本	1到180个字符，空格和换行符变为单个空格	相同
文本中不允许	链接、电话号码和用于诈骗的词语（如 Lia'的聊天)	相同

当达到限制时， POST /notifications 答案 429 rate_limited。对于你的应用'自己的限制还会说明你何时可以再次尝试，例如 retryAt （自 1970 起的毫秒数）。

"一天" 是您应用的最后 24 小时'的限制，以及这个人'的日历日，来自所有应用的总和。

#从一个打开您的应用

一个通知打开你的应用与它的 startParam （1 到 64 个字母、数字， _ 和 -），您的页面会从这里读取 Lia.startParam。如果在用户点击时你的应用已经打开，你的页面会听到一个 startParam 事件代替。

function route(param) {
  if (param && param.startsWith("match-")) openMatch(param);
}
Lia.init().then(function () { route(Lia.startParam); Lia.ready(); });
Lia.on("startParam", function (data) { route(data.startParam); });

#推送和铃声

每个通知都会发送到Lia'的铃声。它's 也推送给那个人'他们有Lia时的手机'的推送开启； POST /notifications 答案 pushed: false 当它只到达了铃铛。

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