Liaविकासकर्ता

SDK संदर्भ

Lia SDK को लोड करें, Lia ऑब्जेक्ट के गुण, कॉल कैसे उत्तर देते हैं और विफल होते हैं, और प्रत्येक विधि की एक सूची।

#इसे लोड करें

<script src="https://api.lialabs.org/sdk/lia-apps-v1.js"></script>

अपने स्वयं के स्क्रिप्ट से पहले Lia से लोड करें। यह एक वैश्विक निर्माण के लिए परिभाषित करता है, window.Lia, एक बार (इसे दो बार लोड करने से कुछ भी नहीं होता है)। यह'साधारण JavaScript के साथ कोई निर्भरता नहीं है, और किसी भी फ्रेमवर्क के साथ काम करता है या कोई नहीं। इस पृष्ठ में 1.8.0. संस्करण का वर्णन किया गया है

TypeScript में, जब तक आप अंत नहीं करते।'से एक प्रकार पैकेज:

declare global {
  interface Window { Lia: any }
}
const Lia = window.Lia;

#कैसे कॉल जवाब देते हैं

  • अधिकांश विधियां एक विश्वास लौटाती हैं। इसे प्रत्येक विधि के लिए वर्णित उत्तर के साथ समाप्त करता है, या अस्वीकृत करता है Error तेज जिसके पास एक है code (और एक message आपके लिए अंग्रेजी में, खिलाड़ियों के लिए नहीं।
  • खराब आवेदन भी अस्वीकृत कर देते हैं, एक कोड के साथ जैसे bad_text, कुछ विधियां जो नहीं हैं Lia के लिए।'वापसी प्रतिबद्धताएं (Lia.inviteLink, Lia.on, बटन' सेटर) बजाए फेंक देता है।
  • एप्स के बाहर Lia, प्रत्येक कॉल अस्वीकृत कर देता है साथ not_in_lia. Lia.available तेज आपको शुरू से ही बताता है।
  • Lia 20 सेकंड के भीतर उत्तर देना चाहिए, या कॉल रिजेक्ट हो जाता है timeout. कॉल करते हैं जो व्यक्ति पर इंतजार करते हैं (भुगतान शीट, विज्ञापन, डायलॉग, दोस्त चुनने वाला, सूचना संदेश, स्कैनर, क्लिपबोर्ड, फेस ID, साझा) इतना समय लेते हैं जितना लगता है।
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" });
  }
}

हर कोड की सूची त्रुटि कोड.

#गुण

इनके बाद पढ़ें Lia.init() उत्तर दे चुका है, पहले वे डिफ़ॉल्ट मान रखते हैं। अधिकांश को Lia द्वारा अपडेट रखा जाता है'के घटनाएं।

गुणप्रकारक्या यह है
Lia.versionस्ट्रिंगसभी SDK'राज्य के संस्करण, उदाहरण के लिए "1.8.0".
Lia.availableबूलियनtrue में Lia एप में। जैसे ही स्क्रिप्ट लोड होती है, इसके बारे में पता चल जाता है।
Lia.platformस्ट्रिंग"ios" या "android" ("unknown" पहले init()).
Lia.languageस्ट्रिंगव्यक्ति'भाषा Lia में: en, es, pt, fr, tr, ru, vi, id, fil, sw, hi, ar या zh. देखें भाषा.
Lia.rtlबूलियनक्या यह भाषा दाएं से बाएं पढ़ती है (अरबी)।
Lia.colorSchemeस्ट्रिंग"light" या "dark".
Lia.themeवस्तुLia'अपने रंग, जैसे bg_color, text_color और बाकी। देखें Lia'राज्य के थीम.
Lia.viewportवस्तु{ height, expanded }: आपका पृष्ठ'ऊंचाई पिक्सेल में, और क्या एक शीट पूर्ण ऊंचाई पर है।
Lia.safeAreaवस्तु{ top, bottom, left, right }: फोन'के सुरक्षित क्षेत्र पिक्सेल में।
Lia.contentSafeAreaवस्तु{ top, bottom, left, right }: भी Lia के बिना साफ करें'के फ्लोटिंग कंट्रोल्स पूर्ण स्क्रीन में।
Lia.displayस्ट्रिंगकैसे आपका एप्प खोला गया: "sheet", "full" या "fullscreen".
Lia.isFullscreenबूलियनक्या यह'के किनारे से किनारे अभी।
Lia.startParamस्ट्रिंग या नलजिसके साथ खोला गया था: एक आमंत्रण'लिखता है, एक लिंक'या एक सूचना'के startParam। null जब एप्स सेंटर से खोला जाता है।
Lia.soundOnबूलियनक्या व्यक्ति आपके एप्स को चाहता है'के ध्वनि।
Lia.notificationsAllowedबूलियनक्या वह व्यक्ति आपके एप्स को उन्हें सूचनाएं भेजने की अनुमति देता है।

#Lia.isVersionAtLeast(version)

क्या SDK इस संस्करण के कम से कम है, बाद में जोड़े गए फीचर्स के लिए।

if (Lia.isVersionAtLeast("1.3")) Lia.inviteFriend({ startParam: room });
पैरामीटरप्रकार
versionस्ट्रिंगपसंद करें "1.3" या "1.3.0".

एक बूलियन लौटाता है (एक प्रमिस नहीं)।

#CSS चर

बाद में init(), SDK इसे आपके पेज पर सेट करता है'के मूल और उन्हें अपडेट रखता है: Lia'राज्य के थीम (--lia-bg-color और बाकी), --lia-color-scheme, --lia-viewport-height, --lia-safe-area-inset-* और --lia-content-safe-area-inset-*. देखें देखें और महसूस करें.

