SDK referencia

Lia.pay, Lia.charges y Lia.onCharge para la hoja de pago de Lia, Lia.showAd y sus atajos para anuncios en pantalla completa, y Lia.showBanner y Lia.showNativeAd para anuncios banner y nativos.

#Pagos

Ver Pagos y la hoja de pago para cómo funcionan, y Vender un artículo para todo el flujo.

#Lia.pay(productId, options)

Abre Lia'su hoja de pago para uno de sus productos. Se resuelve una vez que lo'su pago; rechaza si no lo es'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 });

Se resuelve con { chargeId, productId }. Luego envía el chargeId a tu servidor para entregársela.

Si la página se recarga mientras la hoja está abierta, la carga llega como un "charge" evento en su lugar (ver Lia.onCharge).

#Claves de idempotencia

Desde SDK 1.5, las llamadas que cambian algo (Lia.pay, Lia.inviteFriend, Lia.submitScore y almacenamiento en la nube'sus escrituras) toman un parámetro opcional idempotencyKey. La misma clave nuevamente, dentro de 24 horas, no'hacerlo dos veces: responde como lo hizo la primera llamada.

• Lia ya guarda cada llamada una vez cuando lo reintentó por sí mismo (una conexión caída). Tu propia clave añade la misma seguridad a través de tu página'reintento y recarga: mantén (en Lia.deviceStorage, decir) hasta que la llamada sea respondida.
• Crea una clave por acción (crypto.randomUUID() está bien) y reúselo solo para reintentar esa acción.
• La misma clave con diferentes argumentos se rechaza. Use una nueva clave para una nueva acción.
• Para un pago, la hoja de pago aún se abre para que la persona confirme; confirmar con una clave que ya pagó responde con esa primera carga y no cobra nada más.
• Una aplicación Lia más antigua que SDK 1.5'la versión de lanzamiento ignora la clave, por lo que la llamada sigue funcionando, solo sin tu clave.

#Lia.charges()

Este jugador'sus cargos pagados que su servidor no'aún no lo ha entregado, en orden del más antiguo al más reciente, hasta 50. Llámelo cuando se abra su aplicación y entregue cualquier uno que encuentre.

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

Se resuelve con una matriz de { chargeId, productId }.

#Lia.onCharge(listener)

Escucha una carga que fue confirmada mientras no Lia.pay() estaba esperando por ella, como después de una recarga. El oyente recibe { chargeId, productId }. Devuelve una función que deja de escuchar. Lo mismo que Lia.on("charge", listener).

#Anuncios

Ver Anuncios para los formatos, el ritmo y verificar en tu servidor.

#Lia.showAd(options)

Reproduce un anuncio de pantalla completa sobre tu aplicación. Se resuelve una vez que's cerrado.

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

Se resuelve con:

Errores: bad_format, busy. No tener un anuncio para mostrar no't un error: se resuelve con reason: "no_ad".

#Lia.showRewardedAd(options)

Lo mismo que Lia.showAd({ format: "rewarded", onState }). Un video que la persona eligió ver.

#Lia.showRewardedInterstitialAd(options)

Lo mismo que Lia.showAd({ format: "rewardedInterstitial", onState }). Lia primero pregunta a la persona, con Ver y Saltar; Saltar se resuelve con reason: "skipped".

#Lia.showInterstitialAd(options)

Lo mismo que Lia.showAd({ format: "interstitial", onState }). La que usar entre rondas. Pulsado por Lia (por defecto, como máximo uno cada 90 segundos y cada 2nd preguntas): cuando no'es su turno, se resuelve inmediatamente con shown: false, reason: "too_soon".

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

#Lia.onAd(listener)

Escucha cada anuncio's etapas, { state, format }, con state uno de "loading", "showing" y "closed". Devuelve una función que deja de escuchar. Lo mismo que Lia.on("ad", listener).

#Lia.showBanner(options)

Ancla una banda publicitaria adaptativa en el borde superior o inferior, dibujada por Lia fuera de tu página. Tu página se acorta para ajustarse a ella, por lo que nunca cubre nada (SDK 1.7). Se resuelve una vez que's mostrado, o una vez que Lia se rinde (alrededor de 10 segundos).

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

Se resuelve con { shown: true, position, height }, o { shown: false, reason } con reason uno de no_ad (ninguno cargado) y off (el equipo Lia desactivó las banderas). Preguntar de nuevo por la misma posición responde con la banda ya activa; pedir la otra posición la mueve. AdMob la refresca mientras que está'se levanta.

Errores: bad_position.

#Lia.hideBanner()

Quita el banner; tu página recupera su espacio. Se resuelve con { hidden: true }.

#Lia.banner

El banner ahora: { visible, position, height } (position es nulo y height 0 cuando allí'ninguno). --lia-banner-height mantiene la misma altura que una variable CSS.

#Lia.onBanner(listener)

Escucha el cambio de banner: { state, position, height, reason? }, con state uno de "loading", "shown" (de nuevo después de una actualización que cambió su altura), "failed" y "hidden". Un banner inferior es "hidden" mientras una tarjeta nativa toma su lugar, luego "loading" y "shown" de nuevo. Devuelve una función que deja de escuchar. Lo mismo que Lia.on("banner", listener).

#Lia.showNativeAd(options)

Un anuncio nativo en Lia'su propia apariencia, para una pausa en su aplicación (SDK 1.7).

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

Se resuelve con { shown: true, placement, height? } (height para la carta), o { shown: false, reason } con reason uno de no_ad, too_soon (los anuncios nativos están al menos un minuto separados por persona) y off.

Errores: bad_placement, y busy para una hoja mientras otra de Lia's hoja está abierta.

#Lia.hideNativeAd()

Quita la tarjeta nativa. Se resuelve con { hidden: true }.

#Lia.nativeAd

El anuncio nativo ahora: { visible, placement, height }.

#Lia.onNativeAd(listener)

Escucha cada anuncio nativo's etapas, { state, placement, height? }, con state uno de "loading", "showing" y "closed" (también cuando la persona cierra la tarjeta). Devuelve una función que detiene la escucha. Lo mismo que Lia.on("nativeAd", listener).

Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés