Guias

Enviar notificações

Copiar página

Pergunte na hora certa, lembre-se de quem disse sim, envie do seu servidor e abra a tela certa quando uma notificação for tocada.

#1. Pergunte quando ajudar

game.js

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ão pode'para informar ao seu servidor quando alguém permite notificações, então informe-o você mesmo, como acima. Ou mantenha mais simples: envie quando tiver algo a dizer, e trate not_allowed como um "não".

#2. Envie do seu servidor

server.js

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. Abra a tela certa

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); });

#Escrevendo-os

Até 180 caracteres, uma linha. Lia mostra-o sob seu app's nome, então não'para começar com ele.
Nenhum link, números de telefone ou palavras suspeitas. Lia recusa-os com bad_text e um problem de link, phone ou scam. O startParam é como você se conecta ao seu app.
Faça cada um contar. Seu app pode enviar uma pessoa 3 por dia (a menos que a equipe Lia tenha mudado isso), com uma hora de intervalo, e todos os apps juntos 6 por dia. Gaste-os em coisas que a pessoa quer saber.
Escreva em seu idioma. Mantenha cada jogador's Lia.language no seu servidor quando eles abrirem seu app, e envie-o nele.

#Testando

Testadores recebem notificações de teste de sua chave de teste a cada 30 segundos e pelo menos 20 por dia, e eles não'não contam para o total diário deles de todos os apps. Veja Testando.

Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês