SDK referencia
Dispositivo
Copiar página
Haptics, el escáner QR, el portapapeles, los enlaces, las pantallas propias de Lia, Face ID y Touch ID, y los sensores de movimiento.
#Haptics
#Lia.haptic(kind)
Un toque que la persona siente. Se resuelve con null.
Lia.haptic("success");kind | Se siente como |
|---|---|
"light" (el predeterminado), "medium", "heavy", "rigid", "soft" | Un toque, de ligero a fuerte |
"success", "warning", "error" | Un resultado |
"selection" | Un tick, para un cambio de elección |
Un tipo desconocido juega "light". Cada vibración es un viaje de ida y vuelta a Lia, así que no'no jugar uno cada fotograma de un juego.
#Escaneo y portapapeles
#Lia.scanQr(options)
Abre Lia's escáner QR sobre tu aplicación. Resuelve con el código'su texto, o null si la persona lo cerró.
const text = await Lia.scanQr({ text: "Scan the code on the table" });| Opción | Tipo | |
|---|---|---|
text | cadena | Opcional, debajo del escáner'su ventana, hasta 64 caracteres. |
Errores: bad_text, busy.
#Lia.copyText(text)
Copia el texto al portapapeles, y Lia lo dice's copiado. Resuelve con null.
| Parámetro | Tipo | |
|---|---|---|
text | cadena | Hasta 4096 caracteres. |
Errores: bad_text, unsupported.
#Lia.readClipboard()
El texto del portapapeles, o null. En iPhone, el teléfono pregunta primero a la persona.
const pasted = await Lia.readClipboard();#Enlaces
#Lia.openLink(url, options)
Abre una página web. Tu marco solo muestra tus propias páginas, así que úsalo para cualquier otro sitio.
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| Parámetro | Tipo | |
|---|---|---|
url | cadena | Una dirección https, hasta 2048 caracteres. |
options.external | booleano | Ábrelo fuera de Lia. |
Se resuelve con null una vez que el navegador dentro de la aplicación se cierre (o de inmediato para external. Errores: bad_url.
#Lia.openLiaLink(screen)
Abre uno de Lia'sus propias pantallas. Las páginas cierran primero su aplicación (preguntando, si usted activó confirmación de cierre en) y ábralos como ellos mismos; las hojas se abren sobre tu aplicación, que permanece.
Lia.openLiaLink("mine"); // Lia's mining sheet, over your appscreen | Abre | Tu app |
|---|---|---|
"invite" | Invitar amigos a Lia | Cierra |
"strides" | Strides | Cierra |
"activity" | La persona's actividad | Cierra |
"send" | Enviar $LIA | Cierra |
"apps" | El Centro de Aplicaciones | Cierra |
"streak" | La racha de check-in | Permanece |
"mine" | Minado | Permanece |
"receive" | Recibir $LIA | Permanece |
Se resuelve con { closed }: true si tu app se cerró, false si se quedó (o la persona eligió quedarse). Errores: unknown_screen, bad_screen.
#Rostro ID y Tacto ID
#Lia.biometric
Pida a la persona que lo confirme'ellos, con el teléfono's Face ID, Touch ID o huella dactilar, antes de algo sensible en tu aplicación. Tu aplicación solo aprende si pasaron.
#Lia.biometric.init()
Si el teléfono puede hacerlo. Resuelve con { available, type }: available es verdadero cuando el teléfono lo tiene y lo's configurado; type es "face", "finger" o "unknown".
#Lia.biometric.authenticate(options)
Pide a la persona que confirme. Resuelve con { authenticated }. Si pueden'usar biométricos, el teléfono puede ofrecer su código de acceso en su lugar.
const { available } = await Lia.biometric.init();
if (available) {
const { authenticated } = await Lia.biometric.authenticate({ reason: "Confirm it's you to open your vault" });
}| Opción | Tipo | |
|---|---|---|
reason | cadena | Opcional, mostrado por el teléfono, hasta 128 caracteres. Lia'su propia palabra cuando se deja afuera. |
Errores: unsupported, busy, bad_reason.
#Movimiento
Tres sensores, cada uno con start, stop, isStarted y su última lectura. Las lecturas llegan como eventos mientras un sensor funciona; se detiene cuando cierras la aplicación. Todos son opcionales en los teléfonos: start() falla con unsupported donde allí'ninguno.
| Sensor | Leyendo | Unidades | Evento |
|---|---|---|---|
Lia.accelerometer | x, y, z | m/s², incluida la gravedad | "accelerometerChanged" |
Lia.gyroscope | x, y, z | Tasa de rotación, radianes por segundo | "gyroscopeChanged" |
Lia.deviceOrientation | alpha, beta, gamma | Ángulos en radianes | "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
| Miembro | |
|---|---|
start(options) | Comienza las lecturas. options.refreshRate: 20 a 1000 ms entre lecturas, 1000 por defecto. Resuelve con true; también dispara "accelerometerStarted". Errores: bad_refresh_rate, unsupported. |
stop() | Los detiene. Resuelve con true; también dispara "accelerometerStopped". |
isStarted | Si lo'en ejecución. |
x, y, z | La lectura más reciente, null antes del primero. |
#Lia.gyroscope
Lo mismo que Lia.accelerometer, con x, y y z tasas de rotación.
#Lia.deviceOrientation
Lo mismo, con alpha, beta y gamma.
Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés