Paketan
Paketan
Salin halaman
The Lia SDK sebagai paket npm. Jembatan bertipe, SDK yang dapat di-shake, dan binding untuk React, Preact, Vue, Svelte, Solid, Angular, dan web components.
The tag skrip adalah cara tercepat masuk. Jika aplikasi Anda memiliki langkah build, paket npm memberi Anda versi yang sama SDK dengan TypeScript tipe, impor yang bisa Anda tree-shake, state yang sesuai dengan framework Anda, dan sebuah Lia palsu untuk membangun di luar aplikasi.
#Paket mana
| Paket | Gunakan untuk |
|---|---|
@lia-labs/sdk | Apa pun aplikasi dengan bundler, dengan atau tanpa framework. |
@lia-labs/sdk-react | React: hooks seperti useInit, useMainButton, useBackButton. |
@lia-labs/sdk-preact | Preact: hooks yang sama. |
@lia-labs/sdk-vue | Vue 3: composable mengembalikan refs. |
@lia-labs/sdk-svelte | Svelte 4 dan 5: stores. |
@lia-labs/sdk-solid | Solid: pengakses dan create* primitif. |
@lia-labs/sdk-angular | Angular 17 dan seterusnya: inject* fungsi dan sinyal. |
@lia-labs/elements | Setiap halaman, tanpa framework: <lia-main-button> dan teman-teman. |
@lia-labs/bridge | Pesan tingkat rendah, untuk membangun lapisan Anda sendiri. |
Setiap paket framework mengimpor seluruh SDK, jadi satu impor sudah cukup:
npm install @lia-labs/sdk @lia-labs/sdk-reactimport { pay, useInit, useMainButton } from '@lia-labs/sdk-react';#Bagaimana mereka saling terhubung
- @lia-labs/bridgePesan frame Lia yang ditulis:
request('pay', { productId }),on('theme', …). DanmockLia(), sebuah Lia palsu untuk membangun di browser desktop. - @lia-labs/sdkSetiap fitur sebagai ekspor bernama (
init,pay,mainButton,cloudStorage…), dengan pemeriksaan yang sama dan kode kesalahan seperti tag skrip. Statusnya (tema, bahasa, viewport…) adalah kumpulan nilai kecil yang dapat diamati. - Paket kerangka kerjaTipis: mereka mengubah nilai-nilai tersebut menjadi hook, refs, stores atau signals, dan menghubungkan tombol Lia dengan komponen Anda, ditampilkan saat dipasang dan disembunyikan setelahnya.
#Status yang bisa Anda pantau
The SDK'keadaan s adalah himpunan dari Readable nilai: get() membaca satu sekarang, dan subscribe(listener) mendengar setiap perubahan (dengan nilai baru dan lama) dan mengembalikan fungsi yang menghentikan pendengaran. Mereka diperbarui dari Lia'acara setelah init().
| Nilai | Jenis |
|---|---|
player | { id, name } atau null sebelum init() |
mode | "test", "live" atau null |
language, rtl | Orang tersebut'bahasa dalam Lia, dan apakah itu terbaca dari kiri ke kanan |
colorScheme, themeParams | "light" atau "dark", dan Lia'warna mereka |
viewport | { height, expanded } |
safeArea, contentSafeArea | { top, bottom, left, right } dalam px |
display, isFullscreen | Bagaimana aplikasi dibuka, dan apakah itu'sisi ke sisi |
startParam | Apa yang dibuka dengan, tetap diperbarui selama terbuka |
soundOn, notificationsAllowed, notificationsAvailable | Orang tersebut'pilihan mereka |
initialized | Apakah init() telah menjawab |
Setiap paket framework memiliki hook yang sesuai, composable, store atau signal untuk masing-masing.
#Tag skrip masih berfungsi
https://api.lialabs.org/sdk/lia-apps-v1.js (global Lia) tidak berubah. Gunakan ini atau paket di halaman, bukan keduanya: keduanya mendengarkan Lia'jawaban mereka di saluran yang sama, dan yang kedua yang dimuat dapat't.
#Versi
Paket-paket berbicara tentang protokol SDK 1.8.0. A Lia aplikasi yang lebih tua dari fitur jawaban unknown_method; lihat catatan perubahan.
Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris