SDK referansı

Lia SDK'i yükleme, Lia nesnesinin özelliklerini, çağrıların cevaplanması ve başarısız olması, ve her yöntemin bir indeksi.

#Yükleniyor

<script src="https://api.lialabs.org/sdk/lia-apps-v1.js"></script>

Kendi betiklerinizden önce Lia'dan yükleyin. Bir global tanımlar, window.Lia, bir kez (ikinci kez yükleme hiçbir şey yapmaz). Bu'bağımsız JavaScript ve herhangi bir framework ile çalışır veya hiç framework kullanmaz. Bu sayfa 1.8.0. sürümünü açıklar

TypeScript içinde, global bildirilir, buraya kadar's bir tür paketi:

declare global {
  interface Window { Lia: any }
}
const Lia = window.Lia;

#Aramalar nasıl cevaplanır

• Çoğu yöntem bir promise döndürür. Her yöntemin açıklamasında belirtilen cevapla çözülür, aksi takdirde bir hata ile reddedilir Error bir tane sahip code (ve bir message oyuncular için değil, sadece sizin için İngilizce.
• Kötü argümanlar da reddeder, şu gibi bir kodla bad_text, Lia'a ulaşmadan önce. Birkaç yöntem var ki'promisler döndürür (Lia.inviteLink, Lia.on, düğmeler' ayarlayıcılar) yerine atar.
• Uygulama Lia dışında, her çağrı reddedilir not_in_lia. Lia.available önünde size söyler.
• Lia 20 saniye içinde cevap vermelidir, veya çağrı reddedilir timeout. Kişiye (ödeme sayfası, reklamlar, diyaloglar, arkadaş seçici, bildirim isteği, tarayıcı, Face ID, paylaşım) bekleyen çağrılar, ne kadar süreceği kadar bekler.

try {
  const result = await Lia.pay("extra-lives");
} catch (error) {
  switch (error.code) {
    case "cancelled": return; // they changed their mind
    case "not_in_lia": return showOpenInLia();
    default: Lia.toast("Something went wrong", { tone: "error" });
  }
}

Her kod Hata kodları.

#Özellikler

Bunları sonra oku Lia.init() varsayılanları tutar. Çoğu Lia tarafından güncellenir'olaylar.

#Lia.isVersionAtLeast(version)

İşte SDK en az bu sürüm olmalı, daha sonra eklenen özellikler için.

if (Lia.isVersionAtLeast("1.3")) Lia.inviteFriend({ startParam: room });

Bir boolean döndürür (bir promise değil).

#CSS değişkenleri

Sonra init(), SDK bunları sayfanızda ayarlar'kök ve güncel tutar: Lia'teması (--lia-bg-color ve kalanlar), --lia-color-scheme, --lia-viewport-height, --lia-safe-area-inset-* ve --lia-content-safe-area-inset-*. Bkz. Görünüm ve his.

#Her yöntem

#Telegram'dan geliyor

Lia's SDK Telegram takip eder's Mini Uygulamalar, uygun olduğu yerde, bu yüzden çoğu fikir taşınır:

#Web-uygulama analitiği

Lia.analytics (SDK 1.8) Lia Labs’nin OpenPanel projesindeki web uygulaması kullanımını isteğe bağlı olarak kaydeder. Şu anki iOS ve Android derlemeleriyle çalışır. Bu bir ayrı ayrı onayla yerel uygulamanın "Kullanım verilerini paylaş" anahtarından.

Sayfanız çağrıldığında Lia.ready(), SDK ekibi tarafından analitiklerin etkin olup olmadığı kontrol edilir ve bu uygulama için seçili bir tercih yoksa bir kez sorulur. Reddetmek hiçbir olay göndermez. Küçük bir gizlilik butonu, kişinin daha sonra tercihini değiştirmesine olanak tanır. Seçim, Lia’ın sunucusunda her oyuncu ve web uygulaması için saklanır. Onay alınmadan önce hiçbir analitik olayı kuyruğa alınamaz veya reddedildikten sonra tekrar oynatılmaz.

• Lia.analytics.allowed: bu sayfanın şu anda izin olup olmadığını gösterir.
• Lia.analytics.requestConsent(): gizlilik tercihini tekrar açar ve cevap verir true sadece izin sonra.
• Lia.analytics.disable(): bu sayfanın gönderimlerini hemen durdurur ve tercih edilmemiş durumu kaydeder.
• Lia.analytics.track(name, properties?): bir olayın gönderildiğini sorar; başarısızlıklar oyununuzu asla durdurmez. İsimler küçük harfler, rakamlar ve alt çizgiler kullanır, bir harfle başlar ve en fazla 48 karakter uzunluğundadır. Özellikler, en fazla 12 sayısal veya mantıksal değer içerebilir, küçük harfli tanımlayıcı anahtarlarla, en fazla 32 karakter uzunluğundadır.

await Lia.init();
Lia.ready();
// Only sends when the person has already agreed. Never prompt during a round.
await Lia.analytics.track("round_finished", { level: 3, score: 120, won: true });

Çıkarılan SDK onaydan sonra açılış ve devamı kaydedilir. Oyun yolları için kendi statik olay isimlerinizi ekleyin. Olay isimleri olarak isimler, e-postalar, mesajlar, URLs, ücretsiz metin veya hesap tanımlayıcıları kullanmayın. Metin özellikleri reddedilir. Toplayıcı uygulama kimliğini ve canlı/test modunu ekler, imzalı oturumu kontrol eder, onayı tekrar kontrol eder, ekip analitikleri kapatma anahtarını saygı duyar ve oyuncu başına uygulama başına dakika başına 60 olaya sınırlar. Oyuncu profili kimliği, sayfa URLs, form değerleri veya kişinin IP adresi olmadan toplu olayları iletir.

İzleyici kullanır POST /api/web-analytics/consent ve /track tazeliğinde imzalı bir uygulama oturumu ile. Bu SDK'ya ait uç noktalar, geliştirici API anahtarı gerektirmez. OpenPanel kimlik bilgileri Lia'ün sunucusunda kalır.

Bu analiz yöntemleri, script etiketiyle yüklenen barındırılmış SDK’da bulunur. Davet ve lobi bağlantıları izin istemini otomatik açmaz; gizlilik düğmesi kullanılabilir durumda kalır.

Otomatik çeviri. İngilizce, doğru kaynaktır. İngilizce olarak oku