Konsep
Bagaimana aplikasi berjalan di Lia
Salin halaman
Halaman Anda berjalan dalam frame terkunci di dalam aplikasi Lia dan mencapai Lia hanya melalui SDK. Tiga tampilan, header dan menu Lia, serta aturan yang diterapkan halaman Anda.
#Bingkai
Ketika seseorang membuka aplikasi Anda, Lia meminta server-nya apakah mereka boleh (lihat Uji dan live), menandai mereka masuk sebagai pemain aplikasi Anda, dan memuat halaman Anda dalam frame di dalam aplikasi Lia. Halaman Anda adalah halaman web biasa: kerangka kerja apa pun, host apa pun, disajikan melalui https.
Bingkai dikunci sehingga orang dapat mempercayai setiap aplikasi di Lia:
- Hanya halaman Anda sendiri yang dimuat. Bingkai tetap pada aplikasi Anda'asal (schemenya, host dan portnya). Tautan atau redirect ke situs lain diblokir. Buka situs lain dengan
Lia.openLink. - Halaman Anda masih dapat mengambil. Skrip, gambar, font dan
fetch()panggilan ke alamat lain bekerja seperti di web (dengan CORS, seperti biasa). - Tidak ada popups atau jendela baru, tidak ada kamera, mikrofon, atau lokasi, dan tidak ada pembayaran Anda sendiri. Uang, iklan, dan apa pun di ponsel terjadi di Lia'layar miliknya di atas aplikasi Anda.
- Lia hanya mendengar halaman Anda di frame atas. Panggilan SDK dari iframe di halaman Anda, atau dari halaman di asal lain, diabaikan.
- Pesan-pesan kecil dan berirama. Panggilan yang melebihi 16,000 karakter diabaikan (dan timeout). Lebih dari 20 panggilan dalam satu detik ditolak dengan
slow_down.
Lia'frame melaporkan LiaApps/1 di akhir agen pengguna-nya, jika Anda ingin mengenali itu di server Anda.
#Jembatan
Demo SDK berbicara dengan Lia melalui frame'jembatannya. Setiap panggilan halaman Anda membuat pesan dengan id; Lia menjawabnya sekali, dan SDK mengubahnya menjadi sebuah promise. Lia juga mengirimkan peristiwa (tema berubah, aplikasi berhenti) yang Anda dengarkan dengan Lia.on.
Panggilan yang menunggu orang (lembar pembayaran, iklan, scanner, Face ID, dialog) tidak memiliki batas waktu. Panggilan lainnya gagal dengan timeout jika Lia tidak't menjawab dalam 20 detik. Di luar aplikasi Lia tidak ada jembatan, dan setiap panggilan gagal dengan not_in_lia.
#Tiga tampilan
Setiap aplikasi dibuka dalam salah satu dari tiga tampilan, yang ditetapkan oleh Lia tim untuk aplikasi Anda. Halaman Anda dapat beralih di antara mereka dengan SDK.
| Lihat | Apa itu |
|---|---|
sheet | Di atas Lia seperti mini app Telegram, sekitar empat per lima tinggi layar. Orang tersebut dapat menariknya ke tinggi penuh, atau halaman Anda memanggil Lia.expand(). Menggeser ke bawah menutupnya. Banyak aplikasi membuka dengan cara ini. |
full | Seluruh layar, di bawah Lia'header. |
fullscreen | Sisi ke sisi, dengan hanya Lia'tombol Close dan ⋯ yang mengambang di atas halaman Anda. Pertahankan konten Anda di bawah Lia.contentSafeArea.top. |
Lia.display katakan bagaimana aplikasi Anda dibuka, dan Lia.isFullscreen apakah itu'sisi ke sisi sekarang. Lia.requestFullscreen() dan Lia.exitFullscreen() beralih ke layar penuh dan kembali.
#Lia'header dan menu
Di sheet dan full, Lia menggambar header di atas halaman Anda: aplikasi Anda'ikonya dan namanya (dan Uji dengan nama pengembang Anda saat dalam pengujian), menu ⋯ dan Tutup. Anda dapat warnai dan tampilkan sebuah tombol kembali di dalamnya.
Menu ⋯ selalu memiliki:
- Pengaturan, ketika halaman Anda menunjukkan
Lia.settingsButton. - Notifikasi aktif atau nonaktif, ketika aplikasi Anda mungkin mengirimkannya (lihat Notifikasi).
- Matikan atau aktifkan suara, yang membuat halaman Anda mendengar
soundChanged. - Muat ulang dan Tutup.
#Sementara halaman Anda dimuat
Lia menampilkan loader-nya sendiri di atas aplikasi Anda sejak aplikasi dibuka hingga halaman Anda memanggil Lia.ready() (atau selesai dimuat). Panggil secepat mungkin setelah layar pertama Anda ditampilkan. Jika halaman Anda gagal dimuat, Lia menampilkan pesan dengan Coba lagi.
#Jeda dan lanjutkan
Halaman Anda mendengar pause ketika Lia masuk ke latar belakang atau menutupi aplikasi kamu dengan layar sendiri (sheet pembayaran, iklan, dialog, scanner), dan resume ketika itu'tombol kembali. Jeda timer, musik, dan loop permainan pada pause. Lihat Siklus hidup dan peristiwa.
#Satu lembar pada satu waktu
Lia menampilkan salah satu layar sendiri di atas aplikasi Anda pada satu waktu. Saat lembar pembayaran, iklan, dialog, pemilih teman, permintaan notifikasi, pemindai atau Face ID terbuka, panggilan lain gagal dengan busy.
#Siapa yang boleh membuka aplikasi Anda
- Orang membutuhkan Lia nama pengguna untuk membuka aplikasi apa pun.
- Sementara aplikasi Anda dalam uji, hanya Anda dan penguji Anda yang dapat membukanya. Ketika itu's langsung, semua orang bisa. Ketika itu's dihentikan, tidak ada yang bisa. Lihat Uji dan live.
- Jika tim Lia menetapkan streak minimum untuk aplikasi Anda, orang-orang membutuhkan streak check-in yang panjang agar bisa membukanya. Lia menunjukkan cara mereka mencapainya.
Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris