Konsepto

Pumili ang mga manlalaro kung maaari ang iyong app na magbigay ng alarma. Ang iyong server nagpapadala ng bawat alarma, sa loob ng mga limitasyon na Lia ang nagtakda upang ang mga taong sumagot na oo ay manatili sa kanilang kasiyahan.

#Paano sila gumagana

1. Ang tao ay pinahintulutan nilaAng iyong pahina ay tumatawag Lia.requestNotifications() sa isang magandang oras, at Lia ay humihingi sa kanyang sariling sheet. Ang mga tao ay maaari ring i-on o i-off ang mga notification ng iyong app mula sa kanyang ⋯ menu.
2. Ang iyong server ay nagpapadala ng isangPOST /notifications kasama ang player's id, ang teksto at isang opsyonal na startParam.
3. Nakarating sa kanilang teleponoSa ilalim ng pangalan ng iyong app, bilang isang push at sa Lia's bell. Pagtapat nito ay buksan ang iyong app na may iyong startParam.

#Pagtanong

Magtanong kung ang isang notification ay magiging kapaki-pakinabang para sa tao: ang kanilang turn sa laro, isang paghahatid, isang kaibigan na sumali. Huwag't tanungin ang sandali kung ang iyong app ay buksan.

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

• Kung sila ay nag-allow na nila, requestNotifications() mga sagot { allowed: true } nang walang pagtanong.
• Kung ang iyong app ay maaaring hindi magpadala ng mga notification kahit ano (ang Lia team ay inilagay ito), ito ay nabigo sa notifications_off.
• Lia.notificationsAllowed sabi kung saan nasa sitwasyon ang mga bagay, at ang notificationsChanged ang event ay mag-trigger kapag ang tao ay nagbabago nito, mula sa iyong kahilingan o mula sa menu na ⋯.

Lia ay di kaya'hindi maaabot sabihin sa iyong server kung ang isang tao ay nagpahintulot o pinigil ang mga notification. Sabihin ito mismo, o i-send at i-handle not_allowed.

#Paghahatid

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

Tingnan POST /notifications para sa bawat field at sagot.

#Limits

Ang mga notification ay isang karapatan na ibinibigay ng mga tao sa iyong app, kaya Lia ang nagpapanatili nito:

Kapag nakarating na ang limitasyon, POST /notifications mga sagot 429 rate_limited. Para sa iyong app'naka-own limits din nagsasabi kung kailan mo maaaring subukan muli, tulad ng retryAt (mili segundo mula 1970).

"Isang araw" ay ang huling 24 oras para sa iyong app's mga limitasyon, at ang tao'na araw ng kalendaryo para sa kabuuang total mula sa lahat ng apps.

#Kapag buksan ang iyong app mula sa isang

Isang notification na buksan ang iyong app na may kanya startParam (1 hanggang 64 ng mga letra, digit, _ at -) na binabasa ng iyong pahina Lia.startParam. Kung ang iyong app ay naka-open na kapag ang tao ay tumapik dito, ang iyong page ay narinig ng isang startParam event sa halip.

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

#Mga push at ang puso

Bawat notification ay pumunta sa Lia'na bell. Ito's din ipadala sa tao's phone kapag sila ay may Lia's pushes on; POST /notifications mga sagot pushed: false kapag ito ay nakaabot lamang sa bell.

Awtomatikong isinalin. Ang English ay ang source of truth. Basahin sa Ingles