Referensi SDK

Lia.pay, Lia.charges and Lia.onCharge untuk Lia's pay sheet, Lia.showAd dan shortcutnya untuk iklan layar penuh, serta Lia.showBanner dan Lia.showNativeAd untuk iklan banner dan iklan native.

#Pembayaran

Lihat Pembayaran dan lembar pembayaran untuk bagaimana cara kerjanya, dan Jual item untuk seluruh alur.

#Lia.pay(productId, options)

Membuka Lia'lembar pembayaran untuk salah satu produk Anda. Menyelesaikan setelah itu'dibayar; menolak jika tidak'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 });

Menyelesaikan dengan { chargeId, productId }. Lalu kirimkan chargeId ke server kamu untuk mengirimkannya.

Jika halaman dimuat ulang saat lembar terbuka, pembayaran tiba sebagai "charge" acara lain (lihat Lia.onCharge).

#Kunci idempotensi

Dari SDK 1.5, panggilan yang mengubah sesuatu (Lia.pay, Lia.inviteFriend, Lia.submitScore dan penyimpanan awan'menulis) ambil opsional idempotencyKey. Kunci yang sama lagi, dalam 24 jam, tidak'tidak lakukan dua kali: itu menjawab seperti panggilan pertama.

• Lia sudah menyimpan setiap panggilan sekali ketika mencoba kembali (koneksi yang terputus). Kunci Anda menambahkan keamanan yang sama di seluruh halaman Anda'ulang dan muat ulang: pertahankan (dalam Lia.deviceStorage, katakanlah) hingga panggilan dijawab.
• Buat satu kunci per tindakan (crypto.randomUUID() tidak masalah) dan gunakan kembali hanya untuk mencoba ulang tindakan tersebut.
• Kunci yang sama dengan argumen yang berbeda ditolak. Gunakan kunci baru untuk tindakan baru.
• Untuk pembayaran, lembar pembayaran tetap terbuka agar orang tersebut dapat mengonfirmasi; mengonfirmasi dengan kunci yang sudah dibayar akan menjawab dengan pembayaran pertama dan tidak mengenakan biaya lebih lanjut.
• Aplikasi Lia yang lebih tua dari SDK 1.5'rilis ini mengabaikan kunci, jadi panggilan tetap berjalan, hanya tanpa kunci Anda.

#Lia.charges()

Pemain ini'tagihan yang dibayar oleh server Anda tidak'tidak mengirimkannya belum, yang terlama dulu, hingga 50. Panggil saat aplikasi Anda dibuka, dan kirimkan yang Anda temukan.

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

Menyelesaikan dengan array dari { chargeId, productId }.

#Lia.onCharge(listener)

Mendengar dugaan yang telah dikonfirmasi saat tidak Lia.pay() sedang menunggu, seperti setelah reload. Pemroses mendapatkan { chargeId, productId }. Mengembalikan fungsi yang menghentikan pendengaran. Sama seperti Lia.on("charge", listener).

#Iklan

Lihat Iklan untuk format, ritme, dan memeriksa server Anda.

#Lia.showAd(options)

Memainkan iklan layar penuh di atas aplikasi Anda. Menyelesaikan setelah itu'ditutup.

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

Menyelesaikan dengan:

Kesalahan: bad_format, busy. Tidak memiliki iklan untuk ditampilkan't sebuah kesalahan: menyelesaikan dengan reason: "no_ad".

#Lia.showRewardedAd(options)

Sama seperti Lia.showAd({ format: "rewarded", onState }). Sebuah video yang orang tersebut memilih untuk ditonton.

#Lia.showRewardedInterstitialAd(options)

Sama seperti Lia.showAd({ format: "rewardedInterstitial", onState }). Lia pertama-tama bertanya kepada orang tersebut, dengan Tonton dan Lewati; Lewati menyelesaikan dengan reason: "skipped".

#Lia.showInterstitialAd(options)

Sama seperti Lia.showAd({ format: "interstitial", onState }). Yang digunakan antara putaran. Dikendalikan oleh Lia (secara default paling banyak satu setiap 90 detik dan setiap 2nd permintaan): ketika itu tidak'tidak gilirannya, itu segera diselesaikan dengan shown: false, reason: "too_soon".

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

#Lia.onAd(listener)

Mendengar setiap iklan'tahap-tahap, { state, format }, dengan state salah satu "loading", "showing" dan "closed". Mengembalikan fungsi yang menghentikan pendengaran. Sama seperti Lia.on("ad", listener).

#Lia.showBanner(options)

Menempelkan banner adaptif di tepi atas atau bawah, digambar oleh Lia di luar halaman Anda. Halaman Anda menjadi lebih pendek agar sesuai, jadi tidak pernah menutupi apa pun (SDK 1.7). Menyelesaikan saat itu'ditampilkan, atau sekali Lia menyerah (sekitar 10 detik).

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

Menyelesaikan dengan { shown: true, position, height }, atau { shown: false, reason } dengan reason salah satu no_ad (tidak ada yang dimuat) dan off (tim Lia mematikan banner). Meminta lagi untuk posisi yang sama menjawab dengan banner yang sudah muncul; meminta posisi lain memindahkannya. AdMob memperbarui itu sementara itu'siap.

Kesalahan: bad_position.

#Lia.hideBanner()

Mengambil banner; halaman Anda kembali mendapatkan ruangnya. Menyelesaikan dengan { hidden: true }.

#Lia.banner

Bendera sekarang: { visible, position, height } (position adalah null dan height 0 ketika ada'tidak ada). --lia-banner-height menyimpan ketinggian yang sama dengan variabel CSS.

#Lia.onBanner(listener)

Mendengar perubahan banner: { state, position, height, reason? }, dengan state salah satu "loading", "shown" (lagi setelah refresh yang mengubah tingginya), "failed" dan "hidden". Sebuah banner bawah adalah "hidden" sambil kartu native mengambil tempatnya, lalu "loading" dan "shown" lagi. Mengembalikan fungsi yang menghentikan pendengaran. Sama seperti Lia.on("banner", listener).

#Lia.showNativeAd(options)

Iklan asli di Lia'tampilan miliknya, untuk jeda dalam aplikasi Anda (SDK 1.7).

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

Menyelesaikan dengan { shown: true, placement, height? } (height untuk kartu), atau { shown: false, reason } dengan reason salah satu no_ad, too_soon (iklan asli setidaknya satu menit terpisah untuk setiap orang) dan off.

Kesalahan: bad_placement, dan busy untuk sebuah lembaran sementara yang lain dari Lia'bagian berbagi terbuka.

#Lia.hideNativeAd()

Mengambil kartu native. Menyelesaikan dengan { hidden: true }.

#Lia.nativeAd

Iklan asli sekarang: { visible, placement, height }.

#Lia.onNativeAd(listener)

Mendengar setiap iklan asli'tahap-tahap, { state, placement, height? }, dengan state salah satu "loading", "showing" dan "closed" (juga ketika orang menutup kartu). Mengembalikan fungsi yang menghentikan pendengaran. Sama seperti Lia.on("nativeAd", listener).

Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris