Kavramlar

Bildirimler

Sayfayı kopyala

Oyuncular, uygulamanızın onlara bildirim gönderip gönderemeyeceğini seçerler. Sunucunuz, sınırlar Lia tarafından ayarlandığı sürece her bildirimi gönderir; bu da onların evet dedikleri için mutlu kalmasını sağlar.

#Nasıl çalışır

Kişi onları izin verirSayfanız çağırır Lia.requestNotifications() iyi bir anda ve Lia kendi sayfasında sorar. İnsanlar uygulamanızın bildirimlerini açıp kapamak için ⋯ menüsünden de yararlanabilir.
Sunucunuz bir tane gönderirPOST /notifications oyuncunun kimliği, metin ve isteğe bağlı startParam.
O onun telefonuna ulaşırUygulamanızın adının altında, bir itme ve Lia'ın zilinde. Tıklamak, uygulamanızı açar ve sizinle startParam.

#Sormak

Kişinin açıkça faydası olacak bir bildirimde sor: oyununun sırası, bir teslimat, bir arkadaşın katılması. Hayır't uygulamanız açıldığında anı sor.

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

Zaten onları izin verdiyse, requestNotifications() cevaplar { allowed: true } sormadan.
Uygulamanızın hiçbir bildirim gönderemeyeceği durumda (Lia ekibi bunları kapatmışsa), şu hatayla başarısız olur notifications_off.
Lia.notificationsAllowed durumun nerede olduğunu söyler, ve notificationsChanged kişi değiştirdiğinde (sizin isteğinize veya ⋯ menüsünden), olay tetiklenir.

Lia yapamaz'kimse bildirimleri kabul eder veya durdurur. Kendiniz bildirin, ya da sadece gönderin ve ele alın not_allowed.

#Gönderme

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

Bak POST /notifications her alan ve cevap için.

#Sınırlar

Bildirimler, insanların uygulamanıza verdiği bir ayrıcalıktır, bu yüzden Lia onları az tutar:

Sınır	Canlı	Test
Kim	Uygulamanızı izin veren oyuncular'bildirimler	İzin veren testçileriniz
Uygulamanızdan bir kişiye bir gün	Senin uygulaman'günde ki sayı, 3 Lia ekibi onu değiştirdiğinde değil	O sayı ve en az 20
Uygulamanızdan birine ayrı ayrı	1 saat	30 saniye
Tüm uygulamalardan bir kişiye toplam bir gün	6	Sayılmadı
Metin	1 ile 180 karakter, boşluklar ve yeni satırlar tek boşluk haline gelir	Aynısı
Metinde izin verilmiyor	Bağlantılar, telefon numaraları ve sahtekârlıkta kullanılan kelimeler (örneğin Lia'u sohbetler)	Aynısı

Bir sınır ulaşıldığında, POST /notifications cevaplar 429 rate_limited. Uygulamanız için'kendi sınırları aynı zamanda ne zaman tekrar deneyebileceğinizi de söyler, örneğin retryAt (1970'dan itibaren milisaniye).

"Bir gün" uygulamanız için son 24 saat'limitleri ve kişi'u toplam tüm uygulamalardan gelen günlük.

#Birinden uygulamanızı açın

Bildirim, uygulamanızı açar ve startParam (1 ile 64 harf, rakam, _ ve -), sayfanızın okuduğu Lia.startParam. Kişi uygulamanızı tıkladığında uygulamanız zaten açık ise, sayfanız bir startParam olayı yerine.

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

#İtme ve zil

Her bildirim Lia'a gider'u zil. O's aynı kişiye de gönderildi'telefonları Lia'da olduğunda'itme açık; POST /notifications cevaplar pushed: false sadece zilin altına ulaştığında

Otomatik çeviri. İngilizce, doğru kaynaktır. İngilizce olarak oku