Khái niệm

Người chơi chọn xem ứng dụng của bạn có thể thông báo cho họ hay không. Máy chủ của bạn gửi từng thông báo, trong giới hạn Lia đặt ra để những người đồng ý vẫn hài lòng.

#Cách chúng hoạt động

1. Người cho phép họTrang của bạn gọi Lia.requestNotifications() vào một thời điểm tốt, và Lia hỏi trong bảng tính của nó. Người dùng cũng có thể bật hoặc tắt thông báo của ứng dụng từ menu ⋯.
2. Máy chủ của bạn gửi mộtPOST /notifications với id người chơi, văn bản và một tùy chọn startParam.
3. Nó đến điện thoại của họDưới tên ứng dụng của bạn, dưới dạng thông báo và trong chuông của Lia. Nhấn vào nó sẽ mở ứng dụng của bạn với startParam.

#Hỏi

Hỏi khi thông báo rõ ràng sẽ giúp người đó: lượt của họ trong trò chơi, giao hàng, bạn bè tham gia. Đừng't hỏi ngay lúc ứng dụng của bạn mở ra.

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

• Nếu họ đã cho phép chúng, requestNotifications() câu trả lời { allowed: true } không cần hỏi.
• Nếu ứng dụng của bạn có thể không gửi thông báo tại tất cả (nhóm Lia đã tắt chúng), nó sẽ thất bại với notifications_off.
• Lia.notificationsAllowed nói về tình hình hiện tại, và notificationsChanged sự kiện xảy ra khi người khác thay đổi nó, từ yêu cầu của bạn hoặc từ menu ⋯.

Lia không thể'thông báo cho máy chủ của bạn khi ai đó cho phép hoặc dừng thông báo. Thông báo cho nó tự mình, hoặc chỉ gửi và xử lý not_allowed.

#Đang gửi

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

Xem POST /notifications cho mỗi trường và câu trả lời.

#Giới hạn

Thông báo là đặc quyền mà mọi người trao cho ứng dụng của bạn, vì vậy Lia giữ chúng ít:

Khi đạt giới hạn, POST /notifications câu trả lời 429 rate_limited. Đối với ứng dụng của bạn'giới hạn riêng của họ cũng nói khi bạn có thể thử lại, như retryAt (mili giây kể từ 1970).

"Một ngày" là 24 giờ cuối cùng cho ứng dụng của bạn'giới hạn của nó, và người'ngày lịch cho tổng số từ tất cả các ứng dụng.

#Mở ứng dụng của bạn từ một

Một thông báo mở ứng dụng của bạn với startParam (1 đến 64 chữ cái, chữ số, _ và -), mà trang web của bạn đọc từ Lia.startParam. Nếu ứng dụng của bạn đã mở trước khi người đó chạm vào, trang của bạn sẽ nghe được một startParam sự kiện thay vào đó.

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); });

#Thông báo và chuông

Mỗi thông báo đi đến Lia'chuông. Nó's câu trả lời.'điện thoại khi họ có Lia'bật thông báo; POST /notifications câu trả lời pushed: false khi nó chỉ đạt đến chuông.

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