TileUpdater.StartPeriodicUpdateBatch Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence) |
Memulai serangkaian pembaruan berwaktivitas yang bersepeda pada petak peta yang terikat dengan updater. Konten pembaruan diambil dari array Pengidentifikasi Sumber Daya Seragam (URI) tertentu, pembaruan pertama segera terjadi dan pembaruan berikutnya terjadi pada interval berkala setelahnya. Catatan Untuk menggunakan fitur ini, Anda harus terlebih dahulu mengaktifkan antrean pemberitahuan petak peta dengan memanggil EnableNotificationQueue. |
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence) |
Memulai serangkaian pembaruan berwaktivitas yang bersepeda pada petak peta yang terikat dengan updater. Konten pembaruan diambil dari array Pengidentifikasi Sumber Daya Seragam (URI) tertentu dengan pembaruan dimulai pada waktu yang ditentukan dan pembaruan berikutnya terjadi pada interval berkala setelahnya. Catatan Untuk menggunakan fitur ini, Anda harus terlebih dahulu mengaktifkan antrean pemberitahuan petak peta dengan memanggil EnableNotificationQueue. |
StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)
Memulai serangkaian pembaruan berwaktivitas yang bersepeda pada petak peta yang terikat dengan updater. Konten pembaruan diambil dari array Pengidentifikasi Sumber Daya Seragam (URI) tertentu, pembaruan pertama segera terjadi dan pembaruan berikutnya terjadi pada interval berkala setelahnya.
Catatan
Untuk menggunakan fitur ini, Anda harus terlebih dahulu mengaktifkan antrean pemberitahuan petak peta dengan memanggil EnableNotificationQueue.
public:
virtual void StartPeriodicUpdateBatch(IIterable<Uri ^> ^ tileContents, PeriodicUpdateRecurrence requestedInterval) = StartPeriodicUpdateBatch;
/// [Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatch")]
void StartPeriodicUpdateBatch(IIterable<Uri> const& tileContents, PeriodicUpdateRecurrence const& requestedInterval);
[Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatch")]
public void StartPeriodicUpdateBatch(IEnumerable<System.Uri> tileContents, PeriodicUpdateRecurrence requestedInterval);
function startPeriodicUpdateBatch(tileContents, requestedInterval)
Public Sub StartPeriodicUpdateBatch (tileContents As IEnumerable(Of Uri), requestedInterval As PeriodicUpdateRecurrence)
Parameter
- tileContents
Array hingga lima Pengidentifikasi Sumber Daya Seragam (URI) tempat konten XML pembaruan petak peta bersepeda akan diambil. Jika array berisi lebih dari lima Pengidentifikasi Sumber Daya Seragam (URI), metode akan gagal.
- requestedInterval
- PeriodicUpdateRecurrence
Frekuensi di mana Pengidentifikasi Sumber Daya Seragam (URI) dijajaki untuk konten petak peta baru, mengikuti pembaruan awal pada startTime.
- Atribut
Keterangan
Menggunakan antrean pemberitahuan dengan pembaruan berkala
Untuk menggunakan antrean pemberitahuan, Anda harus terlebih dahulu mengaktifkannya untuk petak peta Anda dengan baris kode ini:
Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);
API ini hanya perlu dipanggil sekali dalam masa pakai aplikasi Anda, tetapi tidak ada salahnya memanggilnya setiap kali aplikasi diluncurkan.
Dalam kasus pemberitahuan berkala, URL unik disediakan untuk setiap pemberitahuan. Setiap URL dijajaki secara berkala oleh Windows untuk konten pemberitahuan yang diperbarui. Payload konten yang dikembalikan dari setiap URL harus berisi versi XML pemberitahuan untuk semua ukuran petak peta yang didukung. Setiap URL yang dijajaki juga dapat secara opsional mengembalikan waktu kedaluwarsa dan nilai tag uniknya sendiri.
Menandai pemberitahuan untuk pembaruan berkala
Dengan antrean pemberitahuan diaktifkan, petak peta Anda dapat menelusuri maksimal lima pemberitahuan antrean. Umumnya, pemberitahuan terlama diganti dalam antrean saat pemberitahuan baru tiba. Namun, pemberitahuan dapat diberikan tag sehingga pemberitahuan baru dengan tag tertentu akan menggantikan pemberitahuan yang lebih lama dengan tag yang sama, terlepas dari tempatnya dalam antrean.
Tag adalah string opsional hingga 16 karakter yang dapat diatur pada pemberitahuan sebagai pengidentifikasi. Jika pemberitahuan baru tiba dengan tag yang sama dengan pemberitahuan yang sudah ada dalam antrean, pemberitahuan baru menggantikan pemberitahuan lama daripada berada di bawah perilaku antrean pertama masuk dan pertama keluar default. Ini mencegah kasus di mana dua versi pemberitahuan yang sama— salah satunya kedaluarsa— ada dalam antrean secara bersamaan.
Dalam kasus pemberitahuan berkala, tag disediakan di header X-WNS-Tag dari pesan respons HTTP pemberitahuan, yang juga menyertakan konten pemberitahuan. Pesan ini dikirim sebagai respons terhadap panggilan berkala sistem ke Pengidentifikasi Sumber Daya Seragam (URI) pemberitahuan. Nama header dan nilai tag tidak peka huruf besar/kecil.
Contoh diperlihatkan di sini:
X-WNS-Tag: stockMSFT
Mengatur waktu kedaluwarsa untuk pembaruan berkala
Pemberitahuan berkala kedaluwarsa secara default setelah tiga hari. Jika konten pemberitahuan Anda memiliki masa pakai yang berguna yang berbeda secara signifikan— lebih pendek atau lebih lama— Anda harus secara eksplisit mengatur waktu kedaluwarsa untuk setiap pemberitahuan. Ini mencegah konten kedaluwarsa atau tidak relevan agar tidak tersisa dalam antrean. Ini sangat penting jika komputer pengguna kehilangan konektivitas Internet untuk jangka waktu yang lama.
Misalnya, selama perdagangan aktif, disarankan bagi aplikasi saham untuk mengatur kedaluwarsa pada pemberitahuan harga saham menjadi dua kali lipat dari interval polling Anda, seperti pemberitahuan yang kedaluwarsa satu jam setelah dikirim jika Anda melakukan polling untuk pembaruan setiap setengah jam. Dalam kasus aplikasi berita, kedaluwarsa satu hari untuk petak peta yang menunjukkan berita harian teratas akan sesuai.
Untuk pemberitahuan berkala, waktu kedaluwarsa diatur di header X-WNS-Expires dari pesan respons HTTP pemberitahuan. Waktu kedaluwarsa dinyatakan sebagai tanggal HTTP, yang menggunakan salah satu format yang ditunjukkan dalam contoh ini:
- Minggu, 06 Nov 1994 08:49:37 GMT
- Minggu, 06-Nov-94 08:49:37 GMT
- Min Nov 6 08:49:37 1994
Untuk informasi selengkapnya tentang format tanggal HTTP, lihat dokumen Parameter Protokol World Wide Web Consortium (W3C) 3.
Untuk contoh implementasi lengkap pemberitahuan berkala yang digunakan bersama dengan antrean pemberitahuan, lihat Skenario 3 dalam sampel Pemberitahuan push dan berkala (diarsipkan).
Lihat juga
- StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)
- StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
- Cara menyiapkan pemberitahuan berkala untuk petak peta
- Panduan dan daftar periksa untuk pemberitahuan berkala
- Gambaran umum pemberitahuan petak dan petak peta
Berlaku untuk
StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)
Memulai serangkaian pembaruan berwakhir yang bersepeda pada petak yang terikat dengan updater. Konten pembaruan diambil dari array Pengidentifikasi Sumber Daya Seragam (URI) tertentu dengan pembaruan dimulai pada waktu yang ditentukan dan pembaruan berikutnya yang terjadi pada interval berkala setelahnya.
Catatan
Untuk menggunakan fitur ini, Anda harus terlebih dahulu mengaktifkan antrean pemberitahuan petak dengan memanggil EnableNotificationQueue.
public:
virtual void StartPeriodicUpdateBatch(IIterable<Uri ^> ^ tileContents, DateTime startTime, PeriodicUpdateRecurrence requestedInterval) = StartPeriodicUpdateBatch;
/// [Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatchAtTime")]
void StartPeriodicUpdateBatch(IIterable<Uri> const& tileContents, DateTime const& startTime, PeriodicUpdateRecurrence const& requestedInterval);
[Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatchAtTime")]
public void StartPeriodicUpdateBatch(IEnumerable<System.Uri> tileContents, System.DateTimeOffset startTime, PeriodicUpdateRecurrence requestedInterval);
function startPeriodicUpdateBatch(tileContents, startTime, requestedInterval)
Public Sub StartPeriodicUpdateBatch (tileContents As IEnumerable(Of Uri), startTime As DateTimeOffset, requestedInterval As PeriodicUpdateRecurrence)
Parameter
- tileContents
Array hingga lima Pengidentifikasi Sumber Daya Seragam (URI) tempat konten XML pembaruan petak peta bersepeda akan diambil. Jika array berisi lebih dari lima Pengidentifikasi Sumber Daya Seragam (URI), metode akan gagal.
- startTime
- DateTime DateTimeOffset
Waktu di mana Pengidentifikasi Sumber Daya Seragam (URI) awal harus terlebih dahulu dijajaki untuk konten baru.
- requestedInterval
- PeriodicUpdateRecurrence
Frekuensi di mana Pengidentifikasi Sumber Daya Seragam (URI) dijajaki untuk konten petak peta baru, mengikuti pembaruan awal pada startTime.
- Atribut
Keterangan
Menggunakan antrean pemberitahuan dengan pembaruan berkala
Untuk menggunakan antrean pemberitahuan, Anda harus terlebih dahulu mengaktifkannya untuk petak peta Anda dengan baris kode ini:
Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);
API ini hanya perlu dipanggil sekali dalam masa pakai aplikasi Anda, tetapi tidak ada salahnya memanggilnya setiap kali aplikasi diluncurkan.
Dalam kasus pemberitahuan berkala, URL unik disediakan untuk setiap pemberitahuan. Setiap URL dijajaki secara berkala oleh Windows untuk konten pemberitahuan yang diperbarui. Payload konten yang dikembalikan dari setiap URL harus berisi versi XML pemberitahuan untuk semua ukuran petak peta yang didukung. Setiap URL yang dijajaki juga dapat secara opsional mengembalikan waktu kedaluwarsa dan nilai tag uniknya sendiri.
Menandai pemberitahuan untuk pembaruan berkala
Dengan antrean pemberitahuan diaktifkan, petak peta Anda dapat menelusuri maksimal lima pemberitahuan antrean. Umumnya, pemberitahuan terlama diganti dalam antrean saat pemberitahuan baru tiba. Namun, pemberitahuan dapat diberikan tag sehingga pemberitahuan baru dengan tag tertentu akan menggantikan pemberitahuan yang lebih lama dengan tag yang sama, terlepas dari tempatnya dalam antrean.
Tag adalah string opsional hingga 16 karakter yang dapat diatur pada pemberitahuan sebagai pengidentifikasi. Jika pemberitahuan baru tiba dengan tag yang sama dengan pemberitahuan yang sudah ada dalam antrean, pemberitahuan baru menggantikan pemberitahuan lama daripada berada di bawah perilaku antrean pertama masuk dan pertama keluar default. Ini mencegah kasus di mana dua versi pemberitahuan yang sama— salah satunya kedaluarsa— ada dalam antrean secara bersamaan.
Dalam kasus pemberitahuan berkala, tag disediakan di header X-WNS-Tag dari pesan respons HTTP pemberitahuan, yang juga menyertakan konten pemberitahuan. Pesan ini dikirim sebagai respons terhadap panggilan berkala sistem ke Pengidentifikasi Sumber Daya Seragam (URI) pemberitahuan. Nama header dan nilai tag tidak peka huruf besar/kecil.
Contoh diperlihatkan di sini:
X-WNS-Tag: stockMSFT
Mengatur waktu kedaluwarsa untuk pembaruan berkala
Petak peta kedaluwarsa secara default setelah tiga hari. Jika konten pemberitahuan Anda memiliki masa pakai yang berguna yang berbeda secara signifikan— lebih pendek atau lebih lama— Anda harus secara eksplisit mengatur waktu kedaluwarsa untuk setiap pemberitahuan. Ini mencegah konten kedaluwarsa atau tidak relevan agar tidak tersisa dalam antrean. Ini sangat penting jika komputer pengguna kehilangan konektivitas Internet untuk jangka waktu yang lama.
Misalnya, selama perdagangan aktif, disarankan bagi aplikasi saham untuk mengatur kedaluwarsa pada pemberitahuan harga saham menjadi dua kali lipat dari interval polling Anda, seperti pemberitahuan yang kedaluwarsa satu jam setelah dikirim jika Anda melakukan polling untuk pembaruan setiap setengah jam. Dalam kasus aplikasi berita, kedaluwarsa satu hari untuk petak peta yang menunjukkan berita harian teratas akan sesuai.
Untuk pemberitahuan berkala, waktu kedaluwarsa diatur di header X-WNS-Expires dari pesan respons HTTP pemberitahuan. Waktu kedaluwarsa dinyatakan sebagai tanggal HTTP, yang menggunakan salah satu format yang ditunjukkan dalam contoh ini:
- Minggu, 06 Nov 1994 08:49:37 GMT
- Minggu, 06-Nov-94 08:49:37 GMT
- Min Nov 6 08:49:37 1994
Untuk informasi selengkapnya tentang format tanggal HTTP, lihat dokumen Parameter Protokol World Wide Web Consortium (W3C) 3.
Untuk contoh implementasi lengkap pemberitahuan berkala yang digunakan bersama dengan antrean pemberitahuan, lihat Skenario 3 dalam sampel Pemberitahuan push dan berkala (diarsipkan).
Lihat juga
- StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)
- StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
- Cara menyiapkan pemberitahuan berkala untuk petak peta
- Panduan dan daftar periksa untuk pemberitahuan berkala
- Gambaran umum pemberitahuan petak dan petak peta
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk