Simulan

Quickstart

Kopya ang pahina

Isang gumagana na Lia app sa ilang minuto. I-host ang isang pahina, i-load ang SDK, tawagan ang Lia.init() at Lia.ready(), at buksan ito sa Lia bilang isang tester.

#Ano ang kailangan mo

Isang web page sa https. Anumang framework, naka-host kahit saan, bilang long as it's served over https. Lia lamang ang nagbubukas ng mga pahina ng https.
Isang account ng Lia na may username. Ang mga tao ay kailangan ng isang username upang buksan ang mga app, at iyan din ang iyong kailangan.
Ang iyong app ay idinagdag sa Lia. Ang Lia team idinagdag ito kasama ang iyong pahina's address at ginawa ka bilang developer nito, kaya maaari mong buksan ito habang ito'ng sa dokumento. Kung tanggalin ito (o ang isang magulang nito), ito ay ihihiwalay ang button o tatapusin ang hold. Ang mga elemento sa loob ng isang Pangkakapitan.

#1. I-load ang SDK

Mag-load ng SDK mula sa Lia, hindi mula sa isang kopya. Ang Lia ay naglulunsad nito upang ang mga pagbabago ay makarating sa lahat ng apps nang sabay-sabay.

index.html

<!doctype html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
  <script src="https://api.lialabs.org/sdk/lia-apps-v1.js"></script>
  <style>
    body {
      margin: 0;
      font-family: system-ui, sans-serif;
      background: var(--lia-bg-color, #fff);
      color: var(--lia-text-color, #0b0b0f);
      padding-bottom: var(--lia-safe-area-inset-bottom, 0px);
    }
  </style>
</head>
<body>
  <main id="app">Opening…</main>
  <script src="app.js"></script>
</body>
</html>

Ang SDK naglalagay ng isang bagay sa pahina, window.Lia. Nasa labas ng app ng Lia ito ay naglo-load pa rin, ngunit ang bawat tawag ay nagfail sa code not_in_lia, minsan kasama ang higit pang mga field.

#2. Sabihin ang kahit ano

Tawag Lia.init() una. Ang sagot nito ay ang manlalaro, isang session token para sa iyong server, ang tao's wika at tema, at marami pa. Pagkatapos ng iyong pahina ay naiskedyul, tawagan ang Lia.ready(): hanggang doon, Lia ay ipapakita ang kanyang sariling loader sa ibabaw ng iyong app.

app.js

Lia.init().then(
  function (me) {
    // me.player.id is this person's id in your app; me.player.name is their Lia username.
    document.getElementById("app").textContent = "Hello, @" + me.player.name;
    Lia.ready();
  },
  function (error) {
    document.getElementById("app").textContent =
      error.code === "not_in_lia" ? "Open this app inside Lia." : "Something went wrong: " + error.code;
  }
);

Kung ikaw ay nagsis prefer async at await:

try {
  const me = await Lia.init();
  render(me);
  Lia.ready();
} catch (error) {
  if (error.code === "not_in_lia") showOpenInLia();
}

#3. Buksan ito sa Lia

Habang ang iyong app ay nasa test, lamang ikaw at ang mga tester na idinagdag ng Lia team ang makakakita nito. Buksan ang app na Lia, pumunta sa Apps Center, at buksan ang iyong app. Ang header nito ay nagsasabi Pagsusulit nakaugnay sa iyong pangalan, at anumang ibinebenta nito ay nagkakahalagang $LIA.

#4. Subukan ang isang bagay

Ilan sa mga bagay na subukan pagkatapos init() nag-utos:

// A toast in Lia's own style.
Lia.toast("Welcome in");

// A tap you can feel.
Lia.haptic("success");

// Lia's main button under your app.
Lia.mainButton.setText("Start").show().onClick(function () {
  Lia.mainButton.showProgress();
  startGame().finally(function () { Lia.mainButton.hide(); });
});

// Keep a best score and see the top 50.
Lia.submitScore(1280).then(function () { return Lia.leaderboard(); }).then(console.log);

#5. Magdagdag ng iyong server

Para sa anumang bagay na mahalaga (mga item na binili ng mga tao, $LIA na iyong ibinayad) ang iyong server ay kailangang suriin kung ano ang sinasabi ng pahina. Nakukuha nito ang isang session token mula sa pahina at pinatutunayan ito gamit ang iyong lihim na key:

server.js

const res = await fetch("https://api.lialabs.org/api/apps/v1/session/verify", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.LIA_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ session }),
});
const { valid, playerId } = await res.json();

I-verify sa iyong server dumaan ito sa bawat hakbang nang magkakasunod.

#Susunod

Paano ang mga app ay tumatakbo sa Lia: ang frame, ang tatlong hitsura at ang mga patakaran kung saan ang iyong pahina ay tumatakbo.
Bilhin ang isang item: Lia'ang pay sheet, sa pagsubok o live.
SDK reference: bawat paraan, property at event.
Ang SDK demo sa https://api.lialabs.org/sdk/demo nagsubok bawat tawag. Ito ay bukas sa loob ng Lia para sa mga tester kung saan ang Lia team ay idinagdag sa ito.

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