Concepts

Notifications

Copier la page

Les joueurs choisissent si votre application peut les notifier. Votre serveur envoie chaque notification, dans les limites Lia qui les fixe, afin que les personnes qui disent oui restent contentes d'avoir dit oui.

#Comment ils fonctionnent

La personne les autoriseVotre page appelle Lia.requestNotifications() à un bon moment, et Lia demande dans sa propre feuille. Les gens peuvent également activer ou désactiver les notifications de votre application depuis son menu ⋯.
Votre serveur envoie unPOST /notifications avec l'identifiant du joueur, le texte et un paramètre optionnel startParam.
Il atteint leur téléphoneSous le nom de votre application, en tant que notification et dans la sonnerie de Lia. En cliquant dessus, votre application s'ouvre avec votre startParam.

#Demande

Demandez lorsque la notification aiderait clairement la personne : son tour dans un jeu, une livraison, un ami qui rejoint. Ne'ne pas poser la question au moment où votre application s'ouvre.

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

S'ils les ont déjà autorisés, requestNotifications() réponses { allowed: true } sans demander.
Si votre application ne peut pas envoyer de notifications du tout (l'équipe Lia les a désactivées), cela échoue avec notifications_off.
Lia.notificationsAllowed dit où en est la situation, et le notificationsChanged événement se déclenche lorsqu'une personne le modifie, à partir de votre demande ou du menu ⋯.

Lia n'a pas'dire à votre serveur quand quelqu'un autorise ou arrête les notifications. Dites-le vous-même, ou envoyez simplement et gérez not_allowed.

#Envoi

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

Voir POST /notifications pour chaque champ et réponse.

#Limites

Les notifications sont un privilège que les gens donnent à votre application, donc Lia les maintient rares :

Limite	En direct	Test
Qui	Les joueurs ayant autorisé votre application'les notifications, ou elles ont été désactivées.	Vos testeurs qui ont permis
Un jour, de votre application vers une seule personne	Votre application'le nombre quotidien, 3 sauf si l'équipe Lia l'a modifié	Ce nombre, et au moins 20
Seul, de votre application à une seule personne	1 heure	30 secondes
Un jour, de toutes les applications ensemble vers une seule personne	6	Non comptabilisé
Texte	1 à 180 caractères, les espaces et les sauts de ligne deviennent des espaces simples	Même
Non autorisé dans le texte	Liens, numéros de téléphone et mots utilisés dans les escroqueries (comme dans Lia'les discussions)	Même

Quand une limite est atteinte, POST /notifications réponses 429 rate_limited. Pour votre application'ses propres limites dit également quand vous pouvez réessayer, comme retryAt (millisecondes depuis 1970).

"Un jour" est les dernières 24 heures pour votre application's lien, un portefeuille confus et un jeton qu'ils devaient acheter.'le jour du calendrier pour le total de toutes les applications.

#Ouvrir votre application à partir d'un

Une notification ouvre votre application avec son startParam (1 à 64 de lettres, chiffres, _ et -) que votre page lit Lia.startParam. Si votre application est déjà ouverte lorsque la personne la touche, votre page entend un startParam événement au lieu.

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

#Poussées et la cloche

Chaque notification va à Lia'la sonnette. Cela'est également envoyé à la personne'votre téléphone lorsqu'ils ont Lia'pousseurs activés ; POST /notifications réponses pushed: false quand il n'avait atteint que la cloche.

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