LiaWafanyikaji

SDK mazoezi

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 Error ambapo ina code (na message kwenye 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.available kukabili 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.

VipengeleAinaNini inayo
Lia.versionnenoKundi la SDK'version, kama mfano "1.8.0".
Lia.availablebooleantrue kwenye mchezo wa Lia. Inajulikana kwa kawaida kama script inapita.
Lia.platformneno"ios" au "android" ("unknown" kabla init()).
Lia.languagenenoMtu's lugha kwenye Lia: en, es, pt, fr, tr, ru, vi, id, fil, sw, hi, ar au zh. Tazama Lugha.
Lia.rtlbooleanKama lugha hii ina kuzungumza kwa kushoto kwa kulia (Arabu).
Lia.colorSchemeneno"light" au "dark".
Lia.themekifundoLia'zilizopita kwa rangi, kama bg_color, text_color na mengine wengine. Tazama Lia'kawaida.
Lia.viewportkifundo{ height, expanded }: mchezo wako's height kwenye px, na kama sheet ina kiasi kamilifu.
Lia.safeAreakifundo{ top, bottom, left, right }: simu'kikosi cha asili katika px.
Lia.contentSafeAreakifundo{ top, bottom, left, right }: pia kuchanganya na Lia's floating controls kwenye fullscreen.
Lia.displaynenoKama mzungu alikwenda: "sheet", "full" au "fullscreen".
Lia.isFullscreenbooleanKama ina'zilizopita kwa kushuka kwa kushuka kwa siku hii.
Lia.startParamneno au nullNini iliyopakia: kifuniko'link's au maelekezo's startParam. null wakati ifungwa kutoka kwenye Apps Center.
Lia.soundOnbooleanKama mwanachama anataka app yako'kawaida.
Lia.notificationsAllowedbooleanKama 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 });
ParametaAina
versionnenoKama "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

MkoaMethode
Kuanza na mafundishoLia.init, Lia.ready, Lia.session, Lia.close, Lia.on, Lia.off, Lia.onPause, Lia.onResume
Malipo na mawasilianoLia.pay, Lia.charges, Lia.onCharge, Lia.showAd, Lia.showRewardedAd, Lia.showRewardedInterstitialAd, Lia.showInterstitialAd, Lia.onAd
Maangazaji na mazoeziLia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.share
MajibuLia.confirm, Lia.showPopup, Lia.showAlert, Lia.showConfirm, Lia.toast
Mashape, rangi na pichaLia.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
KifunoLia.haptic, Lia.scanQr, Lia.copyText, Lia.readClipboard, Lia.openLink, Lia.openLiaLink, Lia.biometric, Lia.accelerometer, Lia.gyroscope, Lia.deviceOrientation
Matokeo na kuhifadhiLia.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:

TelegramLia
Telegram.WebApp.initDataLia.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, SettingsButtonLia.mainButton, Lia.secondaryButton, Lia.backButton, Lia.settingsButton
HapticFeedbackLia.haptic(kind)
CloudStorage, DeviceStorage, SecureStorageLia.cloudStorage, Lia.deviceStorage, Lia.secureStorage (hutumia promise badala ya callback)
showPopup, showAlert, showConfirmKama kama, kama mafunzo
openInvoice na StarsLia.pay(productId), inatolewa kwenye $LIA
start_paramLia.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 kujibu true tu 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

Aina kusoma kila mfumo, methodi na endpoint.