LiaDesarrolladores

Guías

Una lista de verificación y código de inicio para que tu aplicación se sienta parte de Lia. Tema, áreas seguras, idioma, botones, navegación hacia atrás, vibraciones y sonido.

#Un comienzo

index.html
<!doctype html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, user-scalable=no">
  <script src="https://api.lialabs.org/sdk/lia-apps-v1.js"></script>
  <style>
    :root { color-scheme: light dark; }
    html, body { margin: 0; height: 100%; }
    body {
      background: var(--lia-bg-color, #fff);
      color: var(--lia-text-color, #0b0b0f);
      font: 16px/1.5 system-ui, -apple-system, sans-serif;
      -webkit-tap-highlight-color: transparent;
      -webkit-user-select: none;
      user-select: none;
    }
    .app {
      min-height: var(--lia-viewport-height, 100vh);
      padding: calc(16px + var(--lia-content-safe-area-inset-top, 0px)) 16px calc(16px + var(--lia-safe-area-inset-bottom, 0px));
      box-sizing: border-box;
    }
    .muted { color: var(--lia-hint-color, #6b6e7b); }
    .card { background: var(--lia-secondary-bg-color, #f5f5f7); border-radius: 18px; padding: 16px; }
  </style>
</head>
<body>
  <main class="app" id="app"></main>
  <script>
    var WORDS = {
      en: { hello: "Hello", start: "Start" },
      es: { hello: "Hola", start: "Empezar" },
      ar: { hello: "مرحبًا", start: "ابدأ" },
    };
    function words() { return WORDS[Lia.language] || WORDS.en; }

    Lia.init().then(function (me) {
      document.documentElement.dir = Lia.rtl ? "rtl" : "ltr";
      document.getElementById("app").innerHTML = '<div class="card"><b>' + words().hello + ", @" + me.player.name + '</b></div>';
      Lia.mainButton.setText(words().start).show().onClick(start);
      Lia.ready();
    }, function (error) {
      document.getElementById("app").textContent = "Open this app inside Lia.";
    });

    Lia.on("languageChanged", function (data) {
      document.documentElement.dir = data.rtl ? "rtl" : "ltr";
      Lia.mainButton.setText(words().start);
    });
  </script>
</body>
</html>

#La lista de verificación

  • Llamar Lia.ready() tan pronto como se dibuje su primera pantalla, no después de que todo se haya cargado. Lia'tu cargador cubre tu aplicación hasta entonces.
  • Usar Lia's colores. Construir en --lia-bg-color, --lia-text-color, --lia-hint-color y --lia-secondary-bg-color, y tu aplicación cambia con Lia entre claro y oscuro.
  • Ten en cuenta las áreas seguras. Añade espacio en la parte inferior con --lia-safe-area-inset-bottom; en pantalla completa, mantén el contenido debajo --lia-content-safe-area-inset-top.
  • Hablan su idioma. Usar Lia.language para tus palabras, establece dir de Lia.rtl, y escucha languageChanged. Lia habla 13 idiomas; el inglés es un buen respaldo.
  • Usar Lia's botones para la acción principal. Lia.mainButton se sitúa donde la gente lo espera, sobre la barra de inicio, en azul Lia.
  • Usa el botón atrás para tus propias pantallas. Mostrar Lia.backButton una pantalla adentro, y maneja onClick; ocúltalo en tu primera pantalla.
  • Usar Lia'los diálogos. Lia.confirm, Lia.showPopup y Lia.toast se vean como el resto de Lia y se lean de derecha a izquierda cuando corresponda.
  • Sélo. Lia.haptic("selection") para opciones, "success" y "error" para resultados. No cada frame.
  • Respetar el sonido. Juega solo mientras Lia.soundOn, y detenerse en soundChanged y pause.
  • Pausar en pause. Temporizadores, bucles de juego, música y sockets que importan.
  • Pregunte antes de cerrar un juego en curso con Lia.enableClosingConfirmation(), y apágalo cuando'terminado.
  • Detener los deslizamientos que cierran un juego que los utiliza con Lia.disableVerticalSwipes().
  • Sin pasar el cursor, sin objetivos pequeños. Es's un teléfono: 44 píxeles de objetivos de toque al menos, y ninguna selección de texto en botones.

#Colorea tu encabezado

Si su aplicación tiene un color fuerte propio, déle Lia's encabezado y fondo iguales:

Lia.setHeaderColor("#0E1A3A");
Lia.setBackgroundColor("#0E1A3A");

Lia cambia el encabezado'su texto y botones claro o oscuro según corresponda.

Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés

Escribe para buscar en cada página, método y punto final.