SDK referansı

Lia.pay, Lia.charges ve Lia.onCharge için Lia'ın ödeme sayfası, Lia.showAd ve tam ekran reklamlar için kısayolları, ve Lia.showBanner ve Lia.showNativeAd için banner ve doğal reklamlar.

#Ödemeler

Bak Ödemeler ve ödeme tablosu nasıl çalıştığını ve Bir eşya sat tüm akış için.

#Lia.pay(productId, options)

Lia'u açar'ürünlerinizden biri için kendi ödeme sayfası. Bir kez çözülür'ödenmiş; eğer değilse reddeder'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 });

Çözülür { chargeId, productId }. Sonra gönder chargeId sunu sunucunuza teslim etmek için.

Sayfa açıkken yeniden yüklenirse, ödeme bir şekilde gelir "charge" olayı yerine (bkz. Lia.onCharge).

#Tekrar edilebilirlik anahtarları

SDK 1.5'den, değişiklik yapan çağrılar (Lia.pay, Lia.inviteFriend, Lia.submitScore ve bulut depolama'yazısı) isteğe bağlı bir idempotencyKey. 24 saat içinde aynı anahtar tekrar ederse, yapmaz'ikisini yapın: ilk çağrı gibi cevap verir.

• Lia zaten her aramayı bir kez saklar zaman kendisi yeniden deneyimler (bağlantı kesildi). Kendi anahtarınız, sayfanız boyunca aynı güvenliği ekler'yeniden deneme ve yeniden yükleme: bunu (içinde Lia.deviceStorage, diyin) çağrı cevaplanana kadar.
• Her eylem için bir anahtar yapın (crypto.randomUUID() sorun yok) ve sadece o eylemi tekrar denemek için yeniden kullanın.
• Aynı anahtar, farklı argümanlarla reddedilir. Yeni bir eylem için yeni bir anahtar kullanın.
• Bir ödeme için, kişiye onaylaması için hala ödeme sayfası açılır; zaten ödenen bir anahtarla onaylamak, ilk ücretle yanıt verir ve hiçbir şey daha fazla ücretlendirmez.
• SDK 1.5'den daha eski bir Lia uygulaması'çıkış, anahtarı görmezden gelir, bu yüzden çağrı hâlâ çalışır, sadece anahtarınız olmadan.

#Lia.charges()

Bu oyuncu'sunucunuzun ödediği ücretler'henüz teslim edilmedi, en eski olanlardan başlayarak 50. kadar. Uygulamanız açıldığında çağırın ve bulduğunuz her şeyi teslim edin.

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

Çözülür: bir dizi ile { chargeId, productId }.

#Lia.onCharge(listener)

Eriştiğiniz bir ödeme, hiçbir zaman Lia.pay() bekliyordu, örneğin sayfa yeniden yüklendiğinde. Dinleyici alır { chargeId, productId }. Dinlemeyi durduran bir fonksiyon döndürür. Aynı şey Lia.on("charge", listener).

#Reklamlar

Bak Reklamlar biçimler, tempoyu ve sunucunuzu kontrol etmek için.

#Lia.showAd(options)

Uygulamanızın üzerine tam ekran bir reklam çalar. Bittiğinde çözülür'u kapatıldı.

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

Çözülür:

Hatalar: bad_format, busy. Gösterilecek bir reklam yoksa'bir hata ile sonuçlanır: çözümle reason: "no_ad".

#Lia.showRewardedAd(options)

Aynı Lia.showAd({ format: "rewarded", onState }). Kişi tarafından izlemek için seçtiği bir video.

#Lia.showRewardedInterstitialAd(options)

Aynı Lia.showAd({ format: "rewardedInterstitial", onState }). Lia önce kişiye, İzle ve Atla ile sorar; Atla ile çözülür reason: "skipped".

#Lia.showInterstitialAd(options)

Aynı Lia.showAd({ format: "interstitial", onState }). Tur arası kullanmak için olan. Lia ile (varsayılan olarak en fazla bir 90 saniye ve her 2nd istek): ne zaman'onun sırası geldiğinde, doğrudan shown: false, reason: "too_soon".

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

#Lia.onAd(listener)

Her reklamı duydu's sahneleri, { state, format }, ile state birinden "loading", "showing" ve "closed". Dinlemeyi durduran bir fonksiyon döndürür. Aynı şey Lia.on("ad", listener).

#Lia.showBanner(options)

Uygun bir bantı üst veya alt kenara sabitler, Lia sayfanızın dışında çizilir. Sayfanız onu sığdırmak için daha kısa olur, bu yüzden hiçbir şeyi kapatmaz (SDK 1.7). Çözüldüğünde's gösterilir, veya Lia vazgeçer (yaklaşık 10 saniye).

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

Çözülür { shown: true, position, height }, veya { shown: false, reason } ile reason birinden no_ad (yüklenmemiş) ve off (Lia ekibi bantları kapatmıştır). Aynı pozisyona tekrar sormak, bantın zaten açık olduğunu gösterir; diğer pozisyona sormak bantı hareket ettirir. AdMob bantı yenilerken Lia'aç.

Hatalar: bad_position.

#Lia.hideBanner()

Banner'ı kaldırır; sayfanızın alanı geri döner. Çözümlenir ile { hidden: true }.

#Lia.banner

Banner şu anda: { visible, position, height } (position null ve height 0 olduğunda'hiçbiri). --lia-banner-height bir CSS değişkeniyle aynı yüksekliğe sahiptir.

#Lia.onBanner(listener)

Bildirim değişti: { state, position, height, reason? }, ile state birinden "loading", "shown" (yükseklik değişen bir yeniden yüklemeden sonra tekrar) "failed" ve "hidden". Bir alt banner "hidden" bir yerine yerleştirilir, ardından "loading" ve "shown" tekrar. Dinlemeyi durduran bir fonksiyon döndürür. Aynı gibi Lia.on("banner", listener).

#Lia.showNativeAd(options)

Lia'da bir yerel reklam'kendi görünümü, uygulamanızda bir duraklama için (SDK 1.7).

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

Çözülür { shown: true, placement, height? } (height kart için), veya { shown: false, reason } ile reason birinden no_ad, too_soon (doğal reklamlar, her kişi için en az bir dakika aralıklarla) ve off.

Hatalar: bad_placement, ve busy başka bir Lia sayfası sırasında's sayfası açık.

#Lia.hideNativeAd()

Doğal kartı kaldırır. Çözümlenir ile { hidden: true }.

#Lia.nativeAd

Yerel reklam şu anda: { visible, placement, height }.

#Lia.onNativeAd(listener)

Her bir yerleştirilmiş reklamı duydu's sahneleri, { state, placement, height? }, ile state birinden "loading", "showing" ve "closed" (aynı zamanda kişi kartı kapatırsa). Dinlemeyi durduran bir fonksiyon döndürür. Aynı şeydir Lia.on("nativeAd", listener).

Otomatik çeviri. İngilizce, doğru kaynaktır. İngilizce olarak oku