مرجع SDK

Lia.دفع, Lia.المدفوعات و Lia.onCharge لورقة دفع Lia, Lia.showAd وطرقها المختصرة للإعلانات بالشاشة الكاملة، و Lia.showBanner و Lia.showNativeAd للإعلانات الشريطية والإعلانات الطبيعية.

#المدفوعات

انظر المدفوعات وورقة الدفع كيف يعملون، و بيع عنصر لكل التدفق.

#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).

#مفاتيح التكرار

من SDK 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).

تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية