Tanda waktu kustom pada pemberitahuan aplikasi

  • Artikel

Secara default, tanda waktu pada pemberitahuan aplikasi, yang terlihat dalam Pusat Pemberitahuan, diatur ke waktu pemberitahuan dikirim. Anda dapat secara opsional mengambil alih tanda waktu dengan tanggal dan waktu kustom Anda sendiri, sehingga tanda waktu mewakili waktu pesan/informasi/konten benar-benar dibuat, bukan waktu pemberitahuan dikirim. Ini juga memastikan bahwa pemberitahuan Anda muncul dalam urutan yang benar dalam Pusat Pemberitahuan, yang diurutkan menurut waktu. Sebaiknya sebagian besar aplikasi menentukan tanda waktu kustom.

Fitur ini tersedia di Windows Build 15063 dan yang lebih baru.

App notification with custom timestamp

Catatan

Istilah "pemberitahuan toast" sedang diganti dengan "pemberitahuan aplikasi". Istilah-istilah ini keduanya merujuk ke fitur Windows yang sama, tetapi seiring waktu kami akan mengeluarkan fase penggunaan "pemberitahuan toast" dalam dokumentasi.

Untuk menggunakan tanda waktu kustom, cukup tetapkan properti displayTimestamp pada elemen toast payload XML pemberitahuan aplikasi Anda. Dimulai dengan SDK Aplikasi Windows 1.2, Anda dapat menambahkan tanda waktu kustom ke pemberitahuan aplikasi dengan Microsoft.Windows.AppNotifications.Builder. Untuk aplikasi UWP, Anda dapat menggunakan versi 1.4.0 atau yang lebih baru dari pustaka NuGet Pemberitahuan Komunitas UWP. Anda juga menentukan tanda waktu menggunakan xml mentah.

var builder = new AppNotificationBuilder()
    .AddText("Matt sent you a friend request")
    .AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
    .SetTimeStamp(new DateTime(2017, 04, 15, 19, 45, 00, DateTimeKind.Utc));

Jika Anda menggunakan XML, tanggal harus diformat dalam ISO 8601.

Catatan

Anda hanya dapat menggunakan paling banyak 3 tempat desimal pada detik (meskipun secara realistis tidak ada nilai dalam memberikan apa pun yang terperinci). Jika Anda memberikan lebih banyak, payload akan tidak valid dan Anda akan menerima pemberitahuan "Pemberitahuan baru".

Panduan penggunaan

Secara umum, sebaiknya sebagian besar aplikasi menentukan tanda waktu kustom. Ini memastikan bahwa tanda waktu pemberitahuan secara akurat mewakili ketika pesan/informasi/konten dihasilkan, terlepas dari keterlambatan jaringan, mode pesawat, atau interval tetap tugas latar belakang berkala.

Misalnya, aplikasi berita mungkin menjalankan tugas latar belakang setiap 15 menit yang memeriksa artikel baru dan menampilkan pemberitahuan. Sebelum tanda waktu kustom, tanda waktu sesuai dengan kapan pemberitahuan aplikasi dihasilkan (oleh karena itu selalu dalam interval 15 menit). Namun, sekarang aplikasi dapat mengatur tanda waktu ke waktu artikel benar-benar diterbitkan. Demikian pula, aplikasi email dan aplikasi jejaring sosial dapat memperoleh manfaat dari fitur ini jika pola serupa penarikan berkala digunakan untuk pemberitahuan mereka.

Selain itu, menyediakan tanda waktu kustom memastikan bahwa tanda waktu sudah benar meskipun pengguna terputus dari internet. Misalnya, ketika pengguna mengaktifkan komputer mereka dan tugas latar belakang Anda berjalan, Anda akhirnya dapat memastikan bahwa tanda waktu pada pemberitahuan Anda mewakili waktu pesan dikirim, bukan waktu pengguna menyalakan komputer mereka.

Tanda waktu default

Jika Anda tidak memberikan tanda waktu kustom, kami menggunakan waktu pemberitahuan Anda dikirim.

Jika Anda mengirim pemberitahuan push melalui WNS, kami menggunakan waktu ketika pemberitahuan diterima oleh server WNS (sehingga latensi apa pun pada pengiriman pemberitahuan ke perangkat tidak akan memengaruhi tanda waktu).

Jika Anda mengirim pemberitahuan lokal, kami menggunakan waktu ketika platform pemberitahuan menerima pemberitahuan (yang seharusnya segera).