Koleksi pemberitahuan aplikasi

Gunakan koleksi untuk mengatur pemberitahuan aplikasi Anda di Pusat Pemberitahuan. Koleksi membantu pengguna menemukan informasi dengan lebih mudah dan memungkinkan pengembang mengelola pemberitahuan mereka dengan lebih baik.

Aplikasi olahpesan, misalnya, dapat memisahkan pemberitahuan menurut grup obrolan. Setiap judul grup ("Comp Sci 160A Project Chat", "Direct Messages", "Lacrosse Team Chat") adalah koleksi terpisah. Pemberitahuan dikelompokkan seolah-olah berasal dari aplikasi terpisah, meskipun semuanya berasal dari aplikasi yang sama. Untuk cara yang lebih halus untuk mengatur pemberitahuan, lihat Header pemberitahuan aplikasi.

Nota

Contoh kode dalam artikel ini menggunakan namespace Microsoft.Windows.AppNotifications untuk membangun konten pemberitahuan dan namespace Windows.UI.Notifications untuk manajemen koleksi. Kedua namespace ini dapat digunakan bersama-sama di aplikasi yang sama.

Untuk informasi selengkapnya tentang pemberitahuan aplikasi, lihat Ringkasan pemberitahuan aplikasi.

Membuat kumpulan

Saat membuat koleksi, berikan nama tampilan dan ikon, yang ditampilkan di Pusat Pemberitahuan sebagai bagian dari judul koleksi. Koleksi juga memerlukan argumen peluncuran sehingga aplikasi Anda dapat menavigasi ke lokasi yang tepat saat pengguna mengklik judul koleksi. Buat koleksi dengan memanggil SaveToastCollectionAsync.

using Windows.UI.Notifications;

var collection = new ToastCollection(
    "MyToastCollection",
    "Work Email",
    "NavigateToWorkEmailInbox",
    new Uri("ms-appx:///Assets/workEmail.png"));

await ToastNotificationManager.GetDefault()
    .GetToastCollectionManager()
    .SaveToastCollectionAsync(collection);

Mengirim pemberitahuan ke koleksi

Gunakan AppNotificationBuilder untuk membuat konten pemberitahuan, lalu panggil GetToastNotifierForToastCollectionIdAsync untuk mendapatkan pemberitahuan yang terlingkup ke koleksi.

using Microsoft.Windows.AppNotifications.Builder;
using Windows.UI.Notifications;
using Windows.Data.Xml.Dom;

// Build notification content with Windows App SDK
var payload = new AppNotificationBuilder()
    .AddText("Adam sent a message to the group")
    .BuildNotification()
    .Payload;

// Deliver to a collection using the WinRT API
var doc = new XmlDocument();
doc.LoadXml(payload);
var toast = new ToastNotification(doc);

var notifier = await ToastNotificationManager.GetDefault()
    .GetToastNotifierForToastCollectionIdAsync("MyToastCollection");
notifier.Show(toast);

Mencantumkan semua koleksi

Ambil semua koleksi yang dibuat untuk aplikasi Anda dengan memanggil FindAllToastCollectionsAsync.

var collectionManager = ToastNotificationManager.GetDefault().GetToastCollectionManager();
var collections = await collectionManager.FindAllToastCollectionsAsync();

Memperbarui koleksi

Perbarui koleksi dengan membuat instans ToastCollection baru dengan ID yang sama dan memanggil SaveToastCollectionAsync.

var collectionManager = ToastNotificationManager.GetDefault().GetToastCollectionManager();

var updatedCollection = new ToastCollection(
    "MyToastCollection",
    "Updated Display Name",
    "UpdatedLaunchArgs",
    new Uri("ms-appx:///Assets/updatedPicture.png"));

await collectionManager.SaveToastCollectionAsync(updatedCollection);

Menghapus koleksi

Hapus koleksi dengan memanggil RemoveToastCollectionAsync dengan ID koleksi. Pemberitahuan apa pun dalam koleksi juga dihapus dari Pusat Pemberitahuan.

var collectionManager = ToastNotificationManager.GetDefault().GetToastCollectionManager();
await collectionManager.RemoveToastCollectionAsync("MyToastCollection");

Menghapus pemberitahuan dalam koleksi

Gunakan properti Tag dan Grup untuk mengidentifikasi dan menghapus pemberitahuan individual dalam koleksi dengan memanggil Hapus, atau hapus semua pemberitahuan sekaligus dengan Hapus.

var collectionHistory = await ToastNotificationManager.GetDefault()
    .GetHistoryForToastCollectionAsync("MyToastCollection");

// Remove a specific notification
collectionHistory.Remove(tag, group);

// Or clear all notifications in the collection
collectionHistory.Clear();

Baca juga

• Gambaran umum pemberitahuan aplikasi