ابدأ

البدء السريع

نسخ الصفحة

تطبيق يعمل بسرعة Lia في بضع دقائق. قم بتشغيل صفحة، قم بتحميل SDK، وقم بدعوة Lia.init() و Lia.ready()، وافتحه في Lia كمُختبر.

#ما تحتاجه

صفحة ويب على https. أي إطار، مُخَدَّم في أي مكان، طالما أنه'تُقدَّم عبر https. Lia يفتح فقط صفحات https.
حساب Lia مع اسم مستخدم. يحتاج الناس إلى اسم مستخدم لفتح التطبيقات، وكذلك أنت.
تم إضافة تطبيقك إلى Lia. فريق الـ Lia يضيفه مع صفحتك'س العنوان وتجعلك مطورًا لها، لذا يمكنك فتحها بينما هي'في الاختبار. انظر الوصول.

#1. قم بتحميل SDK

قم بتحميل SDK من Lia، وليس من نسخة. تقدم Lia إياه بحيث تصل التحديثات إلى كل التطبيق مرة واحدة.

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>

تجربة SDK تضع كائنًا واحدًا على الصفحة, window.Lia. خارج تطبيق Lia، لا يزال يتم تحميله، لكن كل محاولة تفشل برمز not_in_lia, لذلك يمكنك عرض رسالة ودية في متصفح عادي.

#2. قل مرحًا

مكالمة Lia.init() أولاً. يجيب بلاعب، رمز جلسة لخادمك، الشخص'لغته وسمائة، وأكثر. عندما يتم رسم صفحتك، اتصل بـ Lia.ready(): حتى ذلك الحين، يعرض Lia مؤشر تحميله الخاص فوق تطبيقك.

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

إذا كنت تفضل async و await:

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

#3. افتحها في Lia

بينما يكون تطبيقك في الاختبار، يمكنك أنت والاختبارين الذين أضافتهم فريق Lia فقط رؤيته. افتح تطبيق Lia، انتقل إلى مركز التطبيقات، وافتح تطبيقك. يظهر في رأسه اختبار بجانب اسمك، وكل ما يبيعه يكلف ⁦$LIA⁩ وهمية.

#4. جرّب شيئًا آخر

بضع أشياء لتجربتها بعد init() قد أجاب:

// 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. أضف خادمك

لأي مكافأة تهم (العناصر التي دفعها الناس، ⁦$LIA⁩ التي تدفعها) يجب على خادمك التحقق مما تخبره الصفحة. يحصل على رمز جلسة من الصفحة ويتحقق منه باستخدام مفتاح سريك:

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

تحقق على خادمك يمر بها خطوة بخطوة.

#التالي

كيف يعمل التطبيقات في Lia: الإطار، الثلاثة مظهر وقواعد التي تعمل تحتها صفحتك.
بيع عنصر: Lia'ورقة الدفع الخاصة به، من البداية إلى النهاية.
مرجع SDK: كل طريقة، خاصية وحدث.
تجربة SDK في https://api.lialabs.org/sdk/demo تحاول كل مكالمة. يفتح داخل Lia للتجارب التي يضيفها فريق Lia.

تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية