SDK referansı
Bildirimler, davetler ve lobi
Sayfayı kopyala
Lia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.share ve Lia.lobby.
#Bildirimler
Sunucunuz bildirimler gönderirken POST /notifications. Sayfan sadece izin ister. Bkz. Bildirimler.
#Lia.requestNotifications()
Kişiyi Lia'da onaylamasını ister'kendi ödeme sayfası, uygulamanızın onlara bildirim göndermesine izin vermek için. Zaten yaptıysalar, sormadan hemen cevap verir.
const { allowed } = await Lia.requestNotifications();Çözülür { allowed }. Lia.notificationsAllowed güncellenir.
| Hata | Zaman |
|---|---|
notifications_off | Uygulamanız bildirim gönderemez ( Lia ekibi onları kapatmış). |
busy | Lia'ın başka biri'ekranlar açıktır. |
#Davetler
#Lia.inviteFriend(options)
Lia'u açar'arkadaş seçici. Seçilen her arkadaş, Lia sohbetlerinde uygulamanızı açan bir kart alır ve startParam ile birlikte. Sayfa, kişiye başka bir yerde davet bağlantısını paylaşma imkanı verir.
const { invited } = await Lia.inviteFriend({ startParam: "room-k3x9" });| Seçenek | Tür | |
|---|---|---|
startParam | dize | Seçmeli. 1 ile 64 harf, rakam, _ ve -. |
idempotencyKey | dize | Seçenek (SDK 1.5). Aynı anahtarla, her arkadaşa o daveti verir'u kartı bir kere. Bkz. Tekrar edilebilirlik anahtarları. |
Çözülür { invited }: true kimse davet edildi mi ya da link paylaşıldı mı. Uygulamanız kimseyi öğrenmez.
Hatalar: bad_start_param, bad_idempotency_key, busy.
#Lia.inviteLink(startParam)
Senin uygulaman's lialabs.app başlatma bağlantısı, isteğe bağlı startParam ile. Kimse açamaz: Lia ile, startParam ile uygulamanızı açar; olmadan, App Store'a yönlendirir. startParam oluşturmadan önce çağırın. Lia.init().
const link = Lia.inviteLink("room-k3x9");
// "https://your-app.lialabs.app/play?start=room-k3x9"Bir dize döndürür (bir promise değil). Atar not_ready önce init() yanıtladı ve bad_start_param için bir startParam ki'sığasın.
#Lia.share(text)
Telefonu açar's paylaşma sayfası ile metniniz, telefon üzerindeki her uygulama için. Çözümle null form kapatıldığında.
await Lia.share("I scored 1280 in Tilt Runner. Beat me: " + Lia.inviteLink());| Parametre | Tür | |
|---|---|---|
text | dize | Maksimum 500 karakter. |
Hatalar: bad_text.
#Oda
Kamuya açık tablolar Lia üzerindeki herkesin bulabileceği (SDK 1.6). Sunucunuz listeleri ve oturumları yerleştirir; bakınız Kamuya açık tablolar.
#Lia.lobby
#Lia.lobby.tables(options)
Uygulamanızdaki açık masalar, en yenisi öncelikli. Asla oyuncu değil'kendi tabloları, dolu veya süresi dolmuş olanlar, veya onların engellediği veya onları engellediği herkesin.
const { tables, next } = await Lia.lobby.tables({ stake: 5 });
// [{ id: "t8k2d", game: "your-app", host: { name: "amara" }, seats: 2, taken: 1, title: "Quick game", stake: 5, pot: 0, createdAt, expiresAt }]
const more = next ? await Lia.lobby.tables({ stake: 5, cursor: next }) : null;| Seçenek | Tür | |
|---|---|---|
stake | sayı | Seçmeli. Bu bahse yalnızca tablolar, LIA (0 ücretsiz olanlar için). |
cursor | dize | Seçmeli. next önceki sayfadan. |
limit | sayı | Seçmeli. 1 ile 50, 20 varsayılan olarak. |
Çözülür { tables, next }: next daha fazlası için imleç. null. Her tablo:
| Alan | Tür | |
|---|---|---|
id | dize | Tablo's id, sunucunuzda listelenenidir. |
game | dize | Senin uygulaman's id. |
host | nesne | { name }: ana bilgisayar's Lia kullanıcı adı. |
seats, taken | sayı | Toplam koltuk sayısı ve alınan (sağlayıcı's dahil edilmiştir). |
title | dize veya null | Maksimum 40 karakter. |
stake, pot | sayı | LIA içinde, sunucunuz tarafından listelenenler (göstermek için). |
createdAt, expiresAt | sayı | 1970.'dan itibaren milisaniye |
Oturmak, masayı göndermek's id sunucunuza, oyuncuyu POST /lobby/tables/:id/sit. Lia'da tablonuzu seçmiş biri'kendi lobi gelir Lia.startParam ayarlandı lobby-<table id>: aynı şekilde yerleştirin.
Hatalar: bad_stake, bad_cursor, bad_session (oturum sahip değil't yenilenirse, not_in_lia.
#Lia.lobby.report(playerId, reason, options)
Bir oyuncuyu Lia ekibine bildirir. Onlar'raporlayan kişi için de engellenir, bu yüzden ikisi de birbirini göremez'tabloları tekrar.
await Lia.lobby.report("p_3f9c0a6d1b2e4f5a6b7c", "unfair", { tableId: "t8k2d", note: "Left every game when losing" });| Parametre | Tür | |
|---|---|---|
playerId | dize | Oyuncu's uygulamadaki id'si. |
reason | dize | "name", "unfair", "abuse" veya "other". |
options.tableId | dize | Opsiyonel. Olayın gerçekleştiği masa. |
options.note | dize | Seçmeli, 300 karaktere kadar. |
Çözülür { reported: true }. Hatalar: bad_reason, unknown_player, slow_down (günde 20'dan fazla rapor), bad_note, bad_tableId.
Otomatik çeviri. İngilizce, doğru kaynaktır. İngilizce olarak oku