[ 本文适用于编写 Windows 运行时应用的 Windows 8.x 和 Windows Phone 8.x 开发人员。如果你要针对 Windows 10 进行开发,请参阅 最新文档 ]
本主题介绍如何使你的应用在锁屏上显示锁屏提醒和磁贴通知。 请注意,向锁屏发送通知时不需要执行特殊过程。锁屏上显示的通知与“开始”屏幕上显示的通知相同。Toast 通知显示在锁屏上,且不带有任何特殊设置。
先决条件
要理解本主题,你需要:
- 了解磁贴和通知术语及概念。有关详细信息,请参阅磁贴、锁屏提醒以及通知。
- 熟悉磁贴 XML 架构。有关详细信息,请参阅磁贴架构。
- 能够使用 Windows 运行时 API 创建使用 JavaScript 的基本 Windows 应用商店应用。有关详细信息,请参阅创建第一个采用 JavaScript 的 Windows 应用商店应用。
- 你的应用的一个现有默认磁贴(在你的应用清单中定义)。有关详细信息,请参阅快速入门:使用 Microsoft Visual Studio 清单编辑器创建默认磁贴。
- 熟悉 XML 及其通过文档对象模型 (DOM) API 的操作。
说明
1. 声明应用的锁屏状态类型
锁屏功能在应用的 package.appxmanifest 文件中声明。如果使用 Visual Studio 清单编辑器,则仅需选择“应用程序”选项卡中相应的“锁屏通知”****选项。
以下示例演示了作为选择此选项的结果插入到 package.appxmanifest 文件中的 XML。将 LockScreen 元素添加为清单的 VisualElements 元素的子节点。
此处所示的 XML 也是在 Visual Studio 之外直接创建 package.appxmanifest 文件时要使用的内容。有关详细信息,请参阅如何手动创建包清单。
<VisualElements
...
<LockScreen Notification="badge" BadgeLogo="images\logo-lockscreen.png"/>
...
</VisualElements>
<VisualElements
...
<LockScreen Notification="badgeAndTileText" BadgeLogo="images\logo-lockscreen.png"/>
...
</VisualElements>
2. 声明锁屏提醒徽标图像
以下示例显示 LockScreen 元素的 BadgeLogo 属性的 XML 声明。请再次注意,此值通常是通过 Visual Studio 来设置,而不是手动设置。有关图像要求的信息,请参阅锁屏应用概述。
<VisualElements
...
<LockScreen Notification="badge" BadgeLogo="images\logo-lockscreen.png"/>
...
</VisualElements>
3. 声明后台任务
具有锁屏的应用必须声明以下后台任务类型之一:
- 控制通道(仅限 Windows)
- 计时器
- 推送通知
在 Visual Studio 中,此值在清单编辑器的“声明”页中设置。
- 从下拉列表中选择“后台任务”。
- 单击“添加”****按钮。
- 从“属性”列表中选择相应的项,然后添加你的选择所需的任何附加信息。
在清单的 XML 中,此值在 BackgroundTasks 元素中声明。
有关后台任务的详细信息,请参阅后台任务简介白皮书。
4. 指定宽徽标
如果在步骤 1 中选择 badgeAndTileText 值,则必须指定宽徽标图像作为应用的默认磁贴的一部分。如果用户在锁屏上设置了磁贴并且已选择该磁贴以显示详细状态,则使用宽磁贴。大型和中型磁贴不在锁屏上使用,因此在锁屏上看不到在没有长方形绑定的情况下发送的磁贴通知。
可以通过 Visual Studio 清单编辑器或在此处所示的清单的 XML 中指定宽徽标图像。
<VisualElements
...
<DefaultTile ShortName="Tiles JS" ShowName="allLogos" WideLogo="images\tile-sdk.png"/>
...
</VisualElements>
摘要和后续步骤
完成上述步骤之后,用户便可以选择你的磁贴使其显示在锁屏上。在本主题中详述的过程之后,你的应用将在设备的“设置”中作为锁屏应用列出。哪些应用显示在锁屏上以及这些应用中的哪个应用将通过文本显示详细状态,由用户进行最终选择。