使用集合对 Toast 通知进行分组

使用集合在操作中心组织应用的 Toast。 集合可帮助用户更轻松地在操作中心中找到信息，并允许开发人员更好地管理其通知。 下面的 API 允许删除、创建和更新通知集合。

可以使用消息应用查看以下示例，该应用基于聊天组分隔通知;每个游戏（Comp Sci 160A 项目聊天、直接消息、棍网球团队聊天）都是一个单独的集合。 请注意通知的分组方式，就像它们来自单独的应用一样，即使它们都是来自同一应用的所有通知。 如果你正在寻找一种更微妙的方式来组织通知，请参阅 Toast 标头。

创建集合

创建每个集合时，需要提供显示名称和图标，该图标显示在操作中心作为集合标题的一部分，如下图所示。 集合还需要启动参数，以帮助应用在用户单击集合标题时导航到应用内的正确位置。

创建集合

// Create a toast collection
public async void CreateToastCollection()
{
	string displayName = "Work Email"; 
	string launchArg = "NavigateToWorkEmailInbox"; 
	Uri icon = new Windows.Foundation.Uri("ms-appx:///Assets/workEmail.png");

	// Constructor
	ToastCollection workEmailToastCollection = new ToastCollection(
		"MyToastCollection", 
		displayName,
 		launchArg, 
		icon);

	// Calls the platform to create the collection
	await ToastNotificationManager.GetDefault().GetToastCollectionManager().SaveToastCollectionAsync(workEmailToastCollection);  								
}

向集合发送通知

我们将介绍从三个不同的 Toast 管道发送通知：本地、计划和推送。 对于上述每个示例，我们将创建一个示例 Toast，以便紧随下面的代码一起发送，然后我们将重点介绍如何通过每个管道将 Toast 添加到集合。

构造 toast 内容：

// Construct the content
var content = new ToastContentBuilder()
	.AddText("Adam sent a message to the group")
	.GetToastContent();

将 Toast 发送到集合

// Create the toast
ToastNotification toast = new ToastNotification(content.GetXml());

// Get the collection notifier
var notifier = await ToastNotificationManager.GetDefault().GetToastNotifierForToastCollectionIdAsync("MyToastCollection");

// And show the toast
notifier.Show(toast);

将计划的 Toast 添加到集合

// Create scheduled toast from XML above
ScheduledToastNotification scheduledToast = new ScheduledToastNotification(content.GetXml(), DateTimeOffset.Now.AddSeconds(10));

// Get notifier
var notifier = await ToastNotificationManager.GetDefault().GetToastNotifierForToastCollectionIdAsync("MyToastCollection");
    
// Add to schedule
notifier.AddToSchedule(scheduledToast);

将推送 Toast 发送到集合

对于推送 Toast，需要将 X-WNS-CollectionId 标头添加到 POST 消息。

// Add header to HTTP request
request.Headers.Add("X-WNS-CollectionId", collectionId); 

管理集合

创建 Toast 集合管理器

对于此“管理集合”部分中的其余代码片段，我们将使用以下 collectionManager。

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

获取所有集合

IReadOnlyList<ToastCollection> collections = await collectionManager.FindAllToastCollectionsAsync();

获取创建的集合数

int toastCollectionCount = (await collectionManager.FindAllToastCollectionsAsync()).Count;

删除集合

await collectionManager.RemoveToastCollectionAsync("MyToastCollection");

更新集合

可以通过创建具有相同 ID 的新集合并保存集合的新实例来更新集合。

string displayName = "Updated Display Name"; 
string launchArg = "UpdatedLaunchArgs"; 
Uri icon = new Windows.Foundation.Uri("ms-appx:///Assets/updatedPicture.png");

// Construct a new toast collection with the same collection id
ToastCollection updatedToastCollection = new ToastCollection(
	"MyToastCollection", 
	displayName,
	launchArg, 
	icon);

// Calls the platform to update the collection by saving the new instance
await collectionManager.SaveToastCollectionAsync(updatedToastCollection);  								

管理集合中的 Toast

组和标记属性

组和标记属性一起唯一标识集合中的通知。 组（和标记）充当复合主键（多个标识符）来标识通知。 例如，如果要删除或替换通知，则必须能够指定 要删除/替换的通知 ;可以通过指定标记和组来执行此操作。 例如，消息应用。 开发人员可以使用对话 ID 作为组，并将消息 ID 用作标记。

从集合中删除 Toast

可以使用标记和组 ID 删除单个 Toast，或者清除集合中的所有 Toast。

// Get the history
var collectionHistory = await ToastNotificationManager.GetDefault().GetHistoryForToastCollectionAsync("MyToastCollection");

// Remove toast
collectionHistory.Remove(tag, group); 

清除集合中的所有 Toast

// Get the history
var collectionHistory = await ToastNotificationManager.GetDefault().GetHistoryForToastCollectionAsync("MyToastCollection");

// Remove toast
collectionHistory.Clear();

通知可视化工具中的集合

可以使用 通知可视化工具 来帮助设计集合。 请遵循以下步骤：

• 单击右下角的齿轮图标。
• 选择“Toast 集合”。
• 在 Toast 预览版上方，有一个“Toast 集合”下拉菜单。 选择“管理集合”。
• 单击“添加集合”，填写集合的详细信息，然后保存。
• 可以添加更多集合，或单击“管理集合”框以返回到主屏幕。
• 从“Toast 集合”下拉菜单中选择要将 Toast 添加到的集合。
• 触发 Toast 时，它将添加到操作中心中的相应集合。

其他详细信息

你创建的 Toast 集合也将反映在用户的通知设置中。 用户可以切换每个集合的设置，以打开或关闭这些子组。 如果在应用的顶级关闭通知，则所有集合通知也将关闭。 此外，每个集合默认在操作中心显示 3 个通知，用户可以将其展开以显示最多 20 个通知。

相关主题

• Toast 内容
• Toast 标头
• GitHub 上的通知库（Windows 社区工具包的一部分）