Conceitos

Os jogadores escolhem se seu app pode notificá-los. Seu servidor envia cada notificação, dentro dos limites Lia que estabelece para que as pessoas que disseram sim fiquem felizes por terem feito isso.

#Como eles funcionam

1. A pessoa permite que elesSua página chama Lia.requestNotifications() em um bom momento, e Lia pergunta em sua própria folha. As pessoas também podem ativar ou desativar as notificações do seu app a partir do menu ⋯.
2. Seu servidor envia umaPOST /notifications com o id do jogador, o texto e um startParam.
3. Ele alcança seu celularAbaixo do nome do seu app, como um push e em Lia's sino. Toque nele para abrir seu app com seu startParam.

#Perguntando

Pergunte quando uma notificação claramente ajudaria a pessoa: sua vez em um jogo, uma entrega, um amigo se juntando. Não'não pergunte no momento em que seu app abre.

if (!Lia.notificationsAllowed) {
  const { allowed } = await Lia.requestNotifications();
  if (allowed) tellYourServer(); // so it knows it may notify this player
}

• Se eles já os permitiram, requestNotifications() respostas { allowed: true } sem perguntar.
• Se o seu app não puder enviar notificações em absoluto (a equipe Lia as desativou), falha com notifications_off.
• Lia.notificationsAllowed diz onde as coisas estão, e o notificationsChanged evento é acionado quando a pessoa o muda, a partir da sua solicitação ou do menu ⋯.

Lia não pode'para informar ao seu servidor quando alguém permite ou para de receber notificações. Informe-o você mesmo, ou simplesmente envie e trate not_allowed.

#Enviando

{ "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "text": "It's your move against @amara.", "startParam": "match-8k2d" }

Ver POST /notifications para cada campo e resposta.

#Limites

Notificações são um privilégio que as pessoas dão ao seu app, então Lia as mantém poucas:

Quando um limite é atingido, POST /notifications respostas 429 rate_limited. Para o seu app'seu próprio limites também diz quando você pode tentar novamente, como retryAt (milissegundos desde 1970).

"Um dia" é as últimas 24 horas para o seu app's link, uma carteira confusa e um token que eles tiveram que comprar.'dia do calendário para o total de todos os apps.

#Abrindo seu app de um

Uma notificação abre seu app com seu startParam (1 a 64 de letras, dígitos, _ e -) que sua página lê Lia.startParam. Se seu app já estiver aberto quando a pessoa tocar nele, sua página ouve um startParam evento em vez disso.

function route(param) {
  if (param && param.startsWith("match-")) openMatch(param);
}
Lia.init().then(function () { route(Lia.startParam); Lia.ready(); });
Lia.on("startParam", function (data) { route(data.startParam); });

#Empurra e o sino

Toda notificação vai para Lia's campainha. Ele's também é enviado para a pessoa'seu telefone quando eles tiverem Lia'ativa as notificações; POST /notifications respostas pushed: false quando ele só chegou ao sino.

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