SDK referencia
Inicio y ciclo de vida
Copiar página
Lia.iniciar, Lia.listo, Lia.sesión y Lia.cerrar, y cada evento Lia envía a tu página.
#Lia.init()
Llámelo primero. Responde con quién es el jugador y todo lo que respecta a cómo se muestra su aplicación, y completa el SDK's propiedades y CSS variables.
const me = await Lia.init();Se resuelve con:
| Campo | Tipo | ¿Qué es |
|---|---|---|
player | objeto | { id, name }: el reproductor's id en su aplicación, y su nombre de usuario Lia. Vea Jugadores. |
session | cadena | Un token de sesión para su servidor, lias_…. |
exp | número | Cuando finaliza la sesión, en milisegundos desde 1970 (15 minutos después de abrir). |
mode | cadena | "test" o "live". |
language | cadena | La persona's idioma en Lia, como "en". |
rtl | booleano | Si se lee de derecha a izquierda. |
platform | cadena | "ios" o "android". |
theme | cadena | "light" o "dark". |
themeParams | objeto | Lia's colores (bg_color, text_color…). |
display | cadena | "sheet", "full" o "fullscreen". |
isFullscreen | booleano | De borde a borde o no. |
viewport | objeto | { height, expanded } |
safeArea | objeto | { top, bottom, left, right } en px |
contentSafeArea | objeto | { top, bottom, left, right } en px |
startParam | cadena o nulo | Lo que abrió su aplicación. |
link | cadena | Tu app's enlace de invitación, sin un startParam. |
sound | booleano | Si la persona quiere tu app's sonidos. |
notifications | objeto | { allowed, available }: si permitieron tus notificaciones, y si tu app puede preguntar. |
Errores: not_in_lia, not_ready (Lia todavía está abriendo la aplicación; intente de nuevo pronto), timeout.
#Lia.ready()
Le dice a Lia que tu página está dibujada, así que quita su cargador. Llámalo una vez que tu primera pantalla esté en la página. No devuelve nada.
Lia.init().then(function (me) {
renderHome(me);
Lia.ready();
});#Lia.session()
Un token de sesión fresco para tu servidor. Las sesiones duran 15 minutos, así que obtén uno nuevo antes de llamadas que tu servidor deba confiar.
const { session, exp } = await Lia.session();Se resuelve con { session, exp }. Errores: not_open (la persona no'no ha abierto su aplicación en Lia aún; llame init() primero), timeout.
#Lia.close()
Cierra tu aplicación. Resuelve con null. Si activaste confirmación de cierre, esto se cierra sin preguntar.
#Lia.on(event, listener)
Escucha uno de Lia'los eventos. Devuelve una función que deja de escuchar.
const stop = Lia.on("theme", function (data) { redraw(data.colorScheme); });
// later
stop();Lanzamientos bad_listener si listener no't una función. Un escuchador que lanza no'no detener a los demás.
#Lia.off(event, listener)
Detiene un escuchador agregado con Lia.on.
#Lia.onPause(listener)
Lo mismo que Lia.on("pause", listener). Devuelve una función que deja de escuchar.
#Lia.onResume(listener)
Lo mismo que Lia.on("resume", listener).
#Eventos
| Evento | Datos | Cuándo |
|---|---|---|
"pause" | ninguno | Lia fue al fondo, o uno de Lia'las pantallas (la nómina, un anuncio, un diálogo) cubrieron tu aplicación. Pausa los temporizadores y el sonido. |
"resume" | ninguno | Vuelva a atrás. |
"theme" | { theme, colorScheme } | La persona cambió Lia entre claro y oscuro. theme es las nuevas colores. Las variables CSS ya están actualizadas. |
"viewport" | { height, expanded, isStateStable } | Tu página's altura cambió (una hoja se levantó, botones inferiores mostrados). |
"fullscreenChanged" | { isFullscreen, contentSafeArea } | Tu app fue a o desde pantalla completa. |
"languageChanged" | { language, rtl } | La persona cambió Lia'su idioma. |
"startParam" | { startParam } | Una notificación o invitación para su aplicación se abrió mientras ya estaba abierta. |
"notificationsChanged" | { allowed } | La persona que permitió o detuvo tu aplicación'notificaciones. |
"soundChanged" | { on } | La persona silenció o desactivó tu aplicación desde Lia's ⋯ menú. |
"charge" | { chargeId, productId } | Un pago fue confirmado mientras no Lia.pay() estaba esperando (después de una recarga). También Lia.onCharge. |
"ad" | { state, format } | Un anuncio's etapa: "loading", "showing" o "closed". También Lia.onAd. |
"banner" | { state, position, height, reason? } | El banner's "loading", "shown", "failed" o "hidden". También Lia.onBanner. |
"nativeAd" | { state, placement, height? } | Un anuncio nativo's "loading", "showing" o "closed". También Lia.onNativeAd. |
"safeAreaChanged" | { safeArea, contentSafeArea } | Un banner fijado o una tarjeta nativa tomó o devolvió un borde: Lia rellena alrededor de él, por lo que tu área segura allí es 0. CSS las variables ya están actualizadas. |
"mainButtonClicked" | ninguno | El botón principal fue presionado. También Lia.mainButton.onClick. |
"secondaryButtonClicked" | ninguno | El segundo botón fue presionado. |
"backButtonClicked" | ninguno | El encabezado's botón de retroceso fue presionado. |
"settingsButtonClicked" | ninguno | Se eligió Configuraciones en el menú ⋯. |
"accelerometerChanged" | { x, y, z } | Una lectura, mientras el acelerómetro corre. |
"gyroscopeChanged" | { x, y, z } | Una lectura, mientras el giroscopio corre. |
"deviceOrientationChanged" | { alpha, beta, gamma } | Una lectura, mientras la orientación corre. |
"accelerometerStarted", "accelerometerStopped" | ninguno | El sensor comenzó o se detuvo. También para gyroscope y deviceOrientation. |
La demo de SDK actualiza sus propias propiedades (Lia.colorScheme, Lia.viewport, Lia.language, Lia.soundOn y el resto) antes de que se ejecuten sus oyentes.
Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés