Bắt đầu

Bắt đầu nhanh

Sao chép trang

Một ứng dụng Lia hoạt động trong vài phút. Chạy một trang, tải SDK, gọi Lia.init() và Lia.ready(), và mở nó trong Lia như một người kiểm thử.

#Bạn cần gì

Một trang web trên https. Mọi khung, được lưu trữ ở bất cứ đâu, miễn là nó'được cung cấp qua https. Lia chỉ mở các trang https.
Một tài khoản Lia với tên người dùng. Mọi người cần một tên người dùng để mở ứng dụng, và bạn cũng vậy.
Ứng dụng của bạn đã được thêm vào Lia. Đội Lia thêm nó với trang của bạn's địa chỉ, vì vậy một trang trên'trong thử nghiệm. Xem Truy cập.

#1. Tải SDK

Tải SDK từ Lia, không phải từ một bản sao. Lia cung cấp nó để các sửa lỗi đến mọi ứng dụng cùng lúc.

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 đặt một đối tượng trên trang, window.Lia. Ngoài ứng dụng Lia nó vẫn tải, nhưng mọi cuộc gọi đều thất bại với mã not_in_lia, vì vậy bạn có thể hiển thị một thông báo thân thiện trong trình duyệt bình thường.

#2. Chào hỏi

Gọi Lia.init() đầu tiên. Nó trả lời bằng người chơi, một mã phiên cho máy chủ của bạn, người'ngôn ngữ và chủ đề, và nhiều hơn nữa. Khi trang của bạn được vẽ, gọi Lia.ready(): cho đến khi đó, Lia hiển thị bộ tải riêng của nó trên ứng dụng của bạn.

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

Nếu bạn thích async và await:

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

#3. Mở nó trong Lia

Trong khi ứng dụng của bạn ở chế độ kiểm tra, chỉ bạn và những người kiểm tra mà đội Lia thêm vào mới có thể xem nó. Mở ứng dụng Lia, đến Trung tâm Ứng dụng, và mở ứng dụng của bạn. Tiêu đề của nó nói Kiểm tra bên cạnh tên bạn, và mọi thứ nó bán đều có giá giả $LIA.

#4. Thử điều gì đó

Một số điều để thử một khi init() đã trả lời:

// 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. Thêm máy chủ của bạn

Đối với bất cứ điều gì quan trọng (các mặt hàng mọi người đã thanh toán, $LIA mà bạn chi trả), máy chủ của bạn phải kiểm tra điều mà trang nói với nó. Nó nhận được một token phiên từ trang và xác minh nó bằng khóa bí mật của bạn:

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

Xác minh trên máy chủ của bạn đi qua từng bước một.

#Tiếp theo

Cách các ứng dụng chạy trên Lia: khung, ba kiểu và các quy tắc mà trang của bạn chạy dưới.
Bán một vật phẩm: Lia'bảng thanh toán của bạn, end to end.
Tham khảo SDK: mọi phương thức, thuộc tính và sự kiện.
Demo SDK tại https://api.lialabs.org/sdk/demo cố gắng mỗi lần gọi. Nó mở bên trong Lia cho người thử nghiệm khi Lia nhóm thêm vào đó.

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