Concepts
Comment les applications s'exécutent dans Lia
Copier la page
Votre page s'exécute dans un cadre verrouillé à l'intérieur de l'application Lia et accède à Lia uniquement via SDK. Les trois apparences, l'en-tête et le menu de Lia, et les règles sous lesquelles votre page s'exécute.
#Le cadre
Quand quelqu'un ouvre votre application, Lia demande à son serveur s'il peut (voir Test et live), connecte le joueur à votre application, et charge votre page dans un cadre à l'intérieur de l'application Lia. Votre page est une page web normale : tout framework, tout hébergement, servie via https.
Le cadre est verrouillé pour que les gens puissent faire confiance à chaque application dans Lia :
- Seules vos propres pages s'affichent. Le cadre reste sur votre application'de l'origine (son schéma, hôte et port). Un lien ou une redirection vers un autre site est bloqué. Ouvrez d'autres sites avec
Lia.openLink. - Votre page peut toujours récupérer. Scripts, images, polices et
fetch()les appels vers d'autres adresses fonctionnent comme sur le web (avec CORS, comme d'habitude). - Aucune fenêtre contextuelle ou nouvelle fenêtre, aucun appareil photo, microphone ou localisation, et aucune de vos paiements. L'argent, les publicités et tout ce qui est sur le téléphone se passe dans Lia'ses propres écrans au-dessus de votre application.
- Lia n'entend que votre page dans le cadre supérieur. SDK ignore les appels provenant d'un iframe sur votre page, ou d'une page d'une autre origine.
- Les messages sont courts et espacés. Un appel de plus de 16,000 caractères est ignoré (et expire). Plus de 20 appels en une seconde sont refusés avec
slow_down.
Lia'frame signale LiaApps/1 à la fin de son agent utilisateur, si vous souhaitez l'identifier sur votre serveur.
#Le pont
La démo SDK communique avec Lia via le cadre'un pont. Chaque appel que votre page effectue est un message avec un identifiant ; Lia y répond une seule fois, et SDK le transforme en promesse. Lia envoie également des événements (le thème a changé, l'application est en pause) que vous écoutez avec Lia.on.
Les appels qui attendent la personne (la feuille de paie, une publicité, le scanneur, le visage ID, une boîte de dialogue) n'ont pas de limite de temps. Tous les autres appels échouent avec timeout si Lia n''t répondue dans 20 secondes. En dehors de l'application Lia, il n'y a pas de pont, et chaque appel échoue avec not_in_lia.
#Trois apparences
Chaque application s'ouvre dans l'une des trois présentations, définie par l'équipe Lia pour votre application. Votre page peut passer entre elles avec le SDK.
| Regarder | Ce qu'il est |
|---|---|
sheet | Au-dessus de Lia comme une mini-application Telegram, environ quatre cinquièmes de la hauteur de l'écran. La personne peut la faire monter à pleine hauteur, ou votre page appelle Lia.expand(). Un glissement vers le bas le ferme. La plupart des applications s'ouvrent ainsi. |
full | L'écran entier, sous Lia'en-tête. |
fullscreen | De bord à bord, avec seulement Lia'les boutons Flottants Fermer et ⋯ au-dessus de votre page. Gardez votre contenu en dessous Lia.contentSafeArea.top. |
Lia.display dit comment votre application s'est ouverte, et Lia.isFullscreen si cela'bord à bord en ce moment même. Lia.requestFullscreen() et Lia.exitFullscreen() passer en mode plein écran et en mode normal.
#Lia'en-tête et menu
Dans sheet et full, Lia affiche un en-tête au-dessus de votre page : votre application'icône et nom (et Test avec votre nom d'utilisateur de développeur pendant le test), un menu ⋯ et Fermer. Vous pouvez coloriez-le et affiche un bouton retour dedans.
Le menu ⋯ a toujours :
- Paramètres, lorsque votre page affiche
Lia.settingsButton. - Activé ou désactivé, lorsque votre application peut les envoyer (voir Notifications).
- Désactiver ou activer le son, que votre page entend comme
soundChanged. - Recharger et Fermer.
#Tant que votre page charge
Lia affiche son propre chargeur au-dessus de votre application dès son ouverture jusqu'à ce que votre page appelle Lia.ready() (ou termine le chargement). Appelez-la dès que votre première écran est dessiné. Si votre page ne charge pas, Lia affiche un message avec Essayer à nouveau.
#Mettre en pause et reprendre
Votre page entend pause quand Lia passe en arrière-plan ou couvre votre application avec l'une de ses propres écrans (la feuille de paiement, une publicité, une boîte de dialogue, le lecteur de codes), et resume quand il'le retour. Mettez en pause les compteurs, la musique et les boucles de jeu sur pause. Voir Cycle de vie et événements.
#Une seule feuille à la fois
Lia affiche l'une de ses propres écrans au-dessus de votre application à la fois. Tant que la feuille de paiement, une publicité, une boîte de dialogue, le sélecteur d'amis, la demande de notifications, le scanneur ou le visage ID est ouvert, une autre telle demande échoue avec busy.
#Qui peut ouvrir votre application
- Les gens ont besoin d'un Lia nom d'utilisateur pour ouvrir toute application.
- Tant que votre application est en test, seul vous et vos testeurs pouvez l'ouvrir. Lorsqu'il's en direct, tout le monde peut le faire. Quand il's en pause, personne ne peut. Voir Test et live.
- Si l'équipe Lia a défini un séquence minimale pour votre application, les gens ont besoin d'une séquence de vérification aussi longue pour l'ouvrir. Lia leur montre comment y parvenir.
Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais