SDK référence
Démarrage et cycle de vie
Copier la page
Lia.init, Lia.ready, Lia.session et Lia.close, et chaque événement Lia envoie votre page.
#Lia.init()
Appelez-le en premier. Il répond avec qui est le joueur et tout ce qui concerne l'affichage de votre application, et remplit le SDK's propriétés et CSS variables.
const me = await Lia.init();Résout avec :
| Champ | Type | Ce qu'il est |
|---|---|---|
player | objet | { id, name }: le lecteur'id dans votre application, et leur nom d'utilisateur Lia. Voir Joueurs. |
session | chaîne | Un jeton de session pour votre serveur, lias_…. |
exp | nombre | Quand la session se termine, en millisecondes depuis 1970 (15 minutes après l'ouverture). |
mode | chaîne | "test" ou "live". |
language | chaîne | La personne's langue dans Lia : "en". |
rtl | booléen | Si cela s'affiche de droite à gauche. |
platform | chaîne | "ios" ou "android". |
theme | chaîne | "light" ou "dark". |
themeParams | objet | Lia'les couleurs (bg_color, text_color…). |
display | chaîne | "sheet", "full" ou "fullscreen". |
isFullscreen | booléen | De bord à bord ou non. |
viewport | objet | { height, expanded } |
safeArea | objet | { top, bottom, left, right } en px |
contentSafeArea | objet | { top, bottom, left, right } en px |
startParam | chaîne ou null | Ce avec quoi votre application a été ouverte. |
link | chaîne | Votre application'lien d'invitation, sans startParam. |
sound | booléen | Si la personne veut votre application'ses sons. |
notifications | objet | { allowed, available }: si ils ont autorisé vos notifications, et si votre application peut demander. |
Erreurs : not_in_lia, not_ready (Lia ouvre toujours l'application ; essayez à nouveau plus tard), timeout.
#Lia.ready()
Informe Lia que votre page est dessinée, donc elle retire son chargeur. Appelez-le une fois votre première page sur la page. Renvoie rien.
Lia.init().then(function (me) {
renderHome(me);
Lia.ready();
});#Lia.session()
Un jeton de session frais pour votre serveur. Les sessions durent 15 minutes, donc obtenez-en un nouveau avant les appels que votre serveur doit faire confiance.
const { session, exp } = await Lia.session();Résout avec { session, exp }. Erreurs : not_open (la personne n''ne pas avoir encore ouvert votre application dans Lia ; appelez init() premier), timeout.
#Lia.close()
Ferme votre application. Résout avec null. Si vous avez activé confirmation de fermeture, cela se ferme sans demander.
#Lia.on(event, listener)
Écoute l'une des Lia'les événements. Renvoie une fonction qui arrête l'écoute.
const stop = Lia.on("theme", function (data) { redraw(data.colorScheme); });
// later
stop();Lancers bad_listener si listener n'est pas't une fonction. Un écouteur qui lance une erreur n''arrête les autres.
#Lia.off(event, listener)
Arrête un écouteur ajouté avec Lia.on.
#Lia.onPause(listener)
La même chose que Lia.on("pause", listener). Retourne une fonction qui arrête l'écoute.
#Lia.onResume(listener)
La même chose que Lia.on("resume", listener).
#Événements
| Événement | Données | Quand |
|---|---|---|
"pause" | aucun | Lia est passé en arrière-plan, ou l'un de Lia'les écrans (la feuille de paiement, une publicité, une boîte de dialogue) couvrent votre application. Mettez en pause les compteurs et le son. |
"resume" | aucun | De retour. |
"theme" | { theme, colorScheme } | La personne a basculé Lia entre clair et sombre. theme est les nouvelles couleurs. Les variables CSS sont déjà mises à jour. |
"viewport" | { height, expanded, isStateStable } | Votre page'hauteur modifiée (une feuille tirée vers le haut, les boutons du bas affichés). |
"fullscreenChanged" | { isFullscreen, contentSafeArea } | Votre application est passée en plein écran ou en dehors. |
"languageChanged" | { language, rtl } | La personne a changé Lia'langue. |
"startParam" | { startParam } | Une notification ou une invitation pour votre application a été ouverte alors qu'elle était déjà ouverte. |
"notificationsChanged" | { allowed } | La personne qui a autorisé ou bloqué votre application'les numéros ou les revenus. |
"soundChanged" | { on } | La personne a mis en sourdine ou désactivé la mise en sourdine votre application depuis Lia'menu ⋯. |
"charge" | { chargeId, productId } | Un paiement a été confirmé alors qu'il n'y avait pas Lia.pay() attendait (après un rechargement). Aussi Lia.onCharge. |
"ad" | { state, format } | Une publicité'sa phase : "loading", "showing" ou "closed". Aussi Lia.onAd. |
"banner" | { state, position, height, reason? } | La bannière's "loading", "shown", "failed" ou "hidden". Aussi Lia.onBanner. |
"nativeAd" | { state, placement, height? } | Une publicité native's "loading", "showing" ou "closed". Aussi Lia.onNativeAd. |
"safeAreaChanged" | { safeArea, contentSafeArea } | Une bannière ancrée ou une carte native a pris ou rendu un bord : Lia ajoute des marges autour, donc votre zone sûre là-bas est 0. CSS les variables sont déjà mises à jour. |
"mainButtonClicked" | aucun | Le bouton principal a été appuyé. Aussi Lia.mainButton.onClick. |
"secondaryButtonClicked" | aucun | Le deuxième bouton a été pressé. |
"backButtonClicked" | aucun | L'en-tête'le bouton retour a été pressé. |
"settingsButtonClicked" | aucun | Paramètres a été choisi dans le menu ⋯. |
"accelerometerChanged" | { x, y, z } | Une lecture, pendant que l'accéléromètre fonctionne. |
"gyroscopeChanged" | { x, y, z } | Une lecture, pendant que le gyroscope fonctionne. |
"deviceOrientationChanged" | { alpha, beta, gamma } | Une lecture, pendant que l'orientation fonctionne. |
"accelerometerStarted", "accelerometerStopped" | aucun | Le capteur a commencé ou s'est arrêté. Aussi pour gyroscope et deviceOrientation. |
La démo SDK met à jour ses propres propriétés (Lia.colorScheme, Lia.viewport, Lia.language, Lia.soundOn et le reste) avant que vos écouteurs ne s'exécutent.
Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais