Paketan
@lia-labs/sdk
Salin halaman
The Lia SDK untuk aplikasi dengan langkah build. Setiap fitur sebagai ekspor bertipe, tree-shakeable, dengan pemeriksaan dan kode kesalahan yang sama seperti tag skrip, dan state yang bisa Anda pantau.
npm install @lia-labs/sdk#Mulai
import { init, isLia, mockLia, ready } from '@lia-labs/sdk';
if (!isLia()) mockLia(); // building in a desktop browser
const me = await init();
render(me);
ready();init(options?) memanggil Lia sekali dan menjawab dengan hasil yang sama seperti Lia.init(); memanggilnya lagi akan menghasilkan hasil pertama. Ini juga:
- mempertahankan
--lia-*CSS variabel saat ini di halaman Anda (matikan dengan{ cssVars: false }, atau panggilbindCssVars()diri Anda), - atur halaman Anda's
langdandirdari orang'bahasa (matikan dengan{ documentLanguage: false }), - mempertahankan SDK's status saat ini dari Lia'acara.
#Dari tag skrip ke impor
Semua yang ada di tag skrip's Lia objek adalah ekspor bernama di sini, dengan argumen yang sama, jawaban dan kode kesalahan. Impor hanya apa yang Anda butuhkan; yang lainnya tidak dimasukkan ke dalam bundle Anda.
| Tag skrip | @lia-labs/sdk |
|---|---|
Lia.init(), Lia.ready(), Lia.session(), Lia.close() | init(), ready(), session(), close() |
Lia.pay(id, opts), Lia.charges(), Lia.onCharge(fn) | pay(id, opts), charges(), onCharge(fn) |
Lia.showAd(opts) dan pintasannya, Lia.onAd(fn) | showAd(opts), showRewardedAd(), showRewardedInterstitialAd(), showInterstitialAd(), onAd(fn) |
Lia.showBanner(opts), Lia.hideBanner(), Lia.banner, Lia.onBanner(fn), Lia.showNativeAd(opts), Lia.hideNativeAd(), Lia.nativeAd, Lia.onNativeAd(fn) | showBanner(opts), hideBanner(), banner, onBanner(fn), showNativeAd(opts), hideNativeAd(), nativeAd, onNativeAd(fn); juga holdBanner(position), yang menunjukkan satu hingga fungsi yang dikembalikan dipanggil |
Lia.requestNotifications() | requestNotifications() |
Lia.inviteFriend(opts), Lia.inviteLink(p), Lia.share(text) | inviteFriend(opts), inviteLink(p), share(text) |
Lia.confirm, Lia.showPopup, Lia.showAlert, Lia.showConfirm, Lia.toast | Nama yang sama |
Lia.expand(), Lia.requestFullscreen(), Lia.exitFullscreen() | Nama yang sama |
Lia.enableExpand() … Lia.disableClosingConfirmation() | Nama yang sama |
Lia.setBackgroundColor(c), Lia.setHeaderColor(c) | Nama yang sama |
Lia.mainButton, Lia.secondaryButton, Lia.backButton, Lia.settingsButton | mainButton, secondaryButton, backButton, settingsButton |
Lia.haptic, Lia.scanQr, Lia.copyText, Lia.readClipboard, Lia.openLink, Lia.openLiaLink | Nama yang sama |
Lia.submitScore, Lia.leaderboard | Nama yang sama |
Lia.cloudStorage, Lia.deviceStorage, Lia.secureStorage, Lia.biometric | Nama yang sama |
Lia.accelerometer, Lia.gyroscope, Lia.deviceOrientation | Nama yang sama, dengan reading dan isStarted untuk menonton |
Lia.on(event, fn), Lia.off, Lia.onPause, Lia.onResume | on(event, fn), off, once, onAny, onPause, onResume |
Lia.language, Lia.theme, Lia.viewport dan properti lainnya | language.get(), themeParams.get(), viewport.get() dan sisanya |
Setiap metode'argumen, jawaban, dan kesalahan mereka ada di Referensi SDK.
#Status penontonan
import { colorScheme, language, viewport } from '@lia-labs/sdk';
language.get(); // "en"
const stop = colorScheme.subscribe((scheme, previous) => repaint(scheme));
viewport.subscribe(({ height }) => resizeCanvas(height));Seorang pendengar hanya mendengar perubahan (tidak pernah pada subscribe) dan subscribe mengembalikan fungsi stop-nya sendiri. Anda dapat membuat yang sendiri dengan signal(initial) dan computed(sources, fn).
#Tombol
Tombol bekerja seperti pada tag skrip, dan juga memberi tahu Anda statusnya:
import { mainButton } from '@lia-labs/sdk';
mainButton.setParams({ text: 'Buy for 5 LIA', isVisible: true });
const stop = mainButton.onClick(buy);
mainButton.state.subscribe((s) => console.log(s.isProgressVisible));setParams membutuhkan camelCase nama: text, color, textColor, isVisible, isActive, isProgressVisible, hasShineEffect, position. onClick mengembalikan fungsi yang menghentikan pendengaran. backButton.isVisible dan settingsButton.isVisible juga dapat diawasi.
Untuk menampilkan tombol hanya saat bagian dari halaman Anda muncul di layar, controlBottomButton(button, options) dan controlHeaderButton(button, onClick) memberi Anda update(…) dan dispose() (dispose menyembunyikannya). Paket framework menggunakan ini.
#Kesalahan
Setiap kegagalan adalah LiaError dengan sebuah code, kode yang sama dengan tag skrip. isLiaError(error, 'cancelled') memeriksa satu.
import { isLiaError, pay } from '@lia-labs/sdk';
try {
await pay('extra-lives', { idempotencyKey: orderId });
} catch (error) {
if (isLiaError(error, 'cancelled')) return;
throw error;
}Argumen diperiksa sebelum apa pun mencapai Lia, dan pemeriksaan tersebut menolak janji (atau melempar, untuk beberapa panggilan yang tidak)'tidak mengembalikan satu).
#Tanpa bundler
Paket juga memiliki skrip build yang menempatkan semuanya di window.liaSdk:
<script src="https://unpkg.com/@lia-labs/sdk/dist/index.global.js"></script>
<script>
liaSdk.init().then(function (me) { liaSdk.ready(); });
</script>Gunakan ini atau tag skrip asli di halaman, bukan keduanya.
#TypeScript
Semua hal diberi tipe, termasuk setiap metode'params dan jawaban, serta setiap peristiwa'data (Methods, Events, InitResult, ThemeParams, Charge, AdResult dan sisanya diimpor).
Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris