Conceptos

Notificaciones

Copiar página

Los jugadores eligen si tu aplicación puede notificarles. Tu servidor envía cada notificación, dentro de los límites Lia que establece para que las personas que dicen sí estén contentas de haberlo hecho.

#Cómo funcionan

La persona los permiteTu página llama Lia.requestNotifications() en un buen momento, y Lia pregunta en su propia hoja. Las personas también pueden activar o desactivar las notificaciones de su aplicación desde el menú ⋯.
Tu servidor envía unoPOST /notifications con el id del jugador, el texto y un opcional startParam.
Llega a su teléfonoBajo el nombre de tu aplicación, como una notificación y en la campana de Lia. Al tocarla, se abre tu aplicación con tu startParam.

#Preguntar

Pregunte cuando una notificación claramente ayudaría a la persona: su turno en un juego, un envío, un amigo que se une. No't preguntar en el momento en que su aplicación se abre.

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

Si ya los permitieron, requestNotifications() respuestas { allowed: true } sin preguntar.
Si su aplicación puede no enviar notificaciones en absoluto (el equipo Lia las desactivó), falla con notifications_off.
Lia.notificationsAllowed dice dónde están las cosas, y el notificationsChanged el evento se dispara cuando la persona lo cambia, desde tu solicitud o desde el menú ⋯.

Lia no puede'no decirle a su servidor cuando alguien permite o detiene las notificaciones. Dígaselo usted mismo, o simplemente envíe y maneje not_allowed.

#Enviando

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

Ver POST /notifications para cada campo y respuesta.

#Límites

Las notificaciones son un privilegio que la gente le da a tu aplicación, por lo tanto Lia las mantiene pocas:

Límite	Vivo	Prueba
Quién	Jugadores que permitieron tu aplicación'notificaciones	Sus probadores que lo permitieron
Un día, de tu aplicación a una persona	Tu app'el número diario, 3 a menos que el Lia equipo lo haya cambiado	Ese número, y al menos 20
Separado, de tu app a una persona	1 hora	30 segundos
Un día, de todas las aplicaciones juntas a una persona	6	No contado
Texto	1 a 180 caracteres, los espacios y los saltos de línea se convierten en espacios simples	Mismo
No permitido en el texto	Enlaces, números de teléfono y palabras usadas en estafas (como en Lia's chats)	Mismo

Cuando se alcanza un límite, POST /notifications respuestas 429 rate_limited. Para tu aplicación'propios límites también dice cuándo puedes intentar de nuevo, como retryAt (milisegundos desde 1970).

"Un día" es las últimas 24 horas para su aplicación'tus límites, y la persona's día de calendario para el total de todas las apps.

#Abre tu aplicación desde uno

Una notificación abre tu aplicación con su startParam (1 a 64 de letras, dígitos, _ y -), que tu página lee desde Lia.startParam. Si tu aplicación ya está abierta cuando la persona la toca, tu página escucha un startParam evento en su lugar.

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

#Notificaciones y la campana

Cada notificación va a Lia's timbre. Es's también se envía a la persona'el teléfono de la persona cuando tienen Lia'empuja hacia adelante; POST /notifications respuestas pushed: false cuando solo llegó a la campana.

Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés