Referência SDK

Lia.pay, Lia.charges e Lia.onCharge para a folha de pagamento de Lia, Lia.showAd e seus atalhos para anúncios em tela cheia, e Lia.showBanner e Lia.showNativeAd para anúncios em banners e nativos.

#Pagamentos

Ver Pagamentos e a folha de pagamento para como eles funcionam, e Vender um item para todo o fluxo.

#Lia.pay(productId, options)

Abre Lia'sua folha de pagamento para um dos seus produtos. Resolve assim que ela'suas taxas pagas; rejeita se não for'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 });

Resolve com { chargeId, productId }. Então envie o chargeId para o seu servidor para entregá-lo.

Se a página for recarregada enquanto a folha estiver aberta, a carga chega como uma "charge" evento em vez disso (veja Lia.onCharge).

#Chaves de idempotência

A partir de SDK 1.5, as chamadas que mudam algo (Lia.pay, Lia.inviteFriend, Lia.submitScore e armazenamento em nuvem'as escritas) tomam um idempotencyKey. A mesma chave novamente, dentro de 24 horas, não'não faça duas vezes: ele responde como a primeira chamada fez.

• Lia já mantém cada chamada uma vez quando ele o tenta novamente por conta própria (uma conexão perdida). A sua própria chave adiciona a mesma segurança em toda a sua página'tentativas e recarregamentos: mantenha-o (em Lia.deviceStorage, diga) até a chamada ser atendida.
• Faça uma chave por ação (crypto.randomUUID() está ok) e reutilize-o apenas para repetir essa ação.
• A mesma chave com argumentos diferentes é recusado. Use uma nova chave para uma nova ação.
• Para uma transação, a planilha de pagamento ainda abre para a pessoa confirmar; confirmar com uma chave que já pagou responde com a primeira cobrança e não cobra mais nada.
• Um app Lia mais antigo que SDK 1.5's versão ignora a chave, então a chamada ainda funciona, apenas sem sua chave.

#Lia.charges()

Este jogador'suas taxas pagas que seu servidor não'não foi entregue ainda, em ordem do mais antigo para o mais recente, até 50. Chame quando seu app abrir e entregue quaisquer que encontrar.

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

Resolve com um array de { chargeId, productId }.

#Lia.onCharge(listener)

Ouve uma carga que foi confirmada enquanto não Lia.pay() estava esperando por ele, como após uma recarregamento. O ouvinte recebe { chargeId, productId }. Retorna uma função que para de ouvir. O mesmo que Lia.on("charge", listener).

#Anúncios

Ver Anúncios para os formatos, ritmo e verificação no seu servidor.

#Lia.showAd(options)

Reproduz um anúncio de tela cheia sobre seu app. Resolve-se assim que ele'fechado.

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

Resolve com:

Erros: bad_format, busy. Não ter um anúncio para mostrar não't um erro: resolve com reason: "no_ad".

#Lia.showRewardedAd(options)

O mesmo que Lia.showAd({ format: "rewarded", onState }). Um vídeo que a pessoa escolheu assistir.

#Lia.showRewardedInterstitialAd(options)

O mesmo que Lia.showAd({ format: "rewardedInterstitial", onState }). Lia primeiro pergunta à pessoa, com Assistir e Pular; Pular resolve com reason: "skipped".

#Lia.showInterstitialAd(options)

O mesmo que Lia.showAd({ format: "interstitial", onState }). A que usar entre rodadas. Ritmado por Lia (por padrão no máximo uma a cada 90 segundos e a cada 2nd solicitação): quando ele não'quando for sua vez, resolve imediatamente com shown: false, reason: "too_soon".

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

#Lia.onAd(listener)

Ouve todos os anúncios'estágios, { state, format }, com state um dos "loading", "showing" e "closed". Retorna uma função que para de ouvir. O mesmo que Lia.on("ad", listener).

#Lia.showBanner(options)

Fixa um banner adaptativo na borda superior ou inferior, desenhado por Lia fora da sua página. Sua página fica mais curta para caber, então ele nunca cobre nada (SDK 1.7). Resolve assim que ele'exibido, ou uma vez que Lia desiste (cerca de 10 segundos).

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

Resolve com { shown: true, position, height }, ou { shown: false, reason } com reason um dos no_ad (nenhum carregado) e off (a equipe Lia desativou os banners). Perguntar novamente pela mesma posição responde com o banner já aberto; perguntar pela outra posição move-o. AdMob o atualiza enquanto ele'está disponível.

Erros: bad_position.

#Lia.hideBanner()

Tira o banner; sua página recupera seu espaço. Resolve com { hidden: true }.

#Lia.banner

O banner agora: { visible, position, height } (position é nulo e height 0 quando houver's nenhum). --lia-banner-height segura a mesma altura que uma variável CSS.

#Lia.onBanner(listener)

Ouve a mudança do banner: { state, position, height, reason? }, com state um dos "loading", "shown" (novamente após uma atualização que mudou sua altura), "failed" e "hidden". Um banner inferior é "hidden" enquanto um cartão nativo assume seu lugar, então "loading" e "shown" novamente. Retorna uma função que para de escutar. O mesmo que Lia.on("banner", listener).

#Lia.showNativeAd(options)

Um anúncio nativo no Lia'seu próprio aparência, para uma pausa no seu app (SDK 1.7).

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

Resolve com { shown: true, placement, height? } (height para o cartão), ou { shown: false, reason } com reason um dos no_ad, too_soon (anúncios nativos estão pelo menos um minuto de distância para cada pessoa) e off.

Erros: bad_placement, e busy para uma folha enquanto outro de Lia'folhas estão abertas.

#Lia.hideNativeAd()

Tira o cartão nativo. Resolve com { hidden: true }.

#Lia.nativeAd

O anúncio nativo agora: { visible, placement, height }.

#Lia.onNativeAd(listener)

Ouve cada anúncio nativo'estágios, { state, placement, height? }, com state um dos "loading", "showing" e "closed" (também quando a pessoa fecha o cartão). Retorna uma função que para de ouvir. O mesmo que Lia.on("nativeAd", listener).

Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês