Bagikan melalui

Gambaran umum pemberitahuan berkala

Pemberitahuan berkala, yang juga disebut pemberitahuan polling, memperbarui petak peta dan lencana pada interval tetap dengan mengunduh konten dari layanan cloud. Untuk menggunakan pemberitahuan berkala, kode aplikasi klien Anda perlu memberikan dua informasi:

  • Pengidentifikasi Sumber Daya Seragam (URI) dari lokasi web untuk Windows melakukan polling untuk pembaruan petak atau lencana untuk aplikasi Anda
  • Seberapa sering URI harus dijajaki

Pemberitahuan berkala memungkinkan aplikasi Anda mendapatkan pembaruan petak peta langsung dengan layanan cloud minimal dan investasi klien. Pemberitahuan berkala adalah metode pengiriman yang baik untuk mendistribusikan konten yang sama ke audiens yang luas.

Catatan Anda dapat mempelajari lebih lanjut dengan mengunduh sampel Pemberitahuan push dan berkala untuk Windows 8.1 dan menggunakan kembali kode sumbernya di aplikasi Windows 10 Anda.

 

Cara kerjanya

Pemberitahuan berkala mengharuskan aplikasi Anda menghosting layanan cloud. Layanan ini akan dijajaki secara berkala oleh semua pengguna yang telah menginstal aplikasi. Pada setiap interval polling, seperti sekali satu jam, Windows mengirim permintaan HTTP GET ke URI, mengunduh ubin atau konten lencana yang diminta (sebagai XML) yang disediakan sebagai respons terhadap permintaan, dan menampilkan konten pada petak peta aplikasi.

Perhatikan bahwa pembaruan berkala tidak dapat digunakan dengan pemberitahuan toast. Toast paling baik dikirimkan melalui pemberitahuan terjadwal atau push .

Lokasi URI dan konten XML

Alamat web HTTP atau HTTPS yang valid dapat digunakan sebagai URI untuk dijajaki.

Respons server cloud mencakup konten yang diunduh. Konten yang dikembalikan dari URI harus sesuai dengan spesifikasi skema XML Petak atau Lencana, dan harus dikodekan UTF-8. Anda dapat menggunakan header HTTP yang ditentukan untuk menentukan waktu kedaluwarsa atau tag untuk pemberitahuan.

Perilaku Polling

Panggil salah satu metode ini untuk mulai melakukan polling:

Ketika Anda memanggil salah satu metode ini, URI segera dijajaki dan petak atau lencana diperbarui dengan konten yang diterima. Setelah jajak pendapat awal ini, Windows terus menyediakan pembaruan pada interval yang diminta. Polling berlanjut sampai Anda secara eksplisit menghentikannya (dengan TileUpdater.StopPeriodicUpdate), aplikasi Anda dihapus instalannya, atau, dalam kasus petak sekunder, petak peta dihapus. Jika tidak, Windows terus melakukan polling untuk pembaruan pada petak atau lencana Anda meskipun aplikasi Anda tidak pernah diluncurkan lagi.

Interval pengulangan

Anda menentukan interval pengulangan sebagai parameter metode yang tercantum di atas. Perhatikan bahwa meskipun Windows melakukan upaya terbaik untuk melakukan polling seperti yang diminta, intervalnya tidak tepat. Interval polling yang diminta dapat ditunda hingga 15 menit atas kebijakan Windows.

Waktu mulai

Anda secara opsional dapat menentukan waktu tertentu dalam sehari untuk mulai melakukan polling. Pertimbangkan aplikasi yang mengubah konten petak petanya hanya sekali sehari. Dalam kasus seperti itu, kami sarankan Anda melakukan polling mendekati waktu Anda memperbarui layanan awan Anda. Misalnya, jika situs belanja harian menerbitkan penawaran hari pada pukul 08.00, jajak pendapat untuk konten petak baru tidak lama setelah pukul 08.00.

Jika Anda memberikan waktu mulai, panggilan pertama ke polling metode untuk konten segera. Kemudian, polling reguler dimulai dalam waktu 15 menit dari waktu mulai yang disediakan.

Perilaku coba lagi otomatis

URI dijajaki hanya jika perangkat online. Jika jaringan tersedia tetapi URI tidak dapat dihubungi karena alasan apa pun, iterasi interval polling ini dilewati, dan URI akan dijajaki lagi pada interval berikutnya. Jika perangkat dalam keadaan mati, tidur, atau berhibernasi saat interval polling tercapai, URI dijajaki ketika perangkat kembali dari status mati atau tidur.

Menangani pembaruan aplikasi

Jika Anda merilis pembaruan aplikasi yang mengubah URI polling, Anda harus menambahkan tugas latar belakang pemicu waktu harian yang memanggil StartPeriodicUpdate dengan URI baru untuk memastikan ubin Anda menggunakan URI baru. Jika tidak, jika pengguna menerima pembaruan aplikasi Anda tetapi tidak meluncurkan aplikasi Anda, petak peta mereka masih akan menggunakan URI lama, yang mungkin gagal ditampilkan jika URI sekarang tidak valid atau jika payload yang dikembalikan mereferensikan gambar lokal yang tidak lagi ada.

