Referensi SDK

Startup dan siklus hidup

Salin halaman

Lia.init, Lia.siap, Lia.sesi dan Lia.tutup, dan setiap peristiwa Lia mengirimkan halaman Anda.

#Lia.init()

Panggil terlebih dahulu. Ini menjawab siapa pemainnya dan segala sesuatu tentang bagaimana aplikasi Anda ditampilkan, dan mengisi SDK's properti dan variabel CSS.

const me = await Lia.init();

Menyelesaikan dengan:

Bidang	Jenis	Apa itu
`player`	objek	`{ id, name }`: pemain'id di aplikasimu, dan Lia nama pengguna mereka. Lihat Pemain.
`session`	string	Sebuah token sesi untuk server Anda, `lias_…`.
`exp`	nomor	Ketika sesi berakhir, dalam milidetik sejak 1970 (15 menit setelah dibuka).
`mode`	string	`"test"` atau `"live"`.
`language`	string	Orang tersebut'bahasa dalam Lia, seperti `"en"`.
`rtl`	boolean	Apakah bahasa tersebut dibaca dari kanan ke kiri.
`platform`	string	`"ios"` atau `"android"`.
`theme`	string	`"light"` atau `"dark"`.
`themeParams`	objek	Lia'warna mereka (`bg_color`, `text_color`…).
`display`	string	`"sheet"`, `"full"` atau `"fullscreen"`.
`isFullscreen`	boolean	Sisi ke sisi atau tidak.
`viewport`	objek	`{ height, expanded }`
`safeArea`	objek	`{ top, bottom, left, right }` dalam px
`contentSafeArea`	objek	`{ top, bottom, left, right }` dalam px
`startParam`	string atau null	Apa yang membuka aplikasi Anda.
`link`	string	Aplikasi Anda'tautan undangan, tanpa startParam.
`sound`	boolean	Apakah orang tersebut ingin aplikasi Anda'suara.
`notifications`	objek	`{ allowed, available }`: apakah mereka mengizinkan notifikasi Anda, dan apakah aplikasi Anda boleh meminta.

Kesalahan: not_in_lia, not_ready (Lia masih membuka aplikasi; coba lagi sebentar lagi), timeout.

#Lia.ready()

Menyampaikan Lia bahwa halaman Anda digambar, jadi menghilangkan loader-nya. Panggil sekali halaman pertama Anda muncul. Mengembalikan apa-apa.

Lia.init().then(function (me) {
  renderHome(me);
  Lia.ready();
});

#Lia.session()

Token sesi segar untuk server Anda. Sesi berlangsung selama 15 menit, jadi dapatkan yang baru sebelum panggilan yang harus server Anda percayai.

const { session, exp } = await Lia.session();

Menyelesaikan dengan { session, exp }. Kesalahan: not_open (orang itu tidak'tidak membuka aplikasi Anda di Lia belum; panggil init() pertama), timeout.

#Lia.close()

Menutup aplikasi Anda. Menyelesaikan dengan null. Jika Anda mengaktifkan konfirmasi penutupan, ini ditutup tanpa bertanya.

#Lia.on(event, listener)

Mendengarkan salah satu dari Lia'acara. Mengembalikan fungsi yang menghentikan pendengaran.

const stop = Lia.on("theme", function (data) { redraw(data.colorScheme); });
// later
stop();

Melempar bad_listener jika listener bukan't sebuah fungsi. Sebuah listener yang melemparkan tidak'tidak menghentikan yang lain.

#Lia.off(event, listener)

Menghentikan pendengar yang ditambahkan dengan Lia.on.

#Lia.onPause(listener)

Sama seperti Lia.on("pause", listener). Mengembalikan fungsi yang menghentikan pendengaran.

#Lia.onResume(listener)

Sama seperti Lia.on("resume", listener).

#Peristiwa

Peristiwa	Data	Kapan
`"pause"`	tidak ada	Lia pergi ke latar belakang, atau salah satu dari Lia'layar (lembar gaji, iklan, dialog) menutupi aplikasi Anda. Jeda timer dan suara.
`"resume"`	tidak ada	Kembali lagi.
`"theme"`	`{ theme, colorScheme }`	Orang tersebut beralih Lia antara terang dan gelap. `theme` adalah warna baru. Variabel CSS sudah diperbarui.
`"viewport"`	`{ height, expanded, isStateStable }`	Halaman Anda'tinggi header berubah (selembar lembaran ditarik, tombol bawah ditampilkan).
`"fullscreenChanged"`	`{ isFullscreen, contentSafeArea }`	Aplikasi Anda pergi ke atau dari layar penuh.
`"languageChanged"`	`{ language, rtl }`	Orang tersebut mengubah Lia'bahasa.
`"startParam"`	`{ startParam }`	Notifikasi atau undangan untuk aplikasi Anda dibuka saat aplikasi sudah terbuka.
`"notificationsChanged"`	`{ allowed }`	Orang yang mengizinkan atau menghentikan aplikasi Anda'notifikasi.
`"soundChanged"`	`{ on }`	Orang tersebut menonaktifkan atau mengaktifkan aplikasi Anda dari Lia'menu.
`"charge"`	`{ chargeId, productId }`	Pembayaran yang dikonfirmasi saat tidak ada `Lia.pay()` sedang menunggu (setelah reload). Juga `Lia.onCharge`.
`"ad"`	`{ state, format }`	Sebuah iklan'tahap: `"loading"`, `"showing"` atau `"closed"`. Juga `Lia.onAd`.
`"banner"`	`{ state, position, height, reason? }`	Bendera's `"loading"`, `"shown"`, `"failed"` atau `"hidden"`. Juga `Lia.onBanner`.
`"nativeAd"`	`{ state, placement, height? }`	Iklan asli's `"loading"`, `"showing"` atau `"closed"`. Juga `Lia.onNativeAd`.
`"safeAreaChanged"`	`{ safeArea, contentSafeArea }`	Banner terkunci atau kartu asli mengambil atau mengembalikan tepi: Lia padding di sekitarnya, jadi area aman Anda di sana adalah 0. CSS variabel sudah diperbarui.
`"mainButtonClicked"`	tidak ada	Tombol utama diklik. Juga `Lia.mainButton.onClick`.
`"secondaryButtonClicked"`	tidak ada	Tombol sekunder diklik.
`"backButtonClicked"`	tidak ada	Header'tombol kembali telah ditekan.
`"settingsButtonClicked"`	tidak ada	Pengaturan dipilih dalam menu ⋯.
`"accelerometerChanged"`	`{ x, y, z }`	Sebuah pembacaan, sementara akselerometer berjalan.
`"gyroscopeChanged"`	`{ x, y, z }`	Sebuah pembacaan, sementara giroskop berjalan.
`"deviceOrientationChanged"`	`{ alpha, beta, gamma }`	Sebuah pembacaan, sementara orientasi berjalan.
`"accelerometerStarted"`, `"accelerometerStopped"`	tidak ada	Sensor mulai atau berhenti. Juga untuk `gyroscope` dan `deviceOrientation`.

Demo SDK memperbarui properti sendiri (Lia.colorScheme, Lia.viewport, Lia.language, Lia.soundOn dan sisanya) sebelum pendengar Anda berjalan.

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