SDK संदर्भ

Lia.pay, Lia.charges and Lia.onCharge for Lia's pay sheet, Lia.showAd and its shortcuts for full screen ads, and Lia.showBanner and Lia.showNativeAd for banners and native ads.

#भुगतान

देखो भुगतान और भुगतान शीट कैसे काम करते हैं, और कोई वस्तु बेचें पूरे प्रवाह के लिए।

#Lia.pay(productId, options)

खोलता है Lia'आपके उत्पादों में से एक के लिए आपके भुगतान शीट। जब यह खुलता है तो यह समाप्त हो जाता है'आपके भुगतान किए गए; अगर यह नहीं है तो अस्वीकार कर देता है't.

const { chargeId, productId } = await Lia.pay("extra-lives");

// With your own key (SDK 1.5): asking again with the same key charges once and answers with the same chargeId.
const order = "order-" + crypto.randomUUID();
const paid = await Lia.pay("extra-lives", { idempotencyKey: order });

समाप्त होता है { chargeId, productId }. फिर भेजें chargeId इसे आपके सर्वर तक डिलीवर करने के लिए।

अगर पृष्ठ खुले रहते हुए रीलोड हो जाता है, तो चार्ज एक के रूप में आता है "charge" घटना के बजाय (देखें Lia.onCharge).

#इडेम्पोटेंसी कुंजियां

