SDK संदर्भ
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.initData | Lia.init() एक सत्र टोकन के साथ जिसकी आपके सर्वर जांच करता है POST /session/verify. |
themeParams, --tg-theme-* | Lia.theme, --lia-* या समान नाम |
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 या कॉलबैक के बजाय प्रमाणित करें |
showPopup, showAlert, showConfirm | एक ही, जैसे प्रॉमिसेस |
openInvoice और स्टार्स | Lia.pay(productId), $LIA में भुगतान किया गया |
start_param | Lia.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 में हैं। आमंत्रण और लॉबी लिंक अपने आप सहमति का अनुरोध नहीं खोलते; गोपनीयता बटन उपलब्ध रहता है।
स्वचालित अनुवाद। अंग्रेजी सत्य का स्रोत है। अंग्रेजी में पढ़ें