Mulai

Panduan Cepat

Salin halaman

Sebuah aplikasi Lia yang berjalan dalam beberapa menit. Host sebuah halaman, muat SDK, panggil Lia.init() dan Lia.ready(), dan buka di Lia sebagai pengujinya.

#Apa yang Anda butuhkan

Sebuah halaman web di https. Apa pun framework, dihosting di mana saja, selama itu'disediakan melalui https. Lia hanya membuka halaman https.
Akun Lia dengan nama pengguna. Orang membutuhkan nama pengguna untuk membuka aplikasi, dan Anda juga.
Aplikasi Anda ditambahkan ke Lia. The Lia tim menambahkannya dengan halaman Anda's alamat dan menjadikan Anda sebagai pengembangnya, sehingga Anda dapat membukanya sementara itu'di uji. Lihat Mendapatkan akses.

#1. Muat SDK

Muat SDK dari Lia, bukan dari salinan. Lia menyediakannya sehingga perbaikan mencapai semua aplikasi sekaligus.

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>

Demo SDK menempatkan satu objek di halaman, window.Lia. Di luar aplikasi Lia itu masih memuat, tetapi setiap panggilan gagal dengan kode not_in_lia, jadi Anda dapat menampilkan pesan yang ramah di browser biasa.

#2. Katakan halo

Panggil Lia.init() pertama. Ini menjawab dengan pemain, token sesi untuk server Anda, orang tersebut'bahasa dan tema, dan lainnya. Ketika halamanmu digambar, panggil Lia.ready(): sampai saat itu, Lia menampilkan loader-nya sendiri di atas aplikasi Anda.

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

Jika Anda lebih suka async dan await:

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

#3. Buka di Lia

Sementara aplikasi Anda dalam mode uji, hanya Anda dan penguji yang ditambahkan oleh tim Lia yang dapat melihatnya. Buka aplikasi Lia, pergi ke Pusat Aplikasi, dan buka aplikasi Anda. Header-nya menyatakan Uji di samping nama Anda, dan apa pun yang dijualnya biayanya menggunakan $LIA palsu.

#4. Coba sesuatu

Beberapa hal yang bisa dicoba setelah init() telah menjawab:

// 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. Tambahkan server Anda

Untuk apa pun yang penting (item yang dibeli orang, $LIA yang Anda bayarkan), server Anda harus memeriksa apa yang dikatakan halaman tersebut. Ia mendapatkan token sesi dari halaman dan memverifikasi dengan kunci rahasia Anda:

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

Verifikasi di server Anda melalui langkah-langkahnya secara bertahap.

#Berikutnya

Bagaimana aplikasi berjalan di Lia: frame, tiga tampilan, dan aturan yang diterapkan halaman Anda.
Jual item: Lia'lembar gaji, end to end.
Referensi SDK: setiap metode, properti, dan peristiwa.
Demo SDK di https://api.lialabs.org/sdk/demo coba setiap panggilan. Ini terbuka di dalam Lia untuk penguji yang ditambahkan oleh tim Lia.

Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris