SDK mazoezi
SDK mazoezi
Kutuma mstereani
Kumbuka Lia SDK, mali ya Lia object, kwa kila kumbukumbu inapokea na kushindwa, na index ya kila method.
#Kumbuka kwa
<script src="https://api.lialabs.org/sdk/lia-apps-v1.js"></script>Kumbuka kwa Lia, kabla ya script yako mwenyewe. Ina maelezo ya moja ya kawaida, window.Lia, kwa muda mmoja (kufundisha kwa muda mmoja sio kipimo). Ina's kichaguo cha JavaScript kwa kifupi bila mengine, na kazi na kila framework au bila kifupi. Mstari huu inaonyesha version 1.8.0.
Katika TypeScript, ujumbe wa dunia hadi wakati's kipimo cha kipimo:
declare global {
interface Window { Lia: any }
}
const Lia = window.Lia;#Kama mzungu hujibu
- Mipango ya kawaida yana kusaidia kama matokeo. Inapakia na jawabu lililokifundisha kwa kila method, au inatoka na
Errorambapo inacode(namessagekwenye Kiingereza kwa mwenyewe, sio kwa mchezo wao). - Majibu ya kisahau hujisalimisha kwa kawaida, na kifupi kama
bad_text, kabla ya kushuka kwenye Lia. Kuna baadhi ya methodo ambayo sio'kukabili kwenye promises (Lia.inviteLink,Lia.on, picha' setter) hutoa thamani ya kushoto. - Nje ya programu ya Lia, kila mipango inazozunguka kwa
not_in_lia.Lia.availablekukabili kwenye kisasi kwa kwanza. - Lia inapaswa kujibu kwenye 20 sekunde, au kumbukumbu inaonyesha
timeout. Mipango ambayo hawakamata kwa mwanamme (kificho cha malipo, mawasilio, mazungumzo, kuchagua mwanafunzi, mazungumzo ya kumbukumbu, mchakato, kificho cha kifuniko, Face ID), hawakamata kama ilivyotaka.
try {
const result = await Lia.pay("extra-lives");
} catch (error) {
switch (error.code) {
case "cancelled": return; // they changed their mind
case "not_in_lia": return showOpenInLia();
default: Lia.toast("Something went wrong", { tone: "error" });
}
}Kila kodi inaonyeshwa katika Kosa kodi.
#Vipengele
Kusoma baadhi ya Lia.init() amejibu; kabla ya hilo wao wamepiga matokeo. Kwa kawaida wao wamepiga matokeo kwa Lia'zilizopita mafanikio.
| Vipengele | Aina | Nini inayo |
|---|---|---|
Lia.version | neno | Kundi la SDK'version, kama mfano "1.8.0". |
Lia.available | boolean | true kwenye mchezo wa Lia. Inajulikana kwa kawaida kama script inapita. |
Lia.platform | neno | "ios" au "android" ("unknown" kabla init()). |
Lia.language | neno | Mtu's lugha kwenye Lia: en, es, pt, fr, tr, ru, vi, id, fil, sw, hi, ar au zh. Tazama Lugha. |
Lia.rtl | boolean | Kama lugha hii ina kuzungumza kwa kushoto kwa kulia (Arabu). |
Lia.colorScheme | neno | "light" au "dark". |
Lia.theme | kifundo | Lia'zilizopita kwa rangi, kama bg_color, text_color na mengine wengine. Tazama Lia'kawaida. |
Lia.viewport | kifundo | { height, expanded }: mchezo wako's height kwenye px, na kama sheet ina kiasi kamilifu. |
Lia.safeArea | kifundo | { top, bottom, left, right }: simu'kikosi cha asili katika px. |
Lia.contentSafeArea | kifundo | { top, bottom, left, right }: pia kuchanganya na Lia's floating controls kwenye fullscreen. |
Lia.display | neno | Kama mzungu alikwenda: "sheet", "full" au "fullscreen". |
Lia.isFullscreen | boolean | Kama ina'zilizopita kwa kushuka kwa kushuka kwa siku hii. |
Lia.startParam | neno au null | Nini iliyopakia: kifuniko'link's au maelekezo's startParam. null wakati ifungwa kutoka kwenye Apps Center. |
Lia.soundOn | boolean | Kama mwanachama anataka app yako'kawaida. |
Lia.notificationsAllowed | boolean | Kama mwanachama anasirikia app yako kusubiri kuzalisha mabadiliko. |
#Lia.isVersionAtLeast(version)
Kama SDK ina kama hii version, kwa mafunzo yaliyotengenezwa baadaye.
if (Lia.isVersionAtLeast("1.3")) Lia.inviteFriend({ startParam: room });| Parameta | Aina | |
|---|---|---|
version | neno | Kama "1.3" au "1.3.0". |
Inashiria boolean (sio mafunzo).
#CSS mabadiliko
Baada init(), SDK inaandika kwa mfumo wako'kikosi cha asili na kusigira kwa muda wa mmoja: Lia'kawaida (--lia-bg-color na mengine wengine), --lia-color-scheme, --lia-viewport-height, --lia-safe-area-inset-* na --lia-content-safe-area-inset-*. Tazama Tazama na kuvutia.
#Kila njia
| Mkoa | Methode |
|---|---|
| Kuanza na mafundisho | Lia.init, Lia.ready, Lia.session, Lia.close, Lia.on, Lia.off, Lia.onPause, Lia.onResume |
| Malipo na mawasiliano | Lia.pay, Lia.charges, Lia.onCharge, Lia.showAd, Lia.showRewardedAd, Lia.showRewardedInterstitialAd, Lia.showInterstitialAd, Lia.onAd |
| Maangazaji na mazoezi | Lia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.share |
| Majibu | Lia.confirm, Lia.showPopup, Lia.showAlert, Lia.showConfirm, Lia.toast |
| Mashape, rangi na picha | Lia.expand, Lia.requestFullscreen, Lia.exitFullscreen, Lia.enableExpand, Lia.disableExpand, Lia.enableVerticalSwipes, Lia.disableVerticalSwipes, Lia.enableClosingConfirmation, Lia.disableClosingConfirmation, Lia.setBackgroundColor, Lia.setHeaderColor, Lia.mainButton, Lia.secondaryButton, Lia.backButton, Lia.settingsButton |
| Kifuno | Lia.haptic, Lia.scanQr, Lia.copyText, Lia.readClipboard, Lia.openLink, Lia.openLiaLink, Lia.biometric, Lia.accelerometer, Lia.gyroscope, Lia.deviceOrientation |
| Matokeo na kuhifadhi | Lia.submitScore, Lia.leaderboard, Lia.cloudStorage, Lia.deviceStorage, Lia.secureStorage |
#Kuzalisha kutoka Telegram
Lia'Mini Apps ambapo inapatikana SDK.'Mini Apps ambapo inapatikana, kwa hiyo mazinga mengi inapokelewa:
| Telegram | Lia |
|---|---|
Telegram.WebApp.initData | Lia.init() jibu na token ya kisasa ambapo serikali yako inatuhusu kwa POST /session/verify. |
themeParams, --tg-theme-* | Lia.theme, --lia-* (jina moja) |
MainButton, SecondaryButton, BackButton, SettingsButton | Lia.mainButton, Lia.secondaryButton, Lia.backButton, Lia.settingsButton |
HapticFeedback | Lia.haptic(kind) |
CloudStorage, DeviceStorage, SecureStorage | Lia.cloudStorage, Lia.deviceStorage, Lia.secureStorage (hutumia promise badala ya callback) |
showPopup, showAlert, showConfirm | Kama kama, kama mafunzo |
openInvoice na Stars | Lia.pay(productId), inatolewa kwenye $LIA |
start_param | Lia.startParam |
#Unganisho wa web-app
Lia.analytics (SDK 1.8) inatengeneza maelekezo ya matumizi ya web-app ya kujifunza kwa Lia Labs’ OpenPanel project. Inafanya kazi na matokezi ya sasa ya iOS na Android. Hii ni kutafuta kwa kutoa na swichi ya “Shiriki data ya matumizi” ya programu asilia.
Wakati mfululizo wako unayotuma Lia.ready(), SDK inatufanyia kuchekoa kama analytics inaendeshwa na kampuni na kuchukua moja kama mwanachama hajakosa kwa app hii. Kukata kama haujafunzwa hajapokea matukio. Picha ya kisasa inaonyesha jinsi mwanachama anaweza kubadilisha matakwa yake baadaye. Matakwa unapewa kwa mwanachama na app ya web kwenye server ya Lia. Hakuna matukio ya analytics yanasimama kabla ya ujumbe au kuzingatia baadhi ya kuzungumza.
Lia.analytics.allowed: kama tovuti ina tafsiri sasa.Lia.analytics.requestConsent(): inaundwa tena kumbukumbu la usalama na kujibutruetu baada ya ujumbe.Lia.analytics.disable(): inachukua siku ya kushinda kwa kila kumbukumbu la kushiriki na kusave kwa kushiriki.Lia.analytics.track(name, properties?): inatoa jibu kuhusu kama tovuti ilikuwa iliyotumwa; kushindwa hajafunika mchezo wako. Jina linaloitwa kwa harufa ya chini, namba na underscores, inaanza na harufa ya chini, na ni chini ya 48 harufa. Vipimo vina mengine ya 12 thamani ya nambari au ya booleani, na kichwa cha jina kwa harufa ya chini chenye harufa 32.
await Lia.init();
Lia.ready();
// Only sends when the person has already agreed. Never prompt during a round.
await Lia.analytics.track("round_finished", { level: 3, score: 120, won: true });The SDK inatengeneza na kuzalisha baada ya ujumbe. Ongeza jina lako la kawaida la mchakato wa mchezo. Usisimua jina, barua pepe, umbo, URLs, kifupi au maelezo ya kifundizo kama jina la mchakato. Maelezo ya kifupi haujulikani. Collector inatumia app id na kipimo cha kusafiri, kuchekua sesi iliyosajiliwa, kuchekua ujumbe tena, kuzikumbuka mchakato wa analytics wa kundi, na kuzidhibiti mchakato kwa 60 kwa mtumiaji mmoja kwa app mmoja kwa dakika. Inatumia mchakato wa kawaida bila ID ya profaili ya mtumiaji, ukurasa URLs, thamani za fomu au anwani ya mtu IP.
Tracker inatumia POST /api/web-analytics/consent na /track na mfumo wa kusajili kwa kusajili kwa kusajili. Mipango ya SDK yana kisasa kisasa kwa mwanachama. API ya mwanachama haujafunzwa. OpenPanel ya kuthibitisha haujafunzwa kwenye serikali ya Lia.
Mbinu hizi za uchanganuzi zipo kwenye SDK iliyohifadhiwa inayopakiwa kwa lebo ya script. Viungo vya mwaliko na ukumbi havifungui ombi la ruhusa kiotomatiki; kitufe cha faragha kinaendelea kupatikana.
Kutafsiri kwa kawaida. Kiingereza kina maana ya kawaida. Kusoma kwa Kiingereza