Referência SDK
Dispositivo
Copiar página
Haptics, o scanner QR, a área de transferência, links, as próprias telas do Lia, Face ID e Touch ID, e os sensores de movimento.
#Haptics
#Lia.haptic(kind)
Uma toque que a pessoa sente. Resolve com null.
Lia.haptic("success");kind | Parece |
|---|---|
"light" (o padrão), "medium", "heavy", "rigid", "soft" | Um toque, de leve a pesado |
"success", "warning", "error" | Um resultado |
"selection" | Um tick, para uma escolha mudando |
Uma espécie desconhecida joga "light". Cada feedback tátil é uma ida e volta para Lia, então não'jogar um a cada quadro de um jogo.
#Varredura e área de transferência
#Lia.scanQr(options)
Abre Lia'no QR scanner sobre seu app. Resolve com o código'texto, ou null se a pessoa o fechou.
const text = await Lia.scanQr({ text: "Scan the code on the table" });| Opção | Tipo | |
|---|---|---|
text | string | Opcional, abaixo do scanner'janela, até 64 caracteres. |
Erros: bad_text, busy.
#Lia.copyText(text)
Copia o texto para a área de transferência, e Lia diz isso'copiado. Resolve com null.
| Parâmetro | Tipo | |
|---|---|---|
text | string | Até 4096 caracteres. |
Erros: bad_text, unsupported.
#Lia.readClipboard()
O texto da área de transferência, ou null. Em iPhone, o telefone pergunta primeiro à pessoa.
const pasted = await Lia.readClipboard();#Links
#Lia.openLink(url, options)
Abre uma página da web. Seu quadro só mostra as suas próprias páginas, então use isto para qualquer outro 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| Parâmetro | Tipo | |
|---|---|---|
url | string | Um endereço https, até 2048 caracteres. |
options.external | booleano | Abra fora do Lia. |
Resolve com null uma vez que o navegador integrado for fechado (ou logo em seguida para external). Erros: bad_url.
#Lia.openLiaLink(screen)
Abre um dos Lia'seu próprio telas. Páginas fecham seu app primeiro (perguntando, se você ativou confirmação de fechamento e abra como eles mesmos; as planilhas abrem sobre seu app, que permanece.
Lia.openLiaLink("mine"); // Lia's mining sheet, over your appscreen | Abre | Seu app |
|---|---|---|
"invite" | Convide amigos para Lia | Fecha |
"strides" | Strides | Fecha |
"activity" | A pessoa's atividade | Fecha |
"send" | Enviar $LIA | Fecha |
"apps" | O Apps Center | Fecha |
"streak" | A sequência de check-in | Permanece |
"mine" | Mineração | Permanece |
"receive" | Receber $LIA | Permanece |
Resolve com { closed }: true se o seu app foi fechado, false se ele permaneceu (ou a pessoa escolheu permanecer). Erros: unknown_screen, bad_screen.
#Face ID e Touch ID
#Lia.biometric
Peça à pessoa para confirmar'eles, com o telefone'no ID Face, Touch ID ou impressão digital, antes de algo sensível no seu app. Seu app só aprende se eles passaram.
#Lia.biometric.init()
Se o telefone pode fazer isso. Resolve com { available, type }: available é verdadeiro quando o telefone tem e ele'configurado; type é "face", "finger" ou "unknown".
#Lia.biometric.authenticate(options)
Pergunta à pessoa para confirmar. Resolve com { authenticated }. Se eles puderem'para usar biometria, o telefone pode oferecer seu código de acesso em vez disso.
const { available } = await Lia.biometric.init();
if (available) {
const { authenticated } = await Lia.biometric.authenticate({ reason: "Confirm it's you to open your vault" });
}| Opção | Tipo | |
|---|---|---|
reason | string | Opcional, mostrado pelo telefone, até 128 caracteres. Lia'suas próprias palavras quando deixadas de fora. |
Erros: unsupported, busy, bad_reason.
#Movimento
Três sensores, cada um com start, stop, isStarted e sua última leitura. As leituras chegam como eventos enquanto um sensor está em execução; ele para quando seu app é fechado. Todos três são opcionais em celulares: start() falha com unsupported onde lá's nenhum.
| Sensor | Leitura | Unidades | Evento |
|---|---|---|---|
Lia.accelerometer | x, y, z | m/s², incluindo a gravidade | "accelerometerChanged" |
Lia.gyroscope | x, y, z | Taxa de rotação, radianos por segundo | "gyroscopeChanged" |
Lia.deviceOrientation | alpha, beta, gamma | Ângulos em radianos | "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
| Membro | |
|---|---|
start(options) | Começa as leituras. options.refreshRate: 20 a 1000 ms entre leituras, 1000 por padrão. Resolve com true; também dispara "accelerometerStarted". Erros: bad_refresh_rate, unsupported. |
stop() | Para eles. Resolve com true; também dispara "accelerometerStopped". |
isStarted | Se ele'está em execução. |
x, y, z | A leitura mais recente, null antes do primeiro. |
#Lia.gyroscope
O mesmo que Lia.accelerometer, com x, y e z taxas de rotação.
#Lia.deviceOrientation
O mesmo, com alpha, beta e gamma.
Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês