Guides

Posez la question au bon moment, souvenez-vous de qui a dit oui, envoyez depuis votre serveur, et ouvrez l'écran approprié lorsqu'une notification est tapée.

#1. Demander lorsqu'il est utile

async function waitForOpponent(room) {
  if (!Lia.notificationsAllowed) {
    try {
      const { allowed } = await Lia.requestNotifications();
      if (allowed) await api("/api/notify-me", { allowed: true });
    } catch (error) {
      // "notifications_off": your app can't send them; carry on without.
    }
  }
  showWaiting(room);
}

// They can also turn them on or off from your app's ⋯ menu.
Lia.on("notificationsChanged", function (data) {
  api("/api/notify-me", { allowed: data.allowed });
});

Lia n'a pas'dire à votre serveur quand quelqu'un autorise les notifications, donc dites-le vous-même, comme ci-dessus. Ou tenez-vous plus simple : envoyez quand vous avez quelque chose à dire, et traitez not_allowed en tant que "non".

#2. Envoyer depuis votre serveur

async function notify(playerId, text, startParam) {
  try {
    return await lia("POST", "/notifications", { playerId, text, startParam });
  } catch (error) {
    const code = error.data?.error;
    if (code === "not_allowed") return db.setNotify(playerId, false); // they said no or stopped
    if (code === "rate_limited") return db.retryLater(playerId, error.data.retryAt); // retryAt may be missing
    if (code === "bad_text") console.warn("Lia refused the text:", error.data.problem);
    throw error;
  }
}

await notify(opponent, "@amara played. Your move.", "room-a81c2e09f4");

#3. Ouvrez l'écran correct

function route(startParam) {
  if (startParam?.startsWith("room-")) openRoom(startParam);
}
Lia.init().then(function () { route(Lia.startParam); Lia.ready(); });
Lia.on("startParam", function (data) { route(data.startParam); });

#Les écrire

• Jusqu'à 180 caractères, une seule ligne. Lia l'affiche sous votre application'le nom, donc ne'commencez par celui-ci.
• Aucun lien, numéros de téléphone ou mots suspects. Lia les refuse avec bad_text et un problem de link, phone ou scam. Le startParam est comment vous reliez votre application.
• Faites en sorte que chaque chose compte. Votre application peut envoyer une personne 3 par jour (sauf si l'équipe Lia l'a modifié), avec une heure d'intervalle, et toutes les applications ensemble 6 par jour. Utilisez-les pour des choses que la personne souhaite connaître.
• Écrivez dans leur langue. Gardez chaque joueur's Lia.language sur votre serveur lorsqu'ils ouvrent votre application, et envoyez-le-y.

#Tests

Les testeurs reçoivent des notifications de test de votre clé de test toutes les 30 secondes et au moins 20 par jour, et ils ne'ne pas compter vers leur total quotidien provenant de toutes les applications. Voir Tests.

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