QSDK 1.5 से, वे कॉल जो कुछ बदल देते हैं (Lia.pay, Lia.inviteFriend, Lia.submitScore और क्लाउड स्टोरेज'लिखता है) एक वैकल्पिक idempotencyKey. 24 घंटे के भीतर एक ही कुंजी, नहीं'तब इसे दो बार करें: यह पहले कॉल के समान उत्तर देता है।

• Lia पहले से ही प्रत्येक कॉल को एक बार रखता है जब यह खुद को फिर से प्रयास करता है (एक टूटी हुई संयोजन)। आपका अपना कुंजी आपके पृष्ठ पर सुरक्षा के साथ एक ही तरह से लागू होता है'के पुनः प्रयास और रीलोड: इसे रखें (में Lia.deviceStorage, कहें) जब तक कॉल उत्तर नहीं दिया जाता।
• हर कार्य के लिए एक मुख्य कुंजी बनाएं (crypto.randomUUID() ठीक है) और इसे केवल उस क्रिया के पुनर्प्रयास के लिए फिर से उपयोग करें।
• अलग आर्ग्यूमेंट के साथ एक ही कुंजी अस्वीकृत कर दिया गया है। एक नई क्रिया के लिए एक नया कुंजी उपयोग करें।
• भुगतान के लिए, भुगतान शीट अभी भी व्यक्ति के लिए खुलता है जो पुष्टि करे; एक बार भुगतान करने वाले कुंजी से पुष्टि करना पहले शुल्क के साथ उत्तर देता है और कोई अतिरिक्त शुल्क नहीं होता।
• एक Lia एप्प जो SDK 1.5 से पुराना है'के रिलीज़ ने कुंजी को अनदेखा कर दिया, इसलिए कॉल अभी भी काम करता है, बस आपकी कुंजी के बिना।

#Lia.charges()

इस खिलाड़ी'आपके सर्वर द्वारा भुगतान किए गए शुल्क जो आपके सर्वर नहीं हैं'तब अब तक डिलीवर नहीं किया गया है, सबसे पुराना पहले, अधिकतम 50. कॉल करें जब आपका एप्प खुलता है, और आपके पास जो भी मिलता है उसे डिलीवर करें।

const pending = await Lia.charges(); // [{ chargeId, productId }]
for (const charge of pending) await deliverOnServer(charge.chargeId);

एक ऐरे के साथ समाप्त होता है { chargeId, productId }.

#Lia.onCharge(listener)

एक चार्ज सुनता है जो कि कोई नहीं था Lia.pay() इसकी इंतजार कर रहा था, जैसे कि रीलोड के बाद। सुनने वाला प्राप्त करता है { chargeId, productId }. एक फ़ंक्शन वापस करता है जो सुनना बंद कर देता है। वही है Lia.on("charge", listener).

#विज्ञापन

देखो विज्ञापन फॉर्मेट, गति और अपने सर्वर पर जांच के लिए।

#Lia.showAd(options)

अपने एप पर पूर्ण स्क्रीन विज्ञापन चलाता है। जब यह खत्म हो जाता है तो यह समाप्त हो जाता है'अपने बंद हो गए।

const result = await Lia.showAd({ format: "rewarded" });
if (result.watched) giveReward(result.adId);

समाप्त होता है:

त्रुटियां: bad_format, busy. एक विज्ञापन दिखाने के लिए नहीं होना'एक त्रुटि: यह निर्णय के साथ बर्खास्त कर देता है reason: "no_ad".

#Lia.showRewardedAd(options)

समान रूप से Lia.showAd({ format: "rewarded", onState }). वीडियो जिसे व्यक्ति देखने के लिए चुनता है।

#Lia.showRewardedInterstitialAd(options)

समान रूप से Lia.showAd({ format: "rewardedInterstitial", onState }). Lia पहले व्यक्ति से पूछता है, वॉच और स्किप के साथ; स्किप के साथ अंत होता है reason: "skipped".

#Lia.showInterstitialAd(options)

समान रूप से Lia.showAd({ format: "interstitial", onState }). राउंड के बीच उपयोग करने वाला एक। Lia द्वारा गति दी गई है (डिफ़ॉल्ट रूप से प्रत्येक 90 सेकंड में अधिकतम एक और प्रत्येक 2nd पूछता है): जब यह नहीं होता'तब इसकी बारी होती है, तो यह तुरंत इसके साथ हल कर देता है shown: false, reason: "too_soon".

// Between rounds: ask every time, and let Lia decide.
await Lia.showInterstitialAd();
startNextRound();

#Lia.onAd(listener)

सभी विज्ञापन सुनता है'के चरण, { state, format }, साथ में state में से एक "loading", "showing" और "closed". एक फ़ंक्शन वापस करता है जो सुनना बंद कर देता है। वही है Lia.on("ad", listener).

#Lia.showBanner(options)

एक अनुकूलित बैनर ऊपरी या निचले किनारे पर डालता है, जो Lia आपके पृष्ठ के बाहर बनाता है। आपका पृष्ठ इसके लिए छोटा हो जाता है, इसलिए यह किसी भी चीज को कभी नहीं ढकता ( SDK 1.7)। जब यह खत्म हो जाता है तो यह समाधान हो जाता है'दिखाया गया, या जब तक Lia छोड़ देता है (लगभग 10 सेकंड)।

const banner = await Lia.showBanner({ position: "bottom" });
if (banner.shown) console.log("Banner is", banner.height, "px");

समाप्त होता है { shown: true, position, height }, या { shown: false, reason } साथ में reason में से एक no_ad (कोई लोड नहीं) और off या Lia टीम ने बैनर बंद कर दिए थे। उसी स्थिति के लिए फिर से पूछने पर बैनर पहले से ही ऊपर होता है; अन्य स्थिति के लिए पूछने पर इसे ले जाता है। AdMob इसे तब तक रीफ्रेश करता है जब तक यह'राज्य चालू है।

त्रुटियां: bad_position.

#Lia.hideBanner()

बैनर हटा देता है; आपके पृष्ठ को अपनी जगह वापस मिल जाती है। इसके साथ हल होता है { hidden: true }.

#Lia.banner

बैनर अब: { visible, position, height } (position null है और height 0 जब यहां होता है'कोई नहीं)। --lia-banner-height एक CSS चर के समान ऊंचाई रखता है।

#Lia.onBanner(listener)

बैनर बदल गया है सुनता है: { state, position, height, reason? }, साथ में state में से एक "loading", "shown" (एक रीफ्रेश के बाद फिर से), "failed" और "hidden". एक निचला बैनर है "hidden" जब एक नैटिव कार्ड इसके स्थान पर रहता है, फिर "loading" और "shown" फिर से। एक फ़ंक्शन वापस करता है जो सुनना बंद कर देता है। वही है Lia.on("banner", listener).

#Lia.showNativeAd(options)

एक नैटिव विज्ञापन Lia में'अपने लॉबी, अपने एप्प में एक रुकावट के लिए (SDK 1.7)।

// A results screen: a sponsored card docked under it.
const ad = await Lia.showNativeAd({ placement: "card" });
// The next round:
Lia.hideNativeAd();

समाप्त होता है { shown: true, placement, height? } (height कार्ड के लिए), या { shown: false, reason } साथ में reason में से एक no_ad, too_soon (नैटिव विज्ञापन प्रत्येक व्यक्ति के लिए कम से कम एक मिनट के बाद होते हैं) और off.

त्रुटियां: bad_placement, और busy एक शीट के दौरान अन्य Lia के'शीट खुला हुआ है।

#Lia.hideNativeAd()

नैटिव कार्ड हटा देता है। इसके साथ हल होता है { hidden: true }.

#Lia.nativeAd

नैटिव विज्ञापन अब: { visible, placement, height }.

#Lia.onNativeAd(listener)

प्रत्येक मूल विज्ञापन सुनता है'के चरण, { state, placement, height? }, साथ में state में से एक "loading", "showing" और "closed" (जब व्यक्ति कार्ड बंद कर देता है)। एक फ़ंक्शन वापस करता है जो सुनना बंद कर देता है। इसके बराबर है Lia.on("nativeAd", listener).

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