SDK reference

Startup at lifecycle

Kopya ang pahina

Lia.init, Lia.ready, Lia.session at Lia.close, at bawat event Lia na ipinadala ng iyong pahina.

#Lia.init()

Tawagan ito unang. Sasagot ito kung sino ang player at lahat ng tungkol kung paano ipapakita ang iyong app, at puno ang SDK's mga katangian at CSS variables.

const me = await Lia.init();

Nag-uugnay sa:

Kampo	Uri	Ano ito
`player`	object	`{ id, name }`: ang player's id sa iyong app, at ang kanilang Lia username. Tingnan ang Mga manlalaro.
`session`	string	Isang sesyon token para sa iyong server, `lias_…`.
`exp`	bilang	Kapag ang sesyon ay natapos, sa milisegundo mula 1970 (15 minuto pagkatapos ng pagbubukas).
`mode`	string	`"test"` o `"live"`.
`language`	string	Ang tao'ng wika sa Lia: `"en"`.
`rtl`	boolean	Kung ang pagbasa nito ay mula kanan papalibot.
`platform`	string	`"ios"` o `"android"`.
`theme`	string	`"light"` o `"dark"`.
`themeParams`	object	Lia'na mga kulay (`bg_color`, `text_color`…).
`display`	string	`"sheet"`, `"full"` o `"fullscreen"`.
`isFullscreen`	boolean	Mula sa edge hanggang edge o hindi.
`viewport`	object	`{ height, expanded }`
`safeArea`	object	`{ top, bottom, left, right }` sa px
`contentSafeArea`	object	`{ top, bottom, left, right }` sa px
`startParam`	string o null	Ano ang naka-open ng iyong app.
`link`	string	Ang iyong app's invite link, walang startParam.
`sound`	boolean	Kung ang tao ay nais ang iyong app'ang sounds.
`notifications`	object	`{ allowed, available }`: kung sila ay pahintulotan ang iyong mga notification, at kung maaari ang iyong app magtanong.

Mga error: not_in_lia, not_ready (Lia ay patuloy na buksan ang app; subukan muli nang maaga), timeout.

#Lia.ready()

Nagsasabi sa Lia na ang iyong pahina ay naiskedyul, kaya ito alisin ang loader nito. I-call ito kapag ang unang screen mo ay nasa pahina. Walang balik.

Lia.init().then(function (me) {
  renderHome(me);
  Lia.ready();
});

#Lia.session()

Isang bagong session token para sa iyong server. Ang mga session ay tumatagal ng 15 minuto, kaya kumuha ng bagong isa bago ang mga tawag na kailangan ng iyong server na maniwala.

const { session, exp } = await Lia.session();

Nag-uugnay sa { session, exp }. Mga error: not_open (ang tao ay wala'hindi maaabot buksan ang iyong app sa Lia pa rin; tawagan init() una), timeout.

#Lia.close()

Nag-uusap ang iyong app. Nag-uusap sa null. Kung iyong inaaktibo pangwakas na kumpirmasyon, ito ay nagsisimula nang walang pagtanong.

#Lia.on(event, listener)

Nag-uusap para sa isang sa Lia'ang mga event. Nagbabalik ng isang function na humihinto sa pagsubaybay.

const stop = Lia.on("theme", function (data) { redraw(data.colorScheme); });
// later
stop();

Mga bato bad_listener kung listener ay hindi't isang function. Isang tagapakinig na nagbubuga ng'hindi maaabot i-stop ang iba.

#Lia.off(event, listener)

Nagtatapos ang isang listener na idinagdag gamit Lia.on.

#Lia.onPause(listener)

Ang pareho tulad ng Lia.on("pause", listener). Babalik ang isang function na tumigil sa pagpakinig.

#Lia.onResume(listener)

Ang pareho tulad ng Lia.on("resume", listener).

#Mga event

Event	Data	Kailan
`"pause"`	wala	Lia ay pumunta sa background, o isang sa Lia's screens (ang pay sheet, isang ad, isang dialog) ay naka-cover ang iyong app. I-pause ang mga timer at sound.
`"resume"`	wala	Ulitin.
`"theme"`	`{ theme, colorScheme }`	Ang tao ay nagbago ng Lia sa pagitan ng madilim at liwanag. `theme` ay ang bagong mga kulay. Ang CSS variables ay nasa update na.
`"viewport"`	`{ height, expanded, isStateStable }`	Ang iyong pahina'ng height ng header sa px, at kung ang isang sheet ay nasa full height.
`"fullscreenChanged"`	`{ isFullscreen, contentSafeArea }`	Ang iyong app ay pumunta sa o mula sa fullscreen.
`"languageChanged"`	`{ language, rtl }`	Ang tao ay nagbago ng Lia's wika.
`"startParam"`	`{ startParam }`	Ang isang pahayag o panata para sa iyong app ay buksan habang ito ay nasa bukas na estado.
`"notificationsChanged"`	`{ allowed }`	Ang tao na pinahintulutan o pinigil ang iyong app'mga notification.
`"soundChanged"`	`{ on }`	Ang tao ay inmute o inunmute ang iyong app mula sa Lia's ⋯ menu.
`"charge"`	`{ chargeId, productId }`	Ang isang pagbabayad ay kinumpirma habang walang `Lia.pay()` ay naghihintay (pagkatapos ng isang reload). Gayundin `Lia.onCharge`.
`"ad"`	`{ state, format }`	Isang ad'ang stage: `"loading"`, `"showing"` o `"closed"`. Bukod pa `Lia.onAd`.
`"banner"`	`{ state, position, height, reason? }`	Ang banner's `"loading"`, `"shown"`, `"failed"` o `"hidden"`. Bukod pa `Lia.onBanner`.
`"nativeAd"`	`{ state, placement, height? }`	Isang native ad's `"loading"`, `"showing"` o `"closed"`. Bukod pa `Lia.onNativeAd`.
`"safeAreaChanged"`	`{ safeArea, contentSafeArea }`	Isang docked banner o native card ay kumuha o ibinalik ang isang gilid: ang Lia pads sa paligid nito, kaya ang iyong safe area doon ay 0. CSS ang mga variable ay nai-update na.
`"mainButtonClicked"`	wala	Ang pangunahing pindutan ay napindot. Din `Lia.mainButton.onClick`.
`"secondaryButtonClicked"`	wala	Ang pangalawang pindutan ay pinindot.
`"backButtonClicked"`	wala	Ang header'na pindutan ng back ay pinindot.
`"settingsButtonClicked"`	wala	Ang setting ay napili sa menu ng ⋯.
`"accelerometerChanged"`	`{ x, y, z }`	Isang pagbasa, habang ang accelerometer ay gumagana.
`"gyroscopeChanged"`	`{ x, y, z }`	Isang pagbasa, habang ang gyroscope ay gumagana.
`"deviceOrientationChanged"`	`{ alpha, beta, gamma }`	Isang pagbasa, habang ang pag-orientasyon ay gumagana.
`"accelerometerStarted"`, `"accelerometerStopped"`	wala	Ang sensor ay nagsimula o tumigil. Din para sa `gyroscope` at `deviceOrientation`.

Ang SDK nagpapabago ng kanyang sariling mga katangian (Lia.colorScheme, Lia.viewport, Lia.language, Lia.soundOn at ang natitira) bago ang iyong mga tagasuskat ay tumakbo.

Awtomatikong isinalin. Ang English ay ang source of truth. Basahin sa Ingles