SDK référence

Lia.pay, Lia.charges et Lia.onCharge pour la paie de Lia, Lia.showAd et ses raccourcis pour les publicités en plein écran, et Lia.showBanner et Lia.showNativeAd pour les bannières et les publicités natives.

#Paiements

Voir Paiements et feuille de paiement pour comment ils fonctionnent, et Vendre un article pour l'ensemble du processus.

#Lia.pay(productId, options)

Ouvre Lia'sa feuille de paiement pour l'un de vos produits. Résout une fois qu'elle'ses frais payés ; rejetés s'ils ne sont pas'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 });

Résout avec { chargeId, productId }. Ensuite envoyez le chargeId à votre serveur pour la lui transmettre.

Si la page se recharge pendant que la feuille est ouverte, la charge arrive comme une "charge" événement au lieu (voir Lia.onCharge).

#Clés d'idempotence

À partir de SDK 1.5, les appels qui modifient quelque chose (Lia.pay, Lia.inviteFriend, Lia.submitScore et stockage en nuage'écrits) prennent un paramètre optionnel idempotencyKey. La même clé à nouveau, dans les 24 heures, ne'ne pas le faire deux fois : il répond comme la première appel a fait.

• Lia conserve déjà chaque appel une fois quand il le réessaie lui-même (une connexion perdue). Votre propre clé ajoute la même sécurité sur toute votre page'réessaie et recharge : gardez-le (dans Lia.deviceStorage, dire) jusqu'à ce que l'appel soit accepté.
• Créez une clé par action (crypto.randomUUID() est correct) et réutilisez-le uniquement pour réessayer cette action.
• La même clé avec des arguments différents est refusé. Utilisez une nouvelle clé pour une nouvelle action.
• Pour un paiement, le formulaire de paiement s'ouvre toujours pour que la personne confirme ; confirmer avec une clé qui a déjà payé répond avec cette première charge et ne charge rien de plus.
• Une application Lia plus ancienne que SDK 1.5'la version ignore la clé, donc l'appel fonctionne toujours, mais sans votre clé.

#Lia.charges()

Ce joueur'ses frais payés que votre serveur n''ne pas avoir été livré encore, du plus ancien au plus récent, jusqu'à 50. Appelez-le lorsque votre application s'ouvre, et livrez-en tous ceux que vous trouvez.

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

Résout avec un tableau de { chargeId, productId }.

#Lia.onCharge(listener)

Entend une charge confirmée pendant qu'aucun Lia.pay() attendait, par exemple après un rechargement. L'écouteur reçoit { chargeId, productId }. Retourne une fonction qui arrête l'écoute. La même que Lia.on("charge", listener).

#Publicités

Voir Publicités pour les formats, le rythme et le contrôle sur votre serveur.

#Lia.showAd(options)

Joue une publicité en plein écran au-dessus de votre application. Se résout une fois qu'elle'fermé.

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

Résout avec :

Erreurs : bad_format, busy. Ne pas avoir de publicité à afficher n'est pas't une erreur : il résout avec reason: "no_ad".

#Lia.showRewardedAd(options)

La même chose que Lia.showAd({ format: "rewarded", onState }). Une vidéo que la personne a choisie à regarder.

#Lia.showRewardedInterstitialAd(options)

La même chose que Lia.showAd({ format: "rewardedInterstitial", onState }). Lia demande d'abord à la personne, avec Regarder et Passer ; Passer se résout avec reason: "skipped".

#Lia.showInterstitialAd(options)

La même chose que Lia.showAd({ format: "interstitial", onState }). La bonne à utiliser entre les tours. Pulsé par Lia (par défaut au plus un toutes les 90 secondes et toutes les 2nd demandes) : lorsqu'il n'est pas'ne pas être son tour, il est résolu immédiatement avec shown: false, reason: "too_soon".

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

#Lia.onAd(listener)

Entend chaque publicité'ses phases, { state, format }, avec state l'un des "loading", "showing" et "closed". Retourne une fonction qui arrête l'écoute. La même que Lia.on("ad", listener).

#Lia.showBanner(options)

Ancre un bandeau adaptatif en haut ou en bas de l'écran, dessiné par Lia en dehors de votre page. Votre page devient plus courte pour s'y adapter, donc il ne recouvre jamais rien (SDK 1.7). Se résout une fois qu'il'affiché, ou une fois que Lia renonce (environ 10 secondes).

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

Résout avec { shown: true, position, height }, ou { shown: false, reason } avec reason l'un des no_ad (aucune chargée) et off (l'équipe Lia a désactivé les bannières). Demander à nouveau la même position répond avec la bannière déjà affichée ; demander à la position opposée la déplace. AdMob la rafraîchit pendant qu'elle'est en ligne.

Erreurs : bad_position.

#Lia.hideBanner()

Retire le bandeau ; votre page récupère son espace. Résout avec { hidden: true }.

#Lia.banner

La bannière maintenant : { visible, position, height } (position est null et height 0 lorsqu'il y'le non). --lia-banner-height garde la même hauteur qu'une variable CSS.

#Lia.onBanner(listener)

Entend le changement de bannière : { state, position, height, reason? }, avec state l'un des "loading", "shown" (à nouveau après une actualisation qui a changé sa hauteur), "failed" et "hidden". Un bandeau inférieur est "hidden" alors qu'une carte native prend sa place, puis "loading" et "shown" à nouveau. Renvoie une fonction qui arrête l'écoute. Identique à Lia.on("banner", listener).

#Lia.showNativeAd(options)

Une publicité native dans Lia'son propre look, pour une pause dans votre application (SDK 1.7).

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

Résout avec { shown: true, placement, height? } (height pour la carte), ou { shown: false, reason } avec reason l'un des no_ad, too_soon (les publicités natives sont au moins une minute d'intervalle par personne) et off.

Erreurs : bad_placement, et busy pour une feuille pendant qu'un autre de Lia'les feuilles sont ouvertes.

#Lia.hideNativeAd()

Retire la carte native. Résout avec { hidden: true }.

#Lia.nativeAd

La publicité native maintenant : { visible, placement, height }.

#Lia.onNativeAd(listener)

Entend chaque publicité native'ses phases, { state, placement, height? }, avec state l'un des "loading", "showing" et "closed" (aussi quand la personne ferme la carte). Retourne une fonction qui arrête l'écoute. Identique à Lia.on("nativeAd", listener).

Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais