SDK référence
Notifications, invitations et le salon
Copier la page
Lia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.share et Lia.lobby.
#Notifications
Votre serveur envoie des notifications avec POST /notifications. Votre page ne demande qu'une autorisation. Voir Notifications.
#Lia.requestNotifications()
Demande à la personne, dans Lia'son propre feuille de paiement, pour permettre à votre application de leur envoyer des notifications. S'ils l'ont déjà fait, il répond immédiatement sans demander.
const { allowed } = await Lia.requestNotifications();Résout avec { allowed }. Lia.notificationsAllowed est également mis à jour.
| Erreur | Quand |
|---|---|
notifications_off | Votre application ne peut pas envoyer de notifications (l'équipe Lia les a désactivées pour elle). |
busy | Un autre de Lia'les écrans sont ouverts. |
#Invitations
Voir Invitations et liens.
#Lia.inviteFriend(options)
Ouvre Lia'sélecteur d'amis. Chaque ami sélectionné reçoit une carte dans leur chat Lia qui ouvre votre application avec votre startParam. La feuille permet également à la personne de partager le lien d'invitation n'importe où.
const { invited } = await Lia.inviteFriend({ startParam: "room-k3x9" });| Option | Type | |
|---|---|---|
startParam | chaîne | Optionnel. 1 à 64 lettres, chiffres, _ et -. |
idempotencyKey | chaîne | Optionnel (SDK 1.5). Avec la même clé, chaque ami reçoit cette invitation'la carte une seule fois. Voir Clés d'idempotence. |
Résout avec { invited }: true une fois qu'une personne a été invitée ou que le lien a été partagé. Votre application ne connaît jamais qui.
Erreurs : bad_start_param, bad_idempotency_key, busy.
#Lia.inviteLink(startParam)
Votre application'avec son identité de marque lialabs.app lien de lancement, avec un startParam facultatif. Tout le monde peut l'ouvrir : avec Lia, il ouvre votre application avec le startParam ; sans, il pointe vers l'App Store. Appelez-le après Lia.init().
const link = Lia.inviteLink("room-k3x9");
// "https://your-app.lialabs.app/play?start=room-k3x9"Renvoie une chaîne (pas une promesse). Lance not_ready avant init() a répondu, et bad_start_param pour un startParam qui ne'ça ne marche pas.
#Lia.share(text)
Ouvre le téléphone'la feuille de partage avec votre texte, pour n'importe quelle application sur le téléphone. Résout avec null une fois que la feuille se ferme.
await Lia.share("I scored 1280 in Tilt Runner. Beat me: " + Lia.inviteLink());| Paramètre | Type | |
|---|---|---|
text | chaîne | Jusqu'à 500 caractères. |
Erreurs : bad_text.
#Le salon
Tables publiques que n'importe qui sur Lia peut trouver (SDK 1.6). Votre serveur liste et gère les tables ; voir Tables publiques.
#Lia.lobby
#Lia.lobby.tables(options)
Les tables ouvertes dans votre application, du plus récent au plus ancien. Jamais le joueur'ses propres tables, tables pleines ou expirées, ou celles de quiconque qu'ils ont bloqué ou qui les a bloqués.
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;| Option | Type | |
|---|---|---|
stake | nombre | Optionnel. Seulement les tables à ce niveau, dans LIA (0 pour les gratuits). |
cursor | chaîne | Optionnel. next de la page précédente. |
limit | nombre | Optionnel. 1 à 50, 20 par défaut. |
Résout avec { tables, next }: next est le curseur pour plus, ou null. Chaque table :
| Champ | Type | |
|---|---|---|
id | chaîne | Le tableau'id, tel que votre serveur l'a listé. |
game | chaîne | Votre application'id. |
host | objet | { name }: l'hôte's Lia nom d'utilisateur. |
seats, taken | nombre | Nombre total de sièges, et pris (l'hôte'inclus). |
title | chaîne ou null | Jusqu'à 40 caractères. |
stake, pot | nombre | Dans LIA, tel que votre serveur les a listés (pour l'affichage). |
createdAt, expiresAt | nombre | Millisecondes depuis 1970. |
Pour s'asseoir, envoyez la table's id à votre serveur, qui place le joueur avec POST /lobby/tables/:id/sit. Quelqu'un qui a choisi votre table dans Lia'son propre salon arrive avec Lia.startParam défini à lobby-<table id>: asseyez-les de la même manière.
Erreurs : bad_stake, bad_cursor, bad_session (la session n''ne pas être renouvelé), not_in_lia.
#Lia.lobby.report(playerId, reason, options)
Signale un joueur à l'équipe Lia. Ils'réutilisez également bloqués pour la personne qui signale, donc aucun des deux ne voit l'autre'côté, les tables à nouveau.
await Lia.lobby.report("p_3f9c0a6d1b2e4f5a6b7c", "unfair", { tableId: "t8k2d", note: "Left every game when losing" });| Paramètre | Type | |
|---|---|---|
playerId | chaîne | Le joueur'id dans votre application. |
reason | chaîne | "name", "unfair", "abuse" ou "other". |
options.tableId | chaîne | Facultatif. La table à laquelle cela s'est produit. |
options.note | chaîne | Optionnel, jusqu'à 300 caractères. |
Résout avec { reported: true }. Erreurs : bad_reason, unknown_player, slow_down (plus de 20 rapports par jour), bad_note, bad_tableId.
Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais