Konsep

Notifikasi

Salin halaman

Pemain memilih apakah aplikasi Anda dapat memberi notifikasi kepada mereka. Server Anda mengirim setiap notifikasi, dalam batasan Lia yang ditetapkan agar orang-orang yang menyetujui tetap senang karena telah melakukannya.

#Bagaimana cara kerjanya

Orang tersebut mengizinkan merekaHalaman Anda memanggil Lia.requestNotifications() pada momen yang tepat, dan Lia bertanya di lembarannya sendiri. Orang-orang juga dapat mengaktifkan atau menonaktifkan notifikasi aplikasi Anda dari menu ⋯-nya.
Server Anda mengirim satuPOST /notifications dengan id pemain, teks, dan opsional startParam.
Mencapai ponsel merekaDi bawah nama aplikasi Anda, sebagai notifikasi dan di bel Lia's. Mengetuknya membuka aplikasi Anda dengan startParam.

#Menanyakan

Tanyakan ketika notifikasi jelas akan membantu orang tersebut: giliran mereka dalam permainan, pengiriman, teman yang bergabung. Jangan't bertanya saat aplikasi Anda dibuka.

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

Jika mereka sudah mengizinkannya, requestNotifications() jawaban { allowed: true } tanpa bertanya.
Jika aplikasi Anda mungkin tidak pernah mengirim notifikasi (tim Lia mematikan mereka), itu gagal dengan notifications_off.
Lia.notificationsAllowed katakan di mana posisi saat ini, dan notificationsChanged acara terpicu saat seseorang mengubahnya, dari permintaan Anda atau menu ⋯.

Lia tidak bisa'beri tahu server Anda saat seseorang mengizinkan atau menghentikan notifikasi. Beri tahu sendiri, atau hanya kirim dan tangani not_allowed.

#Mengirim

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

Lihat POST /notifications untuk setiap bidang dan jawaban.

#Batasan

Notifikasi adalah hak istimewa yang diberikan orang kepada aplikasi Anda, jadi Lia menjaganya tetap sedikit:

Batas	Langsung	Uji
Siapa	Pemain yang mengizinkan aplikasi Anda'notifikasi	Pengujian Anda yang memungkinkan mereka
Sehari, dari aplikasi Anda ke satu orang	Aplikasi Anda'jumlah harian, 3 kecuali tim Lia mengubahnya	Angka itu, dan setidaknya 20
Terpisah, dari aplikasi Anda ke satu orang	1 jam	30 detik
Sehari, dari semua aplikasi bersama ke satu orang	6	Tidak dihitung
Teks	1 hingga 180 karakter, spasi dan baris baru menjadi satu spasi	Sama
Tidak diperbolehkan dalam teks	Tautan, nomor telepon, dan kata-kata yang digunakan dalam penipuan (seperti Lia'obrolan mereka)	Sama

Ketika batas tercapai, POST /notifications jawaban 429 rate_limited. Untuk aplikasi Anda'batasannya juga menyebutkan kapan Anda bisa mencoba lagi, seperti retryAt (milidetik sejak 1970).

"Sehari" adalah jam terakhir 24 untuk aplikasi Anda'batasannya, dan orangnya'hari kalender mereka untuk total dari semua aplikasi.

#Membuka aplikasi Anda dari satu

Notifikasi membuka aplikasi Anda dengan startParam (1 hingga 64 huruf, angka, _ dan -) yang dibaca oleh halaman Anda Lia.startParam. Jika aplikasi Anda sudah terbuka saat orang mengetuknya, halaman Anda mendengar sebuah startParam acara lain.

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

#Pushes dan bel

Setiap notifikasi dikirim ke Lia'bel berbunyi. Itu'juga dikirim ke orang tersebut'ponsel Anda ketika mereka memiliki Lia'mengirimkan (pushes on); POST /notifications jawaban pushed: false ketika itu hanya mencapai bel.

Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris