SDK référence
Appareil
Copier la page
Haptique, le scanneur QR, le presse-papiers, les liens, les écrans propres à Lia, Face ID et Touch ID, et les capteurs de mouvement.
#Haptique
#Lia.haptic(kind)
Un clic que la personne ressent. Résout avec null.
Lia.haptic("success");kind | Ressemble à |
|---|---|
"light" (le par défaut), "medium", "heavy", "rigid", "soft" | Un clic, de léger à lourd |
"success", "warning", "error" | Un résultat |
"selection" | Un point, pour un choix qui change |
Un genre inconnu joue "light". Chaque haptique est un aller-retour vers Lia, donc ne'ne pas jouer une publicité à chaque image d'un jeu.
#Scan et presse-papiers
#Lia.scanQr(options)
Ouvre Lia's QR scanneur sur votre application. Résout avec le code'son texte, ou null si la personne l'a fermée.
const text = await Lia.scanQr({ text: "Scan the code on the table" });| Option | Type | |
|---|---|---|
text | chaîne | Optionnel, sous le lecteur de codes'fenêtre, jusqu'à 64 caractères. |
Erreurs : bad_text, busy.
#Lia.copyText(text)
Copie le texte dans le presse-papiers, et Lia le dit'copié. Résout avec null.
| Paramètre | Type | |
|---|---|---|
text | chaîne | Jusqu'à 4096 caractères. |
Erreurs : bad_text, unsupported.
#Lia.readClipboard()
Le texte du presse-papiers, ou null. Sur iPhone, le téléphone demande d'abord à la personne.
const pasted = await Lia.readClipboard();#Liens
#Lia.openLink(url, options)
Ouvre une page web. Votre cadre n'affiche que vos propres pages, donc utilisez cela pour tout autre site.
Lia.openLink("https://example.com/terms"); // in Lia's in-app browser, over your app
Lia.openLink("https://example.com", { external: true }); // outside Lia, in the phone's browser| Paramètre | Type | |
|---|---|---|
url | chaîne | Une adresse https, jusqu'à 2048 caractères. |
options.external | booléen | Ouvrez-le en dehors de Lia. |
Résout avec null une fois que le navigateur intégré est fermé (ou tout de suite pour external). Erreurs : bad_url.
#Lia.openLiaLink(screen)
Ouvre l'un des Lia'ses propres écrans. Les pages ferment d'abord votre application (en demandant, si vous avez désactivé confirmation de fermeture ouverts (en mode) et s'ouvrent comme eux-mêmes ; les feuilles s'ouvrent au-dessus de votre application, qui reste.
Lia.openLiaLink("mine"); // Lia's mining sheet, over your appscreen | Ouvre | Votre application |
|---|---|---|
"invite" | Invitez des amis à Lia | Ferme |
"strides" | Strides | Ferme |
"activity" | La personne'activité | Ferme |
"send" | Envoyer $LIA | Ferme |
"apps" | Le Centre d'applications | Ferme |
"streak" | La séquence de connexion quotidienne | Reste |
"mine" | Mining | Reste |
"receive" | Recevoir $LIA | Reste |
Résout avec { closed }: true si votre application l'a fermée, false si elle est restée (ou si la personne a choisi de rester). Erreurs : unknown_screen, bad_screen.
#Face ID et Touch ID
#Lia.biometric
Demandez à la personne de confirmer'les leur, avec le téléphone's ID, Touch ID ou empreinte digitale, avant quelque chose de sensible dans votre application. Votre application ne sait que s'ils ont réussi.
#Lia.biometric.init()
Si le téléphone peut le faire. Résout avec { available, type }: available est vrai lorsque le téléphone l'a et qu'il'configuré ; type est "face", "finger" ou "unknown".
#Lia.biometric.authenticate(options)
Demande à la personne de confirmer. Résout avec { authenticated }. Si elles peuvent'utiliser les biométriques, le téléphone peut proposer son code secret à la place.
const { available } = await Lia.biometric.init();
if (available) {
const { authenticated } = await Lia.biometric.authenticate({ reason: "Confirm it's you to open your vault" });
}| Option | Type | |
|---|---|---|
reason | chaîne | Optionnel, affiché par le téléphone, jusqu'à 128 caractères. Lia'ses propres mots quand ils sont laissés de côté. |
Erreurs : unsupported, busy, bad_reason.
#Mouvement
Trois capteurs, chacun avec start, stop, isStarted et sa dernière lecture. Les lectures arrivent sous forme d'événements pendant qu'un capteur fonctionne ; il s'arrête lorsque votre application se ferme. Les trois sont optionnels sur les téléphones : start() échoue avec unsupported où il y'le non. Voir
| Capteur | Lecture | Unités | Événement |
|---|---|---|---|
Lia.accelerometer | x, y, z | m/s², avec la gravité incluse | "accelerometerChanged" |
Lia.gyroscope | x, y, z | Taux de rotation, radians par seconde | "gyroscopeChanged" |
Lia.deviceOrientation | alpha, beta, gamma | Angles en radians | "deviceOrientationChanged" |
await Lia.deviceOrientation.start({ refreshRate: 50 });
Lia.on("deviceOrientationChanged", function (r) {
steer(r.gamma); // tilting left and right
});
// later
Lia.deviceOrientation.stop();#Lia.accelerometer
| Membre | |
|---|---|
start(options) | Commence les lectures. options.refreshRate: 20 à 1000 ms entre les lectures, 1000 par défaut. Résout avec true; aussi déclenche "accelerometerStarted". Erreurs : bad_refresh_rate, unsupported. |
stop() | Les arrête. Résout avec true; aussi déclenche "accelerometerStopped". |
isStarted | Si cela'est en cours. |
x, y, z | La dernière lecture, null avant le premier. |
#Lia.gyroscope
La même chose que Lia.accelerometer, avec x, y et z taux de rotation.
#Lia.deviceOrientation
La même chose, avec alpha, beta et gamma.
Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais