Paquets
Paquets
Copier la page
Les Lia SDK en paquets npm. Un pont typé, un SDK arbre-shakeable, et des liaisons pour React, Preact, Vue, Svelte, Solid, Angular et les composants web.
Le balise script est le moyen le plus rapide d'entrer. Si votre application a une étape de construction, les paquets npm vous donnent le même SDK avec des types TypeScript, des imports que vous pouvez arbre-couper, un état qui convient à votre framework, et un faux Lia pour construire en dehors de l'application.
#Quel package
| Paquet | Utilisez-le pour |
|---|---|
@lia-labs/sdk | N'importe quelle application avec un bundler, avec ou sans framework. |
@lia-labs/sdk-react | React : des hooks comme useInit, useMainButton, useBackButton. |
@lia-labs/sdk-preact | Preact : les mêmes hooks. |
@lia-labs/sdk-vue | Vue 3: composable renvoyant des refs. |
@lia-labs/sdk-svelte | Svelte 4 et 5 : magasins. |
@lia-labs/sdk-solid | Solide : accesseurs et create* primitives. |
@lia-labs/sdk-angular | Angular 17 et versions ultérieures : inject* fonctions et signaux. |
@lia-labs/elements | N'importe quelle page, sans framework : <lia-main-button> et des amis. |
@lia-labs/bridge | Les messages de bas niveau, pour construire votre propre couche. |
Chaque package de framework réexporte l'ensemble du SDK, donc une seule importation suffit :
npm install @lia-labs/sdk @lia-labs/sdk-reactimport { pay, useInit, useMainButton } from '@lia-labs/sdk-react';#Comment ils s'emboîtent
- @lia-labs/bridgeMessages de cadre de Lia , tapés :
request('pay', { productId }),on('theme', …). EtmockLia(), un Lia fictif pour construire dans un navigateur de bureau. - @lia-labs/sdkChaque fonctionnalité sous forme d'export nommé (
init,pay,mainButton,cloudStorage…), avec les mêmes vérifications et codes d'erreur que l'étiquette script. Son état (thème, langue, viewport…) est un ensemble de petites valeurs observables. - Paquets de frameworkMince : ils transforment ces valeurs en hooks, refs, stores ou signaux, et lient les boutons Lia à vos composants, affichés pendant qu'ils sont chargés et cachés après.
#État que vous pouvez observer
Le SDK'son état est un ensemble de Readable valeurs : get() lit maintenant, et subscribe(listener) entend chaque changement (avec la nouvelle et l'ancienne valeur) et retourne une fonction qui arrête l'écoute. Ils s'actualisent à partir de Lia'les événements après init().
| Valeur | Type |
|---|---|
player | { id, name } ou null avant init() |
mode | "test", "live" ou null |
language, rtl | La personne's langue dans Lia, tels que |
colorScheme, themeParams | "light" ou "dark", et Lia'les couleurs |
viewport | { height, expanded } |
safeArea, contentSafeArea | { top, bottom, left, right } en px |
display, isFullscreen | Comment l'application s'est ouverte, et si elle'bord à bord |
startParam | Ce avec quoi il a été ouvert, maintenu à jour pendant son ouverture |
soundOn, notificationsAllowed, notificationsAvailable | La personne'vos choix |
initialized | Si init() a répondu |
Chaque package de framework a un hook, une fonction composable, un store ou un signal correspondant.
#L'étiquette script fonctionne toujours
https://api.lialabs.org/sdk/lia-apps-v1.js (le global Lia) est inchangé. Utilisez-le ou les packages sur une page, pas les deux : les deux écoutent Lia'les réponses sur le même canal, et la seconde à charger peut't.
#Versions
Les paquets utilisent le protocole du SDK 1.8.1. Une app Lia antérieure à une fonctionnalité répond unknown_method; voir le journal des modifications.
Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais