Conceptos
Cómo funcionan las aplicaciones en Lia
Copiar página
Tu página se ejecuta en un marco bloqueado dentro de la app Lia y alcanza Lia solo a través del SDK. Las tres apariencias, el encabezado y el menú de Lia, y las reglas bajo las que se ejecuta tu página.
#El marco
Cuando alguien abre su aplicación, Lia pregunta a su servidor si pueden (ver Prueba y producción), lo registra como un jugador de tu aplicación, y carga tu página en un marco dentro de la aplicación Lia. Tu página es una página web normal: cualquier framework, cualquier host, servida sobre https.
El marco está bloqueado para que la gente confíe en cada aplicación en Lia:
- Solo tus propias páginas se cargan. El marco permanece en tu aplicación'origen (su esquema, host y puerto). Un enlace o redirección a cualquier otro sitio se bloquea. Abre otros sitios con
Lia.openLink. - Tu página aún puede obtener datos. Scripts, imágenes, fuentes y
fetch()las llamadas a otras direcciones funcionan como en la web (con CORS, como de costumbre). - Sin ventanas emergentes o nuevas ventanas, sin cámara, micrófono o ubicación, y sin pagos propios. El dinero, los anuncios y cualquier cosa en el teléfono ocurre en Lia'sus propias pantallas sobre su aplicación.
- Lia solo escucha tu página en el marco superior. SDK ignora las llamadas desde un iframe dentro de su página, o desde una página de otro origen.
- Los mensajes son pequeños y con ritmo. Una llamada de más de 16,000 caracteres se ignora (y se timeout). Más de 20 llamadas en un segundo se rechazan con
slow_down.
Lia'el marco informa LiaApps/1 al final de su agente de usuario, si desea reconocerlo en su servidor.
#El puente
La demo de SDK se comunica con Lia a través del marco's puente. Cada llamada que hace su página es un mensaje con un id; Lia lo responde una vez, y SDK lo convierte en una promesa. Lia también envía eventos (el tema cambió, la app se pausó) a los que escucha con Lia.on.
Las llamadas que esperan a la persona (la hoja de pago, un anuncio, el escáner, Face ID, un diálogo) no tienen límite de tiempo. Cualquier otra llamada falla con timeout si Lia no't respondido dentro de 20 segundos. Fuera de la aplicación Lia no hay puente, y cada llamada falla con not_in_lia.
#Tres diseños
Cada aplicación se abre en uno de tres estilos, definido por el equipo Lia para tu aplicación. Tu página puede cambiar entre ellos con el SDK.
| Mira | ¿Qué es |
|---|---|
sheet | Sobre Lia como una miniapp de Telegram, casi cuatro quintas partes de alto de la pantalla. La persona puede levantarla al máximo alto, o tu página llama Lia.expand(). Un desplazamiento hacia abajo lo cierra. La mayoría de las aplicaciones se abren así. |
full | La pantalla completa, debajo de Lia's encabezado. |
fullscreen | De borde a borde, con solo Lia'los botones Cerrar flotantes y ⋯ sobre tu página. Mantén tu contenido debajo Lia.contentSafeArea.top. |
Lia.display dice cómo se abrió tu aplicación, y Lia.isFullscreen siempre que'de borde a borde en este momento. Lia.requestFullscreen() y Lia.exitFullscreen() cambiar a pantalla completa y de vuelta.
#Lia's encabezado y menú
En sheet y full, Lia dibuja un encabezado sobre tu página: tu aplicación's icono y nombre (y Prueba con tu nombre de desarrollador mientras estás en prueba), un menú ⋯ y Cerrar. Puedes colórelo y mostrar una botón de retroceso en él.
El menú ⋯ siempre tiene:
- Configuraciones, cuando tu página muestra
Lia.settingsButton. - Notificaciones encendidas o apagadas, cuando tu aplicación puede enviarlos (ver Notificaciones).
- Mutar o desmutar sonidos, lo que tu página escucha como
soundChanged. - Recargar y Cerrar.
#Mientras carga tu página
Lia muestra su propio cargador sobre tu aplicación desde el momento en que se abre hasta que tu página llama Lia.ready() (o finaliza la carga). Llámelo tan pronto como se dibuje su primera pantalla. Si su página no carga, Lia muestra un mensaje con Intente de nuevo.
#Pausar y reanudar
Tu página escucha pause cuando Lia pasa al fondo o cubre tu aplicación con una de sus propias pantallas (la hoja de pago, un anuncio, un diálogo, el escáner), y resume cuando lo's fondo. Pausa temporizadores, música y bucles de juegos en pause. Ver Ciclo de vida y eventos.
#Una hoja a la vez
Lia muestra una de sus propias pantallas sobre tu aplicación a la vez. Mientras la hoja de pago, un anuncio, un diálogo, el selector de amigos, la solicitud de notificaciones, el escáner o el Face ID está abierto, otro llamado falla con busy.
#Quién puede abrir tu app
- Las personas necesitan un Lia nombre de usuario para abrir cualquier app.
- Mientras tu app esté en prueba, solo usted y sus probadores pueden abrirla. Cuando's en vivo, todos pueden. Cuando lo's pausado, nadie puede. Ver Prueba y producción.
- Si el equipo Lia estableció un racha mínima para tu app, la gente necesita un registro de check-in tan largo para abrirla. Lia les muestra cómo llegar allí.
Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés