应用通知内容

应用通知是具有文本、图像和按钮/输入的灵活通知。 本文介绍可在应用通知中使用的 UI 元素,并提供用于生成应用通知的 XML 格式的代码示例。

Note

术语“toast 通知”将替换为“应用通知”。 这些术语都指的是 Windows 的相同功能,但随着时间的推移,我们将逐步取消在文档中使用“toast 通知”。

Getting started

应用通知是使用 由应用通知架构定义的 XML 有效负载定义的。 目前,有三种方法为应用通知生成 XML 有效负载。 本文中的代码示例演示了所有三种方法:

  • Microsoft.Windows.AppNotifications.Builder API - 在 Windows App SDK 1.2 中引入,此命名空间提供 API,使你可以轻松地以编程方式生成通知的 XML 有效负载,而无需担心 XML 格式的具体细节。 使用这些 API 的代码示例位于标记为“Windows 应用 SDK”的选项卡中。
  • Microsoft.Toolkit.Uwp.Notifications生成器语法 - 这些 API 是 UWP 社区工具包的一部分,为 UWP 应用提供支持。 尽管这些 API 还可用于 Windows 应用 SDK 应用,并继续受支持,但我们建议新实现使用 Microsoft.Windows.AppNotifications.Builder API。 若要使用社区工具包 API,请将 UWP 社区工具包通知 nuget 包 添加到项目中。 本文中提供的 C# 示例使用 NuGet 包的版本 7.0.0。 使用这些 API 的代码示例位于标记为“Windows 社区工具包”的选项卡中。
  • 原始 XML - 如果需要,可以创建自己的自定义代码,以按所需格式生成 XML 字符串。 原始 XML 示例位于标记为“XML”的选项卡中。

安装通知可视化工具。 此免费的 Windows 应用可帮助你设计交互式应用通知,方法是在编辑 Toast 时提供即时视觉预览,类似于 Visual Studio 的 XAML 编辑器/设计视图。 有关详细信息,请参阅 通知可视化工具 ,或 从应用商店下载通知可视化工具

本文仅介绍如何创建应用通知内容。 有关生成 XML 有效负载后发送通知的信息,请参阅 “发送本地应用通知”。

应用通知结构

应用通知 XML 数据负载中的一些重要的高级组件包括:

  • toast:此元素的 launch 属性定义了当用户单击 toast 时,将传递回你应用的参数。这使你能够进行深度链接到 toast 显示的正确内容。 若要了解详细信息,请参阅 “发送本地应用通知”。
  • 视觉对象:此元素表示 toast 的可视部分,包括包含文本和图像的泛型绑定。
  • 操作:该元素代表 toast 的交互部分,包括输入和操作。
  • 音频:此元素指定在向用户显示 toast 时播放的音频。
var builder = new AppNotificationBuilder()
    .AddArgument("conversationId", "9813")

    .AddText("Some text")

    .AddButton(new AppNotificationButton("Archive")
        .AddArgument("action", "archive"))

    .SetAudioUri(new Uri("ms-appx:///Sound.mp3"));

下面是应用通知内容的可视表示形式:

一份应用通知的屏幕截图,顶部显示应用图标和应用名称“Notifications Visualizer”的标签。Toast 的中间部分标记为视觉区域,其中包括三行文本。Toast 的底部部分标记为动作区域,包含两个按钮,分别标记为“接受”和“拒绝”。

Attribution area

属性区域位于应用通知的顶部。 从 Windows 11 开始,应用的名称和图标会显示在此区域中。 属性区域还包括一个关闭按钮,允许用户快速关闭通知和省略号菜单,允许用户快速禁用应用的通知或转到应用的通知的 Windows 设置页面。 归属区域由 shell 配置,无法覆盖在 toast XML 负载中,尽管您的应用可以将项目添加到归属区域上下文菜单中。 有关详细信息,请参阅 上下文菜单作

Visual

每个应用通知都必须指定一个 视觉对象 元素,其中必须提供一个通用 Toast 绑定,其中包含文本和图像。 这些元素将在各种 Windows 设备上呈现,包括桌面、手机、平板电脑和 Xbox。

有关 视觉 对象部分及其子元素支持的所有属性,请参阅 应用通知架构

Text elements

每个应用通知必须至少包含一个文本元素,并且可以包含另外两个文本元素,所有这些都是类型为 AdaptiveText

应用通知的屏幕截图包含三行文本。最上面的那行文本为粗体。

由于 Windows 10 周年更新,你可以使用文本上的 HintMaxLines 属性控制显示的文本行数。 默认(和最大值)标题最多为 2 行文本,两个附加描述元素(第二个和第三个 AdaptiveText)组合最多为 4 行。

var builder = new AppNotificationBuilder()
    .AddArgument("conversationId", 9813)
    .AddText("Adaptive Tiles Meeting", new AppNotificationTextProperties().SetMaxLines(1))
    .AddText("Conf Room 2001 / Building 135")
    .AddText("10:00 AM - 10:30 AM");

Inline image

默认情况下,图像在任意文本元素之后内联显示,填充视觉区域的完整宽度。

一张应用通知的屏幕截图,显示默认图像内联放置,填满了视觉区域的整个宽度。

var builder = new AppNotificationBuilder()
    .AddText("Featured image of the day.")
    .SetInlineImage(new Uri("ms-appx:///Images/InlineImage.png"));

AppNotificationManager.Default.Show(builder.BuildNotification());

应用徽标替代

指定“appLogoOverride”的 定位 值将使图像显示在可视区域左侧的正方形中。 此属性的名称反映了早期版本的 Windows 中的行为,其中图像将替换默认应用徽标图像。 在 Windows 11 中,应用徽标显示在署名区域中,因此它不会被 appLogoOverride 图像位置覆盖。

图像尺寸为 48x48 像素,以 100% 缩放。 我们通常建议为每个缩放因子提供每个图标资产的版本:100%、125%、150%、200%和 400%。

应用通知的屏幕截图,显示了应用徽标被覆盖图像的位置在通知视觉区域左侧的一个正方形中。

var builder = new AppNotificationBuilder()
    .AddText("Featured image of the day.")
    .SetAppLogoOverride(new Uri("ms-appx:///Images/AppLogo.png"));

Hint crop

Microsoft样式指南建议使用圆形图像来表示个人资料照片,以在不同应用和界面中提供一致的人物展示。 将 HintCrop 属性设置为 圆形 来呈现圆形裁剪的图像。

应用通知的截图,显示应用程序徽标的图像被裁剪成圆形并放置于提示框视觉区域的左侧。

var builder = new AppNotificationBuilder()
    .AddText("Matt sent you a friend request")
    .AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
    .SetAppLogoOverride(new Uri("ms-appx:///Images/Profile.png"), AppNotificationImageCrop.Circle);

Hero image

周年更新中的新内容:应用通知可以显示一张主图,这是一个特色 ToastGenericHeroImage ,在 Toast 横幅和通知中心中都被突出显示。 图像尺寸为 364x180 像素,缩放比例为 100%。

一个应用通知的屏幕截图,展示了主图的放置位置,上方是归属区域。

var builder = new AppNotificationBuilder()
    .AddText("Marry Anne")
    .AddText("Check out where we camped last night!")
    .SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"));

图像大小限制

在 Toast 通知中使用的图像可以从...

  • http://
  • ms-appx:///
  • ms-appdata:///

对于 http 和 https 远程 Web 映像,每个图像的文件大小有限制。 在 Fall Creators Update (16299)中,我们在正常连接上将限制增加到 3 MB,在按流量计费的连接上为 1 MB。 在此之前,图像始终限制为 200 KB。

Normal connection Metered connection Fall Creators Update 之前
3 MB 1 MB 200 KB

如果图像超过文件大小限制、无法下载或超时,图像将被删除,通知的其余部分将显示。

Attribution text

周年更新中的新增功能:如果需要引用内容的源,可以使用引用文本。 此文本始终显示在任何文本元素下方,但高于内联图像。 文本使用比标准文本元素稍小一些的大小来帮助区分常规文本元素。

在不支持标注文本的较早版本的 Windows 中,文本将会简单地显示为另一个文本元素(前提是您还没有达到三个文本元素的限制)。

一张 Toast 通知的屏幕截图,显示在视觉区域中其他文本行下方的归属文本为“通过短信”。

var builder = new AppNotificationBuilder()
    .AddText("Marry Anne")
    .AddText("Check out where we camped last night!")
    .SetAttributionText("via SMS");
    .SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"));

Custom timestamp

创意者更新中的新增功能:现在可以使用自己的时间戳替代系统提供的时间戳,该时间戳准确表示生成消息/信息/内容的时间。 此时间戳在通知中心内可见。

通知中心中带有自定义时间戳的通知的屏幕截图

若要详细了解如何使用自定义时间戳,请参阅 toast上的自定义时间戳

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));

Progress bar

创意者更新中的新增功能:可以在应用通知上提供进度栏,让用户了解下载等作的进度。

一张显示进度栏的 Toast 通知的屏幕截图。

若要了解有关使用进度栏的详细信息,请参阅 Toast 进度栏

Headers

创作者更新的新增功能:您可以在通知中心中将通知按标题进行分组。 例如,您可以在一个标题下将群聊中的消息进行分组,或在一个标题下按常见主题将通知进行分组,还可以有更多方式。

一张操作中心的截图,显示了应用程序“通知查看器”的多个通知,这些通知被归类在一个标记为“露营!”的标题下。

若要详细了解如何使用标头,请参阅 Toast 标头

Adaptive content

周年更新中的新增功能:除了上面指定的内容外,还可以显示扩展 Toast 时可见的其他自适应内容。

此附加内容是使用 Adaptive 指定的,可以通过阅读 自适应磁贴文档了解详细信息。

请注意,任何自适应内容都必须包含在 AdaptiveGroup 中。 否则,它不会以自适应的方式呈现。

列和文本元素

下面是使用列和一些高级自适应文本元素的示例。 由于文本元素位于 AdaptiveGroup 中,因此它们支持所有丰富的自适应样式属性。

Toast 通知的屏幕截图,其中显示了与 Toast 视觉区域左侧和右侧对齐的文本元素组。

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support adaptive text elements.

Buttons

按钮使 Toast 交互,让用户在应用通知上快速执行作,而不会中断其当前工作流。 例如,用户可以直接从 Toast 内回复邮件,或删除电子邮件,甚至无需打开电子邮件应用。 按钮会出现在通知栏的展开部分。

若要详细了解如何进行“端到端”按钮实现,请参阅 发送本地通知

按钮可以通过以下方式激活应用:

  • 应用在前台激活,其中包含可用于导航到特定页面/上下文的参数。
  • 另一个应用通过协议启动激活。
  • UWP 应用明确支持后台激活。 对于 Windows 应用 SDK 应用,应用始终在前台启动。 应用可以调用 AppInstance.GetActivatedEventArgs 来检测激活是否由通知启动,并从传递的参数中确定是完全启动前台应用还是只处理通知和退出。
  • UWP 应用和 Windows 应用 SDK 都支持系统操作(例如推迟或忽略通知)。 AppNotificationBuilder API 不支持此方案,但 Windows 应用 SDK 应用可以使用 Microsoft.Windows.AppNotifications.Builder API 或原始 XML 实现此方案。

Note

最多只能有 5 个按钮(包括稍后讨论的上下文菜单项)。

Toast通知的屏幕截图,显示了一行文本,后面是一行,其中的两个按钮由操作元素组成。

new ToastContentBuilder()
    var builder = new AppNotificationBuilder()
        .AddText("New product in stock!")
        .AddButton(new AppNotificationButton("See more details")
            .AddArgument("action", "viewDetails"))
            .AddArgument("contentId", "351")
        .AddButton(new AppNotificationButton("Remind me later")
            .AddArgument("action", "remindLater"))
            .AddArgument("contentId", "351");

带有图标的按钮

你可以向按钮添加图标。 这些图标是白色透明 16x16 像素图像,以 100% 缩放,并且不应在图像本身中包含填充。 如果选择在 Toast 通知上提供图标,则必须为通知中的所有按钮提供图标,因为它将按钮的样式转换为图标按钮。

Note

为了提高可访问性,请确保包括图标的白色对比版本(适用于白色背景的黑色图标),以便在用户启用高对比度白色模式时,你的图标依然可见。 有关详细信息,请参阅 磁贴和 toast 通知支持的语言、缩放和高对比度

使用带有图标的按钮的应用通知的屏幕截图。

new ToastContentBuilder()
    var builder = new AppNotificationBuilder()
        .AddText("Return books to the library.")
        .AddButton(new AppNotificationButton("Accept")
            .AddArgument("action", "accept")
            .SetIcon(new Uri("ms-appx:///Images/Accept.png")))
        .AddButton(new AppNotificationButton("Snooze")
            .AddArgument("action", "snooze")
            .SetIcon(new Uri("ms-appx:///Images/Snooze.png")))
        .AddButton(new AppNotificationButton("Dismiss")
            .AddArgument("action", "dismiss")
            .SetIcon(new Uri("ms-appx:///Images/Dismiss.png")));

Windows 11 更新中的新功能:您可以使用 XML 中的 HintToolTip 属性为您的图标添加工具提示。 如果你的按钮具有图标,但没有内容,这是理想的选择,因为这样可以确保你可以传递 Windows 讲述人可以阅读的文本。 但是,如果存在内容,则无论在工具提示中传递什么内容,讲述人都会读取内容。

var button = new AppNotificationButton("Reply")
    .AddArgument("action", "reply");

if (AppNotificationButton.IsToolTipSupported())
{
    button.ToolTip = "Click to reply.";
}

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .AddButton(button); 

带有颜色的按钮

Windows 11 更新中的新功能:您可以通过将 useButtonStyle 属性添加到 toast XML 元素,以及将 hint-buttonStyle 属性添加到 action XML 元素,来为按钮添加红色或绿色颜色,如下所示。

包含三个按钮的通知的屏幕截图,左侧的两个按钮为绿色,带有用于启动视频呼叫或启动音频呼叫的图标。第三个按钮为红色,具有拒绝呼叫的图标。

var builder = new AppNotificationBuilder()
    .SetScenario(AppNotificationScenario.IncomingCall)
    .AddText("Andrew Bares", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .AddText("Incoming Call - Mobile", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .SetInlineImage(new Uri("ms-appx:///Images/Profile.png"),
        AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton()
        .SetToolTip("Answer Video Call")
        .SetButtonStyle(AppNotificationButtonStyle.Success)
        .SetIcon(new Uri("ms-appx:///Images/Video.png"))
        .AddArgument("videoId", "123"))
    .AddButton(new AppNotificationButton()
        .SetToolTip("Answer Phone Call")
        .SetButtonStyle(AppNotificationButtonStyle.Success)
        .SetIcon(new Uri("ms-appx:///Images/Call.png"))
        .AddArgument("callId", "123"))
    .AddButton(new AppNotificationButton()
        .SetToolTip("Hang Up")
        .SetButtonStyle(AppNotificationButtonStyle.Critical)
        .SetIcon(new Uri("ms-appx:///Images/HangUp.png"))
        .AddArgument("hangUpId", "123"));

上下文菜单操作

周年更新中的新功能:您可以将其他上下文菜单操作添加到用户右键单击通知弹窗或选择上下文菜单图标时出现的现有上下文菜单中。

Note

在较旧的设备上,这些附加的上下文菜单作只会显示为通知上的正常按钮。

添加的其他上下文菜单作(如“1 小时静音群组聊天”)显示在两个默认系统条目上方。

吐司与上下文菜单

var builder = new AppNotificationBuilder()
    .AddText("Camping this weekend?")
    .SetAppLogoOverride(new Uri("ms-appx:///images/Reply.png"), AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton("Mute group chat for 1 hour")
        .AddArgument("action", "mute")
        .SetContextMenuPlacement());

Note

附加的上下文菜单项包含在 Toast 上最多允许的 5 个按钮中。

其他上下文菜单项的激活处理方式与 Toast 按钮相同。

Inputs

输入在应用通知的 操作 区中指定,这意味着这些输入仅在通知展开时可见。

快速答复文本框

若要启用快速答复文本框(例如,在消息应用中),请添加文本输入和按钮,并引用文本输入字段的 ID,以便按钮显示在输入字段旁边。 按钮的可选图标(如果提供)应为 32x32 像素图像,且不填充、白色像素设置为透明,以及 100 个% 刻度。

包含个人资料图片和某些文本行的 Toast 通知的屏幕截图。包含用于直接键入 Toast 的文本框以及用于发送答复的按钮。

var builder = new AppNotificationBuilder()
    .AddTextBox("textBox", "Type a reply", "Reply")
    .AddButton(AppNotificationButton("Send")
        .AddArguments("action", "Send")
        .SetInputId("textBox"))
    .BuildNotification();

带有按钮栏的输入框

还可以有一个(或多个)输入,其中普通按钮显示在输入下方。

应用通知的屏幕截图,其中显示了一行文本、一个文本框和一行,其中两个按钮标记为“回复”和“视频呼叫”。

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support quick reply text boxes.

Selection input

除了文本框,还可以使用选择菜单。

应用通知的屏幕截图,其中显示了一行文本、一个选择输入,其中“午餐”作为选定项,以及一行,其中包含两个标记为“保留”和“呼叫餐厅”的按钮。

var builder = new AppNotificationBuilder()
    .AddText("4th coffee?")
    .AddText("When do you plan to come in tomorrow?")
    .AddComboBox(new AppNotificationComboBox("time")
        .SetTitle("Select an item:")
        .AddItem("breakfast", "Breakfast")
        .AddItem("lunch", "Lunch")
        .AddItem("dinner", "Dinner")
        .SetSelectedItem("lunch"))
    .AddButton(new AppNotificationButton("Reply")
        .AddArgument("action", "reply")
        .AddArgument("threadId", "9218")
        .SetContextMenuPlacement())
    .AddButton(new AppNotificationButton("Call restaurant")
        .AddArgument("action", "videocall")
        .AddArgument("threadId", "9218")
        .SetContextMenuPlacement());

Snooze/dismiss

使用选择菜单和两个按钮,我们可以创建一个利用系统暂停和消除操作的提醒通知。 请确保将场景设置为“提醒”,这样通知的行为就像提醒一样。

一个应用程序通知的屏幕截图,其中包含描述会议时间和位置的文本行。选择框中选择了“15 分钟”,并且有标记为“稍后提醒”和“忽略”的按钮。

我们使用 toast 按钮上的 SelectionBoxId 属性将“推迟”按钮链接到选择菜单输入。

Microsoft.Windows.AppNotifications.Builder 语法当前不支持系统激活。 但 Windows 应用 SDK 应用支持此方案,你可以使用 API 或原始 XML 生成此方案的 Microsoft.Toolkit.Uwp.Notifications 通知。

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support system activation. 
// But this scenario is supported for Windows App SDK apps, and you can build notifications for this 
// scenario using the `Microsoft.Toolkit.Uwp.Notifications` APIs or raw XML.

若要使用系统暂停和消除操作,请执行以下操作:

  • 指定 ToastButtonSnoozeToastButtonDismiss
  • (可选)指定自定义内容字符串:
  • 如果未提供字符串,我们将自动将本地化字符串用于“暂停”和“消除”。
  • (可选)指定 SelectionBoxId
  • 如果你不希望用户选择延迟间隔,而只是希望通知只在整个系统中一致的系统定义的时间间隔里延迟一次,那么就不要构造任何 <输入>。
  • 如果想提供打盹间隔选择:- 在打盹操作中指定 SelectionBoxId - 将输入的 ID 与打盹操作的 SelectionBoxId 匹配 - 指定 ToastSelectionBoxItem的值,该值须是非负整数,表示打盹间隔(以分钟为单位)。

Audio

自定义音频始终受移动版支持,并在桌面版 1511(内部版本 10586)或更高版本中受支持。 可以通过以下路径引用自定义音频:

  • ms-appx:///
  • ms-appdata:///
var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"));

或者,您可以从 列表中的 ms-winsoundevents进行选择,这些项目在两个平台上一直都受支持。

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioEvent(AppNotificationSoundEvent.Alarm, AppNotificationAudioLooping.Loop);

有关应用通知中的音频的信息,请参阅 音频架构页 。 若要了解如何发送使用自定义音频的应用通知,请参阅在 toast上 自定义音频。

Scenarios

为了创建重要的通知、警报、提醒和来电通知,只需使用一个普通应用通知,并为其分配一个 场景 值。 此方案调整了一些行为,以创建一致的统一用户体验。 有四种可能的 方案 值:

  • Reminder
  • Alarm
  • IncomingCall
  • Urgent

Reminders

在提醒方案中,通知将保持在屏幕上,直到用户将其关闭或采取作。 在 Windows Mobile 上,应用通知还会显示预扩展。 将播放提醒声音。 必须在应用通知上至少提供一个按钮。 否则,通知将被视为普通通知。

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetScenario(AppNotificationScenario.Reminder);

Alarms

警报的行为与提醒相同,但警报将额外循环使用默认警报声音的音频。 必须在应用通知上至少提供一个按钮。 否则,通知将被视为普通通知。

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetScenario(AppNotificationScenario.Alarm)
    .AddButton(new AppNotificationButton("Dismiss")
        .AddArgument("action", "dismiss"));

Incoming calls

传入呼叫通知以特殊呼叫格式预先显示,并停留在用户的屏幕上,直到关闭。 默认情况下,铃声音频将循环。 在 Windows 移动版设备上,它们全屏显示。

来电弹出通知

var builder = new AppNotificationBuilder()
    .SetScenario(AppNotificationScenario.IncomingCall)
    .AddText("Andrew Bares", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
    .AddText("incoming call - mobile", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .SetInlineImage(new Uri("ms-appx:///images/profile.png"),
        AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton("Text reply")
        .SetToolTip("Text reply")
        .SetIcon(new Uri("ms-appx:///images/reply.png"))
        .AddArgument("textId", "123"))
    .AddButton(new AppNotificationButton("Reminder")
        .SetToolTip("Reminder")
        .SetIcon(new Uri("ms-appx:///images/reminder.png"))
        .AddArgument("reminderId", "123"))
    .AddButton(new AppNotificationButton("Ignore")
        .SetToolTip("Ignore")
        .SetIcon(new Uri("ms-appx:///images/ignore.png"))
        .AddArgument("ignoreId", "123"))
    .AddButton(new AppNotificationButton("Answer")
        .SetToolTip("Answer")
        .SetIcon(new Uri("ms-appx:///images/answer.png"))
        .AddArgument("answerId", "123"));

Important Notifications

Important

需要:必须运行 Windows Insider Preview 内部版本 22546 或更高版本才能使用重要通知。

重要通知使用户能够更好地控制哪些第一方和第三方应用可以向他们发送高优先级的应用通知(紧急/重要),这些通知能够突破专注模式(请勿打扰)。 这可以在通知设置中修改。

紧急应用通知的屏幕截图,该通知在应用名称旁边的属性区域中有感叹号。该图像还显示系统启动的应用通知,该通知为用户提供允许或禁止来自应用的紧急通知的按钮。

var builder = new AppNotificationBuilder()
    .AddText("Adaptive Tiles Meeting", 
        new AppNotificationTextProperties()
            .SetMaxLines(1))
    .AddText("Conf Room 2001 / Building 135")
    .AddText("10:00 AM - 10:30 AM");

if (AppNotificationBuilder.IsUrgentScenarioSupported())
{
    builder.SetScenario(AppNotificationScenario.Urgent);
}

本地化和可访问性

磁贴和应用通知可以加载为显示语言、显示比例系数、高对比度和其他运行时上下文定制的字符串和图像。 有关详细信息,请参阅 磁贴和 toast 通知支持语言、缩放和高对比度

Handling activation

若要了解如何处理应用激活(用户单击通知提醒或提醒上的按钮),请参阅 发送本地通知提醒。