Concepts

Joueurs et sessions

Copier la page

Chaque joueur arrive connecté en tant que joueur de votre application, avec un identifiant uniquement pour votre application. Les jetons de session permettent à votre serveur de savoir qui demande.

#Joueurs

Les gens ne se connectent jamais à votre application : Lia le fait pour eux. La première fois qu'une personne ouvre votre application, Lia leur fait un joueur de lui. Lia.init() vous donne :

{
  "player": { "id": "p_3f9c0a6d1b2e4f5a6b7c", "name": "amara" },
  "session": "lias_eyJhcHAiOi…",
  "exp": 1761998400000,
  "mode": "live"
}

player.id est cette personne'id dans votre application. Il reste le même chaque fois qu'ils l'ouvrent, sur n'importe quel téléphone. Il'pseudonyme : il'seulement pour votre application, jamais leur compte Lia, et une autre application obtient un identifiant différent pour la même personne. Utilisez-le comme clé pour tout ce que vous conservez sur un joueur.
player.name est le nom d'utilisateur Lia d'eux, sans le @. Il'publique et peut changer ; Lia le maintient à jour chaque fois qu'ils ouvrent votre application. Affichez-le, mais ne le faites pas'ne pas clavier quoi que ce soit dessus.

Lia ne donne jamais à votre application une personne'votre adresse e-mail, numéro de téléphone, solde ou tout autre information sur leur compte.

#Sessions

Votre page peut'ne pas prouver qui il est à votre serveur : n'importe qui peut envoyer à votre serveur une demande qui prétend être n'importe quel joueur. Donc Lia donne à votre page un jeton de session, signé par Lia, que votre serveur vérifie avec Lia.

Lia.init() réponds avec un session et quand il se termine, exp (millisecondes depuis 1970).
Une session dure 15 minutes. Obtenez-en un nouveau avec Lia.session() quand vous en avez besoin ; il répond { session, exp }.
Une session nomme votre application, le joueur et le mode (test ou live). Un jeton d'une autre application, d'un autre mode ou expiré n'est pas valide.

// In your page: send a fresh session with anything your server must trust.
const { session } = await Lia.session();
await fetch("/api/claim", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ session, chargeId }),
});

Votre serveur envoie le jeton à POST /session/verify avec votre clé secrète et obtient l'identifiant du joueur :

{ "valid": true, "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "mode": "live", "exp": 1761998400000 }

#Modes

Chaque session est dans une mode, test ou live, et chaque clé est la même. Une clé de test ne vérifie que les sessions de test et une clé de production ne vérifie que les sessions en direct. Voir Test et live.

#Lia'ses propres enregistrements sur un joueur

Certaines choses Lia garde par joueur dans votre application, donc vous ne'ne pas avoir de serveur pour eux :

Leur meilleur score et placez sur votre classement.
Leur stockage en nuage: jusqu'à 1024 clés.
Si ils avez autorisé vos notifications.
Leur frais, récompenses et vidéos regardées, que votre serveur peut consulter.

Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais