SDK referencia
Notificaciones, invitaciones y el vestíbulo
Copiar página
Lia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.share y Lia.lobby.
#Notificaciones
Tu servidor envía notificaciones con POST /notifications. Su página solo solicita permiso. Vea Notificaciones.
#Lia.requestNotifications()
Pregunta a la persona, en Lia'su propia hoja de pago, para que su aplicación les envíe notificaciones. Si ya lo hicieron, responde de inmediato sin preguntar.
const { allowed } = await Lia.requestNotifications();Se resuelve con { allowed }. Lia.notificationsAllowed también se actualiza.
| Error | Cuándo |
|---|---|
notifications_off | Tu app no puede enviar notificaciones (el equipo Lia las apagó para ella). |
busy | Otro de Lia'las pantallas están abiertas. |
#Invitaciones
#Lia.inviteFriend(options)
Abre Lia'el selector de amigos. Cada amigo seleccionado recibe una tarjeta en su Lia chat que abre tu aplicación con tu startParam. La hoja también permite a la persona compartir su enlace de invitación en cualquier lugar.
const { invited } = await Lia.inviteFriend({ startParam: "room-k3x9" });| Opción | Tipo | |
|---|---|---|
startParam | cadena | Opcional. 1 a 64 de letras, dígitos, _ y -. |
idempotencyKey | cadena | Opcional (SDK 1.5). Con la misma clave, cada amigo recibe esa invitación's tarjeta una vez. Vea Claves de idempotencia. |
Se resuelve con { invited }: true una vez que alguien fue invitado o el enlace fue compartido. Tu aplicación nunca conocerá quién.
Errores: bad_start_param, bad_idempotency_key, busy.
#Lia.inviteLink(startParam)
Tu app'con marca lialabs.app enlace de lanzamiento, con un startParam opcional. Cualquiera puede abrirla: con Lia, abre tu aplicación con el startParam; sin él, apunta a la App Store. Llámalo después Lia.init().
const link = Lia.inviteLink("room-k3x9");
// "https://your-app.lialabs.app/play?start=room-k3x9"Devuelve una cadena (no una promesa). Lanza not_ready antes init() ha respondido, y bad_start_param para un startParam que no'ajustar.
#Lia.share(text)
Abre el teléfono's hoja de compartido con su texto, para cualquier aplicación en el teléfono. Se resuelve con null una vez que la hoja se cierre.
await Lia.share("I scored 1280 in Tilt Runner. Beat me: " + Lia.inviteLink());| Parámetro | Tipo | |
|---|---|---|
text | cadena | Hasta 500 caracteres. |
Errores: bad_text.
#El vestíbulo
Mesas públicas que cualquiera en Lia puede encontrar (SDK 1.6). Su servidor lista y asigna asientos; vea Mesas públicas.
#Lia.lobby
#Lia.lobby.tables(options)
Las mesas abiertas en tu aplicación, en orden de más reciente. Nunca el jugador'sus propias tablas, las completas o caducadas, o las de cualquiera que bloquearon o que los bloquearon.
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;| Opción | Tipo | |
|---|---|---|
stake | número | Opcional. Solo mesas en este stake, en LIA (0 para los gratuitos). |
cursor | cadena | Opcional. next desde la página anterior. |
limit | número | Opcional. 1 a 50, 20 por defecto. |
Se resuelve con { tables, next }: next es el cursor para más, o null. Cada tabla:
| Campo | Tipo | |
|---|---|---|
id | cadena | La tabla's id, como lo listó su servidor. |
game | cadena | Tu app's id. |
host | objeto | { name }: el anfitrión's Lia nombre de usuario. |
seats, taken | número | Asientos totales, y ocupados (el anfitrión's incluido). |
title | cadena o nulo | Hasta 40 caracteres. |
stake, pot | número | En LIA, como los listó su servidor (para mostrar). |
createdAt, expiresAt | número | Milisegundos desde 1970. |
Para sentarse, enviar la mesa's id a tu servidor, que sienta al jugador con POST /lobby/tables/:id/sit. Alguien que eligió tu mesa en Lia'propios salón llega con Lia.startParam establecido en lobby-<table id>: siéntalos de la misma manera.
Errores: bad_stake, bad_cursor, bad_session (la sesión no't ser renovado), not_in_lia.
#Lia.lobby.report(playerId, reason, options)
Denuncia a un jugador al equipo Lia. Ellos'también están bloqueados para la persona que reporta, por lo que ninguno ve al otro'sus tablas de nuevo.
await Lia.lobby.report("p_3f9c0a6d1b2e4f5a6b7c", "unfair", { tableId: "t8k2d", note: "Left every game when losing" });| Parámetro | Tipo | |
|---|---|---|
playerId | cadena | El jugador's id en su aplicación. |
reason | cadena | "name", "unfair", "abuse" o "other". |
options.tableId | cadena | Opcional. La mesa en la que sucedió. |
options.note | cadena | Opcional, hasta 300 caracteres. |
Se resuelve con { reported: true }. Errores: bad_reason, unknown_player, slow_down (más de 20 informes en un día), bad_note, bad_tableId.
Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés