SiriKit框架详细解析（五） —— 编程指南之Intents和Intents UI扩展（一）

SiriKit是您通过Siri提供内容的一种方式。 它还允许您向 Maps 应用添加对服务的支持。 要支持 SiriKit ，您可以使用 Intents 框架和 Intents UI 框架来实现一个或多个扩展，然后将这些扩展包含在iOS应用程序中。 当用户通过Siri或Maps请求特定类型的服务时，系统会使用您的扩展来提供这些服务。

仅当您的应用程序实现以下类型的服务之一时才添加SiriKit支持：

汽车制造商可以使用 CarPlay intents 允许用户使用语音命令控制汽车功能。

每种类型的服务代表您可以支持的功能域，每个域定义一个或多个意图供您支持。 意图是表示用户意图的对象。 Siri和Maps创建意图对象以响应用户请求，并使用任何用户指定的信息填充它们。 例如，发送消息的意图可能包括消息的接收者和内容。 您使用intent对象提供适当的响应并执行相关的任务。 有关支持的域及其意图的更多信息，请参阅 Intents Domains 。

Siri 和 Maps 通过两种不同类型的扩展与您的应用服务进行互动：

您必须提供 Intents 扩展才能支持 SiriKit 。您的Intents扩展程序负责处理意图并提供Siri和Maps可用于与用户通信的信息。提供 Intents UI 扩展是可选的，但是通过Siri与您的应用进行交互的方式对您的用户来说似乎很熟悉。例如，Intents UI扩展可以显示横幅和其他特定于应用的信息，以强化您的应用正在提供响应。

有关用于实现Intents扩展的类的信息，请参阅 Intents Framework Reference 。有关用于实现 Intents UI 扩展的协议的信息，请参阅 Intents UI Framework Reference 。

Siri处理将用户的语音请求转换为扩展可以处理的可操作意图所需的语言处理和语义分析。 Siri和Maps应用程序管理所有用户交互，并使用标准系统界面向用户显示结果。 您的角色主要是提供要显示的数据。 如果您的应用程序包含Intents UI扩展，您还可以提供自定义界面来补充默认系统界面。

乘车预订和餐厅预订主要由 Maps 应用程序处理，尽管用户也可以使用Siri预订游乐设施。 您的Intents扩展程序处理源自Maps应用程序的交互，其处理方式与处理来自Siri的请求的方式相同。 如果您自定义用户界面，您的 Intents UI 扩展可以根据请求来自Siri还是Maps来进行不同的配置。

Siri 和 Maps 通过您的 Intents 扩展程序与您的应用互动。 Intents扩展的入口点是 INExtension 对象，其唯一的工作是将Siri指向能够响应用户请求的对象。实现 Intents 扩展时，您经常使用三种类型的对象：

当您的扩展程序有意图处理时，Siri会询问您的 INExtension 对象是否有能够处理该意图的对象。处理程序对象可以是您想要的任何类型，但它必须实现处理给定意图所需的特定方法。每个 intent 都有一个与其处理程序必须采用的关联协议。该协议的方法分为三组：解决方法，确认方法和处理方法。您可以实现所需的方法，并向Siri提供有关您计划如何处理意图的信息。

图2-1说明了Siri与扩展中的处理程序对象之间的高级别流程。在该示例中，当用户要求使用乘车预订服务预订乘车时，Siri创建具有乘坐参数的意图对象并将其发送给处理者。处理程序将intent对象中的数据解析为可用于完成行程的值。当所有骑行参数都已解决后，Siri要求处理者确认其计划如何处理乘坐请求并执行任何最终验证。在确认阶段，处理程序提供一个响应对象，其中包含骑行的详细信息，Siri可能会向用户显示。如果用户接受了乘坐，Siri要求乘车请求处理者处理该意图。处理程序通过预订车辆并回复预订车辆的详细信息来回应。

有关如何创建扩展的一般信息，请参阅 App Extension Programming Guide 。

要支持 SiriKit ，请在您的iOS应用中添加 Intents extension 。

Xcode提供的 Intents 扩展模板包含一个 INExtension 子类供您自定义。 您可以使用该类来创建处理意图所需的处理程序对象。 Siri使用您的扩展的 Infoplist 文件来发现它支持的意图。 Xcode提供的 Infoplist 文件主要是配置的，但您必须修改它的一部分以指定扩展程序处理的意图。

这个key是必需的。您可以支持给定域中的所有或部分意图，并且您的扩展可以支持任意数量的域。该值必须包含扩展支持的所有 intent 类。

此键是可选的。该值包含您需要解锁设备的 intent 类的子集。如果处理意图涉及访问磁盘上的受保护文件或操纵敏感用户数据，则可能在此列表中包含 intent 。

实现扩展的行为涉及以下任务：

有关可用意图的列表以及为每个意图实现的关联类和协议，请参阅 Intents Domains 。

在使用Intents扩展程序之前，在注册任何特定于用户的词汇表之前，您的iOS应用程序必须请求授权才能使用Siri。 要请求授权，请执行以下操作：

您的iOS应用首次调用 requestSiriAuthorization： 方法时，系统会显示一条alert弹窗，提示用户授权您的应用。弹窗包括您在应用的 Infoplist 文件的 NSSiriUsageDescription 键中提供的使用说明字符串。用户可以批准或拒绝您的应用程序的授权请求，并可以稍后在“设置”应用中更改您应用的授权状态。系统会记住您的应用程序的授权状态，以便后续调用 requestSiriAuthorization： 方法不会再次提示用户。

您的 Intents 扩展程序是代表您的应用程序执行的代理程序，应该能够执行与您的应用程序相同的服务。由于您的iOS应用和 Intents 扩展执行许多相同的任务，请考虑以下事项：

要测试 Intents 扩展，必须在设备上运行它。 Xcode支持直接从Xcode项目启动Intents扩展，并在设备上运行时对其进行调试。

当您向项目添加Intents扩展时，Xcode会自动创建一个运行该扩展的 scheme 。

您无法在模拟器中调试 Intents 扩展。

Xcode构建您的应用和扩展，将它们安装在设备上，然后启动Siri。

首次安装您的扩展程序时，Siri可能无法立即识别您的应用扩展程序。您可能需要等待几分钟才能发出任何相关命令。同样，在更新Infoplist文件时，您可能需要等待几分钟，然后Siri才能识别出更改。

您的iOS应用程序使用 Intents 框架执行特定任务：

用户可以为Siri配置与设备其余部分不同的语言。 在iOS应用程序中，系统使用特定于设备的语言设置检索本地化内容。 在 Intents 扩展中，系统使用Siri语言检索本地化内容。 如果您的应用与扩展程序共享本地化内容，则必须使用 Siri 语言共享该内容，您的应用可以使用 INPreferences 类的 siriLanguageCode 方法检索该语言。

有关获取Siri语言的更多信息，请参阅 INPreferences Class Reference 。

在 Intents 扩展中，处理程序对象执行解析，确认和处理Siri发送的intent对象的关键工作。每个intent对象都有一个专门为处理该intent而设计的相关协议。例如， INRequestRideIntent 对象的处理程序采用 INRequestRideIntentHandling 协议。

每种协议的方法分为三组：

实现处理程序时，必须始终实现处理intent的方法。所有其他方法都是可选的，但建议使用。解决和确认方法是您在尝试处理意图之前验证意图内容的机会。您还可以使用这些方法来标识或创建处理意图所需的内部数据对象。

有关意图列表和相应的意图处理协议，请参阅 Intents Domains 。

在意图的解决阶段，Siri要求您的处理程序解析关键参数并确认您打算使用的值。因为说出了来自用户的数据，所以可能存在丢失或模糊的信息。解决阶段是您验证所提供数据的机会，并让Siri知道您是否需要澄清或更多信息。建议您为给定的处理程序协议实现所有解析方法。虽然您可能不会使用所有参数，但每种方法都会告诉Siri您是否在自己的数据结构中找到了适当的值。

您使用解析结果对象将解析结果传回 SiriKit ，解析结果对象是 INIntentResolutionResult 类的实例。您可能需要解析每种参数类型的不同子类。例如，在以 INPerson 对象的形式解析联系人时，将返回 INPersonResolutionResult 类的实例。实例化子类时，请使用与解析工作结果相对应的创建方法。表3-1列出了可能的结果，并说明了何时使用每种结果。

Table 3-1 Possible outcomes when resolving intent parameters

解析参数时，尝试尽快达成成功的解决方案。 询问更多信息会导致额外的用户交互以及对处理程序的额外调用，从而导致延迟并可能使用户感到沮丧。 相反，尝试根据用户的模式和习惯选择合理的值，并仅在需要时要求消除歧义或确认。

Listing 3-1 显示了乘坐预订应用程序的示例，该应用程序验证了乘车的下车位置。 如果存在一个下车位置，则该方法返回一个成功的结果；否则，该方法返回表示需要该值的结果。

      ipad语音助手关闭的方法是长按home键的功能只能在siri和语音控制间切换。只不过语音控制离线且功能少、识别率差。打开设置、通用、siri、关闭siri即可。

      iPad是由苹果公司推出的平板电脑产品系列，由设计主管乔纳森·伊夫领导的团队设计，第一款iPad于2010年4月3日推出。iPad的定位介于苹果的智能手机iPhone和笔记本电脑产品之间，提供浏览网站、收发电子邮件、观看电子书、播放音频或视频、玩游戏等功能，分为iPad、iPad mini、iPad Air、iPad Pro四个系列。为iPad 未能成形最大的技术障碍：电池和屏幕，找到满意的解决方案。Ive 理想中的平板貌似并不复杂：那是一部足够便宜，而且抛弃键盘的手提电脑。但很多人并不认同将笔记本上的键盘拿走，即使已有 UMPC。与很多产品初始设计阶段一样，Ive 一开始定制了超过20 个模板，涵盖了各个尺寸、屏幕比例，尝试为这款产品找出最合适的尺寸。一名前苹果工程师说：“乔布斯与 Ive 几乎为所有苹果产品这么做过”——即通过大量的模板，寻找出当中最优秀的方案。最终决定 iPad 大小的，是办公室中的一张白纸。Ive团队明白到，如果平板电脑的最终野心，是要取代办公、教育、阅读领域消费者手上纸张。可以将 iPad 的大小定为一般杂志、纸张的大小。因此，最后团队将 iPad 的尺寸定在 97 英寸，乔布斯称之为不会太大也不会太小的 “黄金尺寸”。