Referensi SDK
Notifikasi, undangan dan lobi
Salin halaman
Lia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.share dan Lia.lobby.
#Notifikasi
Server Anda mengirim notifikasi dengan POST /notifications. Halaman Anda hanya meminta izin. Lihat Notifikasi.
#Lia.requestNotifications()
Menanyakan kepada orang tersebut, dalam Lia'lembar pembayaran miliknya, untuk memungkinkan aplikasi Anda mengirimkan notifikasi kepada mereka. Jika mereka sudah melakukannya, itu langsung menjawab tanpa bertanya.
const { allowed } = await Lia.requestNotifications();Menyelesaikan dengan { allowed }. Lia.notificationsAllowed juga diperbarui.
| Kesalahan | Kapan |
|---|---|
notifications_off | Aplikasi Anda mungkin tidak dapat mengirim notifikasi (tim Lia mematikan mereka untuknya). |
busy | Yang lain dari Lia'layar terbuka. |
#Undangan
Lihat Undangan dan tautan.
#Lia.inviteFriend(options)
Membuka Lia'pemilih teman. Setiap teman yang dipilih mendapatkan kartu di Lia obrolan mereka yang membuka aplikasi Anda dengan startParam Anda. Sheet juga memungkinkan orang tersebut berbagi tautan undangan Anda di mana saja.
const { invited } = await Lia.inviteFriend({ startParam: "room-k3x9" });| Opsi | Jenis | |
|---|---|---|
startParam | string | Opsional. 1 hingga 64 huruf, angka, _ dan -. |
idempotencyKey | string | Opsional (SDK 1.5). Dengan kunci yang sama, setiap teman mendapatkan undangan tersebut'kartu sekali. Lihat Kunci idempotensi. |
Menyelesaikan dengan { invited }: true sekali siapa pun diundang atau tautan dibagikan. Aplikasi Anda tidak pernah tahu siapa.
Kesalahan: bad_start_param, bad_idempotency_key, busy.
#Lia.inviteLink(startParam)
Aplikasi Anda'bermerk lialabs.app tautan peluncuran, dengan startParam opsional. Siapa saja bisa membukanya: dengan Lia, itu membuka aplikasi Anda dengan startParam; tanpa, itu mengarah ke App Store. Panggil setelah Lia.init().
const link = Lia.inviteLink("room-k3x9");
// "https://your-app.lialabs.app/play?start=room-k3x9"Mengembalikan string (bukan promise). Melempar not_ready sebelum init() telah menjawab, dan bad_start_param untuk sebuah startParam yang tidak'tidak cocok.
#Lia.share(text)
Membuka ponsel'bagian berbagi dengan teks Anda, untuk setiap aplikasi di ponsel. Menyelesaikan dengan null sekali lembar kerja ditutup.
await Lia.share("I scored 1280 in Tilt Runner. Beat me: " + Lia.inviteLink());| Parameter | Jenis | |
|---|---|---|
text | string | Maksimal 500 karakter. |
Kesalahan: bad_text.
#Lobi
Tabel publik yang dapat ditemukan oleh siapa saja di Lia (SDK 1.6). Server Anda mendaftarkan dan menempatkan mereka; lihat Tabel publik.
#Lia.lobby
#Lia.lobby.tables(options)
Meja terbuka di aplikasi Anda, terbaru terlebih dahulu. Bukan pemain'meja miliknya, meja penuh atau kedaluwarsa, atau milik siapa pun yang diblokir atau yang memblokir mereka.
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;| Opsi | Jenis | |
|---|---|---|
stake | nomor | Opsional. Hanya meja pada taruhan ini, dalam LIA (0 untuk yang gratis). |
cursor | string | Opsional. next dari halaman sebelumnya. |
limit | nomor | Opsional. 1 hingga 50, 20 secara default. |
Menyelesaikan dengan { tables, next }: next adalah kursor untuk lebih lanjut, atau null. Setiap tabel:
| Bidang | Jenis | |
|---|---|---|
id | string | Tabel'id, seperti yang terdaftar di servermu. |
game | string | Aplikasi Anda'id. |
host | objek | { name }: host's Lia nama pengguna. |
seats, taken | nomor | Total kursi, dan yang sudah diambil (pemilik'termasuk). |
title | string atau null | Maksimal 40 karakter. |
stake, pot | nomor | Di LIA, sebagai yang telah Anda daftarkan (untuk ditampilkan). |
createdAt, expiresAt | nomor | Milidetik sejak 1970. |
Duduk, kirim meja's id ke server kamu, yang menghubungkan pemain dengan POST /lobby/tables/:id/sit. Seseorang yang memilih meja Anda di Lia'lobi miliknya tiba dengan Lia.startParam diatur ke lobby-<table id>: dudukkan mereka dengan cara yang sama.
Kesalahan: bad_stake, bad_cursor, bad_session (sesi itu tidak't diperbarui), not_in_lia.
#Lia.lobby.report(playerId, reason, options)
Melaporkan pemain ke tim Lia. Mereka'juga diblokir oleh orang yang melaporkan, jadi keduanya tidak saling melihat'tabel s lagi.
await Lia.lobby.report("p_3f9c0a6d1b2e4f5a6b7c", "unfair", { tableId: "t8k2d", note: "Left every game when losing" });| Parameter | Jenis | |
|---|---|---|
playerId | string | Pemain'id di aplikasimu. |
reason | string | "name", "unfair", "abuse" atau "other". |
options.tableId | string | Opsional. Meja di mana kejadian itu terjadi. |
options.note | string | Opsional, hingga 300 karakter. |
Menyelesaikan dengan { reported: true }. Kesalahan: bad_reason, unknown_player, slow_down (lebih dari 20 laporan dalam sehari), bad_note, bad_tableId.
Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris