SDK referansı
Başlatma ve yaşam döngüsü
Sayfayı kopyala
Lia.başlat, Lia.hazır, Lia.oturum ve Lia.kapat, ve her olay Lia sayfanıza gönderir.
#Lia.init()
Önce çağırın. O, oyuncunun kim olduğunu ve uygulamanızın nasıl gösterildiğini her şeyi cevaplar ve SDK'ı doldurur's özellikler ve CSS değişkenler.
const me = await Lia.init();Çözülür:
| Alan | Tür | O ne demek |
|---|---|---|
player | nesne | { id, name }: oyuncu's uygulamadaki id'si ve Lia kullanıcı adı. Bkz. Oyuncular. |
session | dize | Kendi sunucunuz için bir oturum tokenı, lias_…. |
exp | sayı | Oturum bittiğinde, 1970'dan itibaren milisaniye cinsinden (15 açılışından sonra dakika). |
mode | dize | "test" veya "live". |
language | dize | Kişi's dili Lia'da, örneğin "en". |
rtl | mantıksal değer | İşte sağdan sola okunuyor mu. |
platform | dize | "ios" veya "android". |
theme | dize | "light" veya "dark". |
themeParams | nesne | Lia'u renkler (bg_color, text_color…). |
display | dize | "sheet", "full" veya "fullscreen". |
isFullscreen | mantıksal değer | Kenardan kenara ya da değil. |
viewport | nesne | { height, expanded } |
safeArea | nesne | { top, bottom, left, right } px içinde |
contentSafeArea | nesne | { top, bottom, left, right } px içinde |
startParam | dize veya null | Uygulamanızın açıldığı şey. |
link | dize | Senin uygulaman's davet bağlantısı, startParam olmadan. |
sound | mantıksal değer | İşte kişi uygulamanızı istiyor mu's sesler. |
notifications | nesne | { allowed, available }: onların bildirimlerinizi izni olup olmadığı ve uygulamanızın sorması olup olmadığı. |
Hatalar: not_in_lia, not_ready (Lia uygulamayı açmaya devam ediyor; biraz sonra tekrar deneyin), timeout.
#Lia.ready()
Tells Lia sayfanızın çizildiğini, bu yüzden yükleyicisini kaldırır. Sayfada ilk ekranınız olduğunda bir kez çağırın. Hiçbir şey döndürmez.
Lia.init().then(function (me) {
renderHome(me);
Lia.ready();
});#Lia.session()
Sunucunuza özel bir oturum belirteci. Oturumlar 15 dakika sürer, bu yüzden sunucunuzun güvenmesi gereken çağrılar öncesi yeni bir tane alın.
const { session, exp } = await Lia.session();Çözülür { session, exp }. Hatalar: not_open (kişi sahip değil'henüz Lia içinde uygulamanızı açmadınız; arayın init() ilk olarak, timeout.
#Lia.close()
Uygulamanızı kapatır. Çözümlerle null. Etkinse kapanış onayı, soru sormadan kapanır.
#Lia.on(event, listener)
Bir Lia'dan birini dinler'olaylar. Dinlemeyi durduran bir fonksiyon döndürür.
const stop = Lia.on("theme", function (data) { redraw(data.colorScheme); });
// later
stop();Atar bad_listener eğer listener değildir't bir fonksiyon. Hata veren bir dinleyici'diğerlerini durdurun.
#Lia.off(event, listener)
Eklendiğinde bir dinleyiciyi durdurur Lia.on.
#Lia.onPause(listener)
Aynı Lia.on("pause", listener). Dinlemeyi durduran bir fonksiyon döndürür.
#Lia.onResume(listener)
Aynı Lia.on("resume", listener).
#Olaylar
| Olay | Veri | Zaman |
|---|---|---|
"pause" | hiçbiri | Lia arka plana gitti, veya Lia'den biri'ekranlar (ödeme sayfası, bir reklam, bir diyalog) uygulamanızı kaplar. Zamanlayıcıları ve sesi durdurun. |
"resume" | hiçbiri | Yine geri |
"theme" | { theme, colorScheme } | Kişi Lia'ı ışık ve karanlık arasında değiştirdi. theme yeni renklerdir. CSS değişkenleri zaten güncellenmiştir. |
"viewport" | { height, expanded, isStateStable } | Sayfanız's yüksekliği değişti (bir sayfa çekildi, alt düğmeler gösterildi). |
"fullscreenChanged" | { isFullscreen, contentSafeArea } | Uygulamanız tam ekran ya da tam ekrandan gider. |
"languageChanged" | { language, rtl } | Kişi Lia'ı değiştirdi'dilinde. |
"startParam" | { startParam } | Uygulamanız zaten açıkken bir bildirim veya davet açıldı. |
"notificationsChanged" | { allowed } | Uygulamanızı izin veren veya durduran kişi'bildirimler. |
"soundChanged" | { on } | Kişi Lia'dan uygulamanızı sessize alır veya sessizden çıkarır'menü. |
"charge" | { chargeId, productId } | Bir ödeme, hiçbir zaman Lia.pay() bekliyordu (yeniden yüklemeden sonra). Ayrıca Lia.onCharge. |
"ad" | { state, format } | Bir reklam's sahnesi: "loading", "showing" veya "closed". Ayrıca Lia.onAd. |
"banner" | { state, position, height, reason? } | Banner's "loading", "shown", "failed" veya "hidden". Ayrıca Lia.onBanner. |
"nativeAd" | { state, placement, height? } | Bir yerel reklam's "loading", "showing" veya "closed". Ayrıca Lia.onNativeAd. |
"safeAreaChanged" | { safeArea, contentSafeArea } | Sabitleme bülteni veya yerel kart, kenar alır veya geri verir: Lia buna kenar boşlukları ekler, bu yüzden bu alandaki güvenli alan 0. CSS değişkenleri zaten güncellenmiştir. |
"mainButtonClicked" | hiçbiri | Ana düğme tıklandı. Ayrıca Lia.mainButton.onClick. |
"secondaryButtonClicked" | hiçbiri | İkinci düğme basıldı. |
"backButtonClicked" | hiçbiri | Başlık'u geri düğmesi basıldı. |
"settingsButtonClicked" | hiçbiri | ⋯ menüsünde ayarlar seçildi. |
"accelerometerChanged" | { x, y, z } | Bir okuma, ivmeölçer çalışırken. |
"gyroscopeChanged" | { x, y, z } | Bir okuma, yörünge ölçer çalışırken. |
"deviceOrientationChanged" | { alpha, beta, gamma } | Bir okuma, yönlenme çalışırken. |
"accelerometerStarted", "accelerometerStopped" | hiçbiri | Sensör başlatıldı veya durduruldu. Ayrıca için gyroscope ve deviceOrientation. |
SDK kendi özelliklerini günceller (Lia.colorScheme, Lia.viewport, Lia.language, Lia.soundOn ve kalanlar) önce dinleyicileriniz çalışmadan önce.
Otomatik çeviri. İngilizce, doğru kaynaktır. İngilizce olarak oku