#हर विधि

क्षेत्रविधियां
स्टार्टअप और जीवन चक्रLia.init, Lia.ready, Lia.session, Lia.close, Lia.on, Lia.off, Lia.onPause, Lia.onResume
भुगतान और विज्ञापनLia.pay, Lia.charges, Lia.onCharge, Lia.showAd, Lia.showRewardedAd, Lia.showRewardedInterstitialAd, Lia.showInterstitialAd, Lia.onAd
अपडेट और आमंत्रणLia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.share
डायलॉगLia.confirm, Lia.showPopup, Lia.showAlert, Lia.showConfirm, Lia.toast
लेआउट, रंग और बटन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
उपकरणLia.haptic, Lia.scanQr, Lia.copyText, Lia.readClipboard, Lia.openLink, Lia.openLiaLink, Lia.biometric, Lia.accelerometer, Lia.gyroscope, Lia.deviceOrientation
स्कोर और स्टोरेजLia.submitScore, Lia.leaderboard, Lia.cloudStorage, Lia.deviceStorage, Lia.secureStorage

#टेलीग्राम से

Lia'से SDK टेलीग्राम का अनुसरण करता है'से मिनी एप्स जहां यह फिट होता है, इसलिए अधिकांश विचार ले जाएं:

टेलीग्रामLia
Telegram.WebApp.initDataLia.init() एक सत्र टोकन के साथ जिसकी आपके सर्वर जांच करता है POST /session/verify.
themeParams, --tg-theme-*Lia.theme, --lia-* या समान नाम
MainButton, SecondaryButton, BackButton, SettingsButtonLia.mainButton, Lia.secondaryButton, Lia.backButton, Lia.settingsButton
HapticFeedbackLia.haptic(kind)
CloudStorage, DeviceStorage, SecureStorageLia.cloudStorage, Lia.deviceStorage, Lia.secureStorage या कॉलबैक के बजाय प्रमाणित करें
showPopup, showAlert, showConfirmएक ही, जैसे प्रॉमिसेस
openInvoice और स्टार्सLia.pay(productId), $LIA में भुगतान किया गया
start_paramLia.startParam

#वेब-एप्प विश्लेषण

Lia.analytics (SDK 1.8) वर्तमान Lia Labs के साथ काम करता है और OpenPanel परियोजना में ऑप्शनल वेब-एप्प उपयोग को रिकॉर्ड करता है। यह वर्तमान iOS और Android बिल्ड्स के साथ काम करता है। यह एक है अलग से ऑप्ट-इन नेटिव एप के 'शेयर उपयोग डेटा' स्विच से।

जब आपके पेज द्वारा कॉल किया जाता है Lia.ready(), SDK टीम द्वारा एनालिटिक्स सक्षम है या नहीं यह जांचता है और यदि इस एप्प के लिए इस खिलाड़ी ने चयन नहीं किया है तो एक बार पूछता है। अस्वीकृति करने से कोई घटना नहीं भेजी जाती है। एक छोटा गोपनीयता बटन आपको बाद में अपना चयन बदलने की अनुमति देता है। चयन Lia के सर्वर पर प्रत्येक खिलाड़ी और वेब एप्प के लिए संग्रहित किया जाता है। सहमति से पहले कोई एनालिटिक्स घटना बफर नहीं की जाती है या अस्वीकृति के बाद पुनः प्रसारित नहीं की जाती है।

  • Lia.analytics.allowed: यह पृष्ठ वर्तमान में अनुमति के साथ है कि नहीं।
  • Lia.analytics.requestConsent(): पुनः गोपनीयता चयन खोलता है और उत्तर देता है true केवल अनुमति के बाद।
  • Lia.analytics.disable(): इस पृष्ठ के भेजने को तुरंत रोकता है और अस्वीकृति को सहेजता है।
  • Lia.analytics.track(name, properties?): घटना भेजी गई थी कि नहीं यह जांचता है; विफलताएं आपके खेल को कभी नहीं रोकती हैं। नाम छोटे अक्षर, अंक और अंडरस्कोर का उपयोग करते हैं, एक अक्षर से शुरू होते हैं, और अधिकतम 48 अक्षर होते हैं। संपत्ति अधिकतम 12 संख्यात्मक या बूलियन मानों की अनुमति देती है, जिनमें छोटे अक्षर वाले पहचानकर्ता कुंजियां अधिकतम 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 records opening and resuming after consent. Add your own static event names for gameplay milestones. Do not use names, emails, messages, URLs, free text or account identifiers as event names. Text properties are rejected. The collector adds the app id and live/test mode, checks the signed session, rechecks consent, respects the team’s analytics off switch, and limits events to 60 per player per app per minute. It forwards aggregate events without a player profile id, page URLs, form values or the person’s IP address.

एप्प के सर्वर POST /api/web-analytics/consent और /track एक ताजा हस्ताक्षरित एप सत्र के साथ। इन SDK-स्वामित्व बिंदुओं को कोई डेवलपर API कुंजी की आवश्यकता नहीं होती है। OpenPanel पहचान पत्र Lia के सर्वर पर रहते हैं।

ये विश्लेषण विधियाँ script टैग से लोड होने वाले होस्ट किए गए SDK में हैं। आमंत्रण और लॉबी लिंक अपने आप सहमति का अनुरोध नहीं खोलते; गोपनीयता बटन उपलब्ध रहता है।

स्वचालित अनुवाद। अंग्रेजी सत्य का स्रोत है। अंग्रेजी में पढ़ें

किसी भी पृष्ठ, विधि और एंडपॉइंट के लिए खोजने के लिए प्रकार।