Kedaluwarsa pemberitahuan petak peta dan lencana

Secara default, petak peta berkala dan pemberitahuan lencana kedaluwarsa tiga hari sejak diunduh. Ketika pemberitahuan kedaluwarsa, konten dihapus dari lencana, petak peta, atau antrean dan tidak lagi ditampilkan kepada pengguna. Ini adalah praktik terbaik untuk mengatur waktu kedaluwarsa eksplisit pada semua pemberitahuan petak peta dan lencana berkala, menggunakan waktu yang masuk akal untuk aplikasi atau pemberitahuan Anda, untuk memastikan bahwa konten tidak bertahan lebih lama dari yang relevan. Waktu kedaluwarsa eksplisit sangat penting untuk konten dengan rentang hidup yang ditentukan. Ini juga memastikan penghapusan konten basi jika layanan cloud Anda menjadi tidak dapat dijangkau, atau jika pengguna terputus dari jaringan untuk jangka waktu yang lama.

Layanan cloud Anda menetapkan tanggal dan waktu kedaluwarsa untuk pemberitahuan dengan menyertakan header HTTP X-WNS-Expires dalam payload respons. Header HTTP X-WNS-Expires sesuai dengan format tanggal HTTP. Untuk informasi selengkapnya, lihat StartPeriodicUpdate atau StartPeriodicUpdateBatch.

Misalnya, selama hari perdagangan aktif pasar saham, Anda dapat mengatur kedaluwarsa untuk pembaruan harga saham menjadi dua kali lipat dari interval polling Anda (seperti satu jam setelah tanda terima jika Anda melakukan polling setiap setengah jam). Sebagai contoh lain, aplikasi berita mungkin menentukan bahwa suatu hari adalah waktu kedaluwarsa yang sesuai untuk pembaruan petak berita harian.

Pemberitahuan berkala dalam antrean pemberitahuan

Anda dapat menggunakan pembaruan petak peta berkala dengan bersepeda pemberitahuan. Secara default, petak peta di layar Mulai memperlihatkan konten satu pemberitahuan hingga digantikan oleh pemberitahuan baru. Saat Anda mengaktifkan bersepeda, hingga lima pemberitahuan dipertahankan dalam antrean dan petak peta melewatinya.

Jika antrean telah mencapai kapasitas lima pemberitahuan, pemberitahuan baru berikutnya menggantikan pemberitahuan terlama dalam antrean. Namun, dengan mengatur tag pada pemberitahuan, Anda dapat memengaruhi kebijakan penggantian antrean. Tag adalah string khusus aplikasi yang tidak peka huruf besar/kecil hingga 16 karakter alfanumerik, yang ditentukan dalam header HTTP X-WNS-Tag dalam payload respons. Windows membandingkan tag pemberitahuan masuk dengan tag semua pemberitahuan yang sudah ada dalam antrean. Jika kecocokan ditemukan, pemberitahuan baru menggantikan pemberitahuan yang diantrekan dengan tag yang sama. Jika tidak ada kecocokan yang ditemukan, aturan penggantian default diterapkan dan pemberitahuan baru menggantikan pemberitahuan terlama dalam antrean.

Anda dapat menggunakan antrean dan pemberian tag pemberitahuan untuk menerapkan berbagai skenario pemberitahuan yang kaya. Misalnya, aplikasi stok dapat mengirim lima pemberitahuan, masing-masing tentang stok yang berbeda dan masing-masing ditandai dengan nama saham. Ini mencegah antrean pernah berisi dua pemberitahuan untuk stok yang sama, yang lebih lama dari yang sudah kedaluarsa.

Untuk informasi selengkapnya, lihat Menggunakan antrean pemberitahuan.

Mengaktifkan antrean pemberitahuan

Untuk menerapkan antrean pemberitahuan, pertama-tama aktifkan antrean untuk petak peta Anda (lihat Cara menggunakan antrean pemberitahuan dengan pemberitahuan lokal). Panggilan untuk mengaktifkan antrean perlu dilakukan hanya sekali dalam masa pakai aplikasi Anda, tetapi tidak ada salahnya memanggilnya setiap kali aplikasi Anda diluncurkan.

Polling untuk lebih dari satu pemberitahuan pada satu waktu

Anda harus menyediakan URI unik untuk setiap pemberitahuan yang ingin Anda unduh windows untuk petak peta Anda. Dengan menggunakan metode StartPeriodicUpdateBatch , Anda dapat menyediakan hingga lima URI sekaligus untuk digunakan dengan antrean pemberitahuan. Setiap URI dijajaki untuk satu payload pemberitahuan, pada atau mendekati waktu yang sama. Setiap URI yang dijajaki dapat mengembalikan nilai kedaluwarsa dan tagnya sendiri.