SDK 参考
设备
复制页面
触觉反馈、QR扫描器、剪贴板、链接、Lia自己的屏幕、Face ID和Touch ID,以及运动传感器。
#触觉反馈
#Lia.haptic(kind)
一个人感受到的点击。以 null.
Lia.haptic("success");kind | 感觉像 |
|---|---|
"light" (默认), "medium", "heavy", "rigid", "soft" | 从轻到重的点击 |
"success", "warning", "error" | 一个结果 |
"selection" | 一个用于选择更改的标记 |
一种未知的类型在玩 "light"。每个触觉反馈都需要一次往返到Lia,所以不要'每帧游戏都播放一个。
#扫描与剪贴板
#Lia.scanQr(options)
打开 Lia's QR 扫描器扫描你的应用。返回代码'的文字,或者 null 如果那个人关闭了它。
const text = await Lia.scanQr({ text: "Scan the code on the table" });| 选项 | 类型 | |
|---|---|---|
text | 字符串 | 可选,位于扫描器下方'的窗口,最多64个字符。 |
错误: bad_text, busy.
#Lia.copyText(text)
将文本复制到剪贴板,并且Lia会这样说'的复制。以 null.
| 参数 | 类型 | |
|---|---|---|
text | 字符串 | 最多4096 个字符。 |
错误: bad_text, unsupported.
#Lia.readClipboard()
剪贴板上的文本,或 null。在iPhone上,手机会先询问用户。
const pasted = await Lia.readClipboard();#链接
#Lia.openLink(url, options)
打开一个网页。您的框架只显示您自己的页面,因此可用于其他网站。
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| 参数 | 类型 | |
|---|---|---|
url | 字符串 | 一个 https 地址,最多 2048 个字符。 |
options.external | 布尔值 | 在 Lia 外打开它。 |
以 null 一旦应用内浏览器关闭(或直接对于 external)。错误: bad_url.
#Lia.openLiaLink(screen)
打开 Lia 中的一个'自己的屏幕。页面会先关闭你的应用(如果你关闭了), 关闭确认 (打开)并以自身形式打开;表格在您的应用之上打开,而您的应用保持不变。
Lia.openLiaLink("mine"); // Lia's mining sheet, over your appscreen | 打开 | 您的应用程序 |
|---|---|---|
"invite" | 邀请朋友到Lia | 关闭 |
"strides" | 步数 | 关闭 |
"activity" | 这个人's 活动 | 关闭 |
"send" | 发送 $LIA | 关闭 |
"apps" | 应用中心 | 关闭 |
"streak" | 签到连续天数 | 保持 |
"mine" | 挖矿 | 保持 |
"receive" | 接收 $LIA | 保持 |
以 { closed }: true 如果您的应用关闭了, false 如果它保持(或那个人选择保持)。错误: unknown_screen, bad_screen.
#面部ID和触控ID
#Lia.biometric
请该人确认它'用电话'的ID,ID 或指纹,在应用中进行某些敏感操作之前。你的应用只会知道它们是否通过。
#Lia.biometric.init()
手机是否可以执行此操作。返回 { available, type }: available 是真,当手机有它且它'的设置; type 是 "face", "finger" 或 "unknown".
#Lia.biometric.authenticate(options)
请用户确认。返回 { authenticated }。如果他们可以'使用生物识别,手机可能会提供其密码。
const { available } = await Lia.biometric.init();
if (available) {
const { authenticated } = await Lia.biometric.authenticate({ reason: "Confirm it's you to open your vault" });
}| 选项 | 类型 | |
|---|---|---|
reason | 字符串 | 可选,由手机显示,最多 128 个字符。Lia'自己被遗漏时的词语。 |
错误: unsupported, busy, bad_reason.
#运动
三个传感器,每个传感器带有 start, stop, isStarted 以及它的最新读数。当传感器运行时,读数作为事件到达;当您的应用关闭时,它会停止。在手机上,这三者都是可选的: start() 失败时 unsupported 当它'的无。
| 传感器 | 阅读 | 单位 | 事件 |
|---|---|---|---|
Lia.accelerometer | x, y, z | m/s²,包含重力 | "accelerometerChanged" |
Lia.gyroscope | x, y, z | 旋转速率,每秒弧度 | "gyroscopeChanged" |
Lia.deviceOrientation | alpha, beta, gamma | 弧度的角度 | "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
| 成员 | |
|---|---|
start(options) | 开始读取。 options.refreshRate: 20 到 1000 毫秒之间读取,1000 默认。解析为 true; 也触发 "accelerometerStarted"。错误: bad_refresh_rate, unsupported. |
stop() | 停止它们。以 true; 也触发 "accelerometerStopped". |
isStarted | 它是否'正在运行。 |
x, y, z | 最新的读数, null 在第一次之前。 |
#Lia.gyroscope
与...相同 Lia.accelerometer,带有 x, y 和 z 旋转率。
#Lia.deviceOrientation
相同的,带有 alpha, beta 和 gamma.
自动翻译。英语是真实来源。 阅读英文