SDK 参考
启动和生命周期
复制页面
Lia.init,Lia.ready,Lia.session和Lia.close,以及每个事件Lia发送到你的页面。
#Lia.init()
首先调用它。它会回答玩家是谁以及你的应用如何显示,还会填充 SDK's 属性 和CSS变量。
const me = await Lia.init();返回:
| 字段 | 类型 | 它是什么 |
|---|---|---|
player | 对象 | { id, name }: 播放器'的应用中的id,以及他们的Lia用户名。参见 玩家. |
session | 字符串 | 您的服务器的会话令牌, lias_…. |
exp | 数字 | 当会话结束时,以1970为起点的毫秒数(打开后15分钟)。 |
mode | 字符串 | "test" 或 "live". |
language | 字符串 | 这个人'的语言在Lia中,例如 "en". |
rtl | 布尔值 | 它是否从右到左显示。 |
platform | 字符串 | "ios" 或 "android". |
theme | 字符串 | "light" 或 "dark". |
themeParams | 对象 | Lia'的颜色(bg_color, text_color…). |
display | 字符串 | "sheet", "full" 或 "fullscreen". |
isFullscreen | 布尔值 | 边缘到边缘或不是。 |
viewport | 对象 | { height, expanded } |
safeArea | 对象 | { top, bottom, left, right } 以像素为单位 |
contentSafeArea | 对象 | { top, bottom, left, right } 以像素为单位 |
startParam | 字符串或空值 | 你的应用最初打开时的内容。 |
link | 字符串 | 您的应用程序'的邀请链接,没有startParam。 |
sound | 布尔值 | 这个人是否想要你的应用'的声音。 |
notifications | 对象 | { allowed, available }: 他们是否允许您的通知,以及您的应用是否可以请求。 |
错误: not_in_lia, not_ready (Lia 正在打开应用;稍后再试), timeout.
#Lia.ready()
告诉 Lia 你的页面已绘制完成,所以它会移除加载器。在你的第一个屏幕出现在页面上后调用它。返回 nothing。
Lia.init().then(function (me) {
renderHome(me);
Lia.ready();
});#Lia.session()
一个用于你的服务器的新会话令牌。会话持续15分钟,所以在你的服务器必须信任的调用之前获取一个新的。
const { session, exp } = await Lia.session();以 { session, exp }。错误: not_open (那个人没有'尚未在Lia中打开您的应用;请致电 init() 首先), timeout.
#Lia.close()
关闭你的应用。解析为 null。如果你打开了 关闭确认,这会直接关闭而无需询问。
#Lia.on(event, listener)
监听 Lia 中的一个'的事件。返回一个停止监听的函数。
const stop = Lia.on("theme", function (data) { redraw(data.colorScheme); });
// later
stop();投掷 bad_listener 如果 listener 是不't 一个函数。一个抛出异常的监听器。'停止其他操作。
#Lia.off(event, listener)
停止使用 Lia.on.
#Lia.onPause(listener)
与...相同 Lia.on("pause", listener)。返回一个停止监听的函数。
#Lia.onResume(listener)
与...相同 Lia.on("resume", listener).
#事件
| 事件 | 数据 | 何时 |
|---|---|---|
"pause" | 无 | Lia进入后台,或者其中一个Lia'的屏幕(付款表单、广告、对话框)覆盖了您的应用。暂停计时器和声音。 |
"resume" | 无 | 再次返回。 |
"theme" | { theme, colorScheme } | 这个人将 Lia 在亮色和暗色之间切换。 theme 是新颜色。CSS 变量已更新。 |
"viewport" | { height, expanded, isStateStable } | 您的页面'的高度发生变化(面板被拉起,底部按钮显示)。 |
"fullscreenChanged" | { isFullscreen, contentSafeArea } | 您的应用程序进入或退出全屏。 |
"languageChanged" | { language, rtl } | 这个人更改了 Lia'的语言。 |
"startParam" | { startParam } | 当您的应用已打开时,打开了该应用的通知或邀请。 |
"notificationsChanged" | { allowed } | 允许或阻止你的应用的这个人'的通知。 |
"soundChanged" | { on } | 这个人从 Lia 中静音或取消静音你的应用'的⋯菜单。 |
"charge" | { chargeId, productId } | 在没有 Lia.pay() 正在等待(在重新加载后)。另外 Lia.onCharge. |
"ad" | { state, format } | 一个广告'的阶段: "loading", "showing" 或 "closed"。另外 Lia.onAd. |
"banner" | { state, position, height, reason? } | 横幅's "loading", "shown", "failed" 或 "hidden"。另外 Lia.onBanner. |
"nativeAd" | { state, placement, height? } | 一个原生广告's "loading", "showing" 或 "closed"。另外 Lia.onNativeAd. |
"safeAreaChanged" | { safeArea, contentSafeArea } | 一个停靠的横幅或原生卡片占用了或归还了一个边缘:Lia在它周围有填充,因此你在那里的安全区域是0. CSS变量已经更新。 |
"mainButtonClicked" | 无 | 主按钮被按下。也 Lia.mainButton.onClick. |
"secondaryButtonClicked" | 无 | 次要按钮被按下。 |
"backButtonClicked" | 无 | 标题's 返回按钮被按下。 |
"settingsButtonClicked" | 无 | 设置在 ⋯ 菜单中被选中。 |
"accelerometerChanged" | { x, y, z } | 在加速度计运行时的读数。 |
"gyroscopeChanged" | { x, y, z } | 在陀螺仪运行时的读数。 |
"deviceOrientationChanged" | { alpha, beta, gamma } | 在方向运行时的读数。 |
"accelerometerStarted", "accelerometerStopped" | 无 | 传感器已启动或停止。也适用于 gyroscope 和 deviceOrientation. |
SDK 更新其自己的属性(Lia.colorScheme, Lia.viewport, Lia.language, Lia.soundOn 和其余部分)在你的监听器运行之前。
自动翻译。英语是真实来源。 阅读英文