Mga Gabay

Bayad sa mga manlalaro sa $LIA mula sa iyong app's reward pool, mula sa iyong server. Ang isang araw-araw na bonus bilang halimbawa, madaling i-retry at nasa loob ng iyong mga limitasyon.

Ang iyong app ay kailangan ng isang reward pool, na pinondohan ng Lia team (tingnan Punsiyon pools. Ang mga reward ay palaging galing sa iyong server, kasama ang iyong key.

#Isang araw-araw na bonus

Ang bawat manlalaro ay maaaring kumita ng 2 LIA isang araw, pagkatapos magtapos ng isang antas.

import { lia } from "./lia.js";

app.post("/api/daily-bonus", async (req, res) => {
  const playerId = await playerFrom(req.body.session); // see Verify on your server
  if (!playerId) return res.status(401).end();
  if (!(await db.finishedALevelToday(playerId))) return res.status(403).json({ error: "play_first" });

  const day = new Date().toISOString().slice(0, 10); // 2026-11-01
  try {
    const result = await lia("POST", "/rewards", {
      playerId,
      amount: 2,
      key: `daily:${day}:${playerId}`, // one a day per player, however often this runs
      reason: "Daily bonus",
    });
    res.json({ paid: result.status === "paid", amount: result.amount });
  } catch (error) {
    if (error.data?.error === "pool_empty") return res.status(503).json({ error: "bonus_paused" });
    if (error.data?.error === "daily_limit") return res.status(429).json({ error: "come_back_tomorrow" });
    throw error;
  }
});

Sa pahina:

const { paid, amount } = await api("/api/daily-bonus", {});
if (paid) {
  Lia.haptic("success");
  Lia.toast("+" + amount + " LIA");
}

#Piliin ang mga key

Ang pana ay ang nagpapahintulot sa isang reward na maging ligtas. Ang parehong pana ay hindi kailanman nagbabayad ng dalawa, kaya gumawa ito ng pangalan ng dahilan para sa reward, hindi ang kahilingan:

Isang pagsubok muli na may parehong key pagkatapos ng timeout ay sumagot { "status": "duplicate" } at hindi nagbabayad ng karagdagang anumang bagay, kaya ang pagsubok muli ay palaging ligtas. Huwag i-retry gamit ang bagong key.

#Panatilihin ang mata sa pool

const { balance, dailyCapPerPlayer } = await lia("GET", "/pool");
if (balance < 100) alertTheTeam(`Reward pool is down to ${balance} LIA`);

Kapag ang pool ay maaaring'hindi kumakatawan sa isang reward, POST /rewards mga sagot 409 pool_empty. Sabihin sa mga manlalaro nang mabuti at humingi ng Lia team na i-top up ito. Kapag ang isang manlalaro ay nagsimulang gamitin ang iyong app'ang araw-araw na limitasyon, ito ang sagot 429 daily_limit (ang limitasyon ay bawat manlalaro bawat UTC araw, itinakda ng team).

#Sa pagsusulit

Gamit ang iyong test key, ang mga parangal ay pangarap: naitala, kasama ang kanilang webhook, ngunit walang $LIA na paggalaw, at ang pool at araw-araw na limitasyon ay hindi'ginamit. Subukan ang iyong mga key at ang iyong pagharang sa error doon muna.

#Gawin ang mga reward na makatwiran

• Pumili sa server. Ano ang kinita ng isang tao ay dapat mula sa kung ano ang iyong server ay nakita (isang tapos na laro, isang kinumpirma na video), hindi mula sa pahina na nagsasabi nito.
• Panatilihin ang iyong sariling limitasyon din, bawat manlalaro at bawat araw, kaya ang isang manlalaro ay maaaring'hindi iwanan ang pool.
• Ipaliwanag kung bakit. Ang reason ipinapakita sa player's activity sa ilalim ng iyong app's pangalan.

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