集成你的 app 和 Wind Down

（你好 WWDC 2020） 你好 欢迎来到 WWDC （将你的 APP 与助眠整合） 嗨 我叫 Michael Rojas 在快捷指令团队工作 今天 我们将讨论如何为你的 app 的快捷指令 添加助眠 这是我们新的睡眠状况体验的一部分 首先 我们将讨论新的助眠体验 如何与快捷指令一起工作 然后 我们将解释如何使用一些新的 API 来整合你的 app 与助眠的动作 最后 我们将讨论如何使用一些现有的 API 来确保人们 在设置和个性化他们的助眠体验时 能够非常容易地添加你的动作 让我们开始吧

所以 什么是助眠？ 在其核心 我们建立了助眠来帮你达到你的睡眠目标 这意味着专注于那些会让你放松的事情 或者 在漫长的一天之后给你一些空间和正念 对你们中的一些人来说 这可能意味着 在上床睡觉前先准备好明天最重要的事情

我们创建了一种方法 可在助眠模式下快速找到你喜爱的东西 它叫做“助眠快捷指令”

下面是一些 我只需轻点几下就能运行的助眠快捷指令 例如 我有一个 来自 Ten Percent Happier 的快捷键 开始睡眠冥想 我还有一个自定义的睡眠时间快捷键 可以播放轻松的音乐 还可以在我的夜间日志中添加一个条目

我有一个快捷键 来设置我的“放松”家庭场景 使我所有的灯光变暗

你可以在健康 app 新的睡眠设置流程中 创建自己的助眠快捷指令 在整个助眠设置流程中 你会得到一个选项 来添加 你想要在锁定屏幕上看到的快捷指令

让我们看看如何添加快捷键 点击“设置快捷指令”后 你可以从这里显示的 建议快捷指令列表中进行选择 我得到了一个建议 可以打开 Day One 开始写日记 还有一些正念 apps 可以让你专注 我决定打开 Ten Percent Happier 如你所见 此快捷键 已添加到我的助眠快捷指令列表中 你可以编辑这些 或直接从健康 app 添加更多 此外 所有这些快捷指令 都可以从快捷指令 app 的 新睡眠模式专题中访问 一旦你添加了一个助眠快捷键 它就会出现

你只需在快捷键的详细视图中 打开 "在睡眠模式中显示 "开关 就可以让任何现有或新的快捷键 显示在睡眠模式专题中 我们还创建了一些新的 API 允许你在助眠设置流程中 从你的 app 中添加快捷指令 这样在锁定屏幕上 点击几下就可以运行快捷指令 app 公开动作的主要方式是通过意图 你的 app 可以采用内置的意图 比如 INCreateNoteIntent 或者定义自己的自定义意图 我们有一个关于 如何选择正确的 Siri 技术的视频 一定要去看看 一旦你建立了你的意图 你就可以利用一个 名为 shortcutAvailability 的新属性 让我们更深入地了解一下这个新属性 我们在 INIntent 中添加了一个 名为 shortcutAvailability 的新属性 你可以利用它 来告诉我们你的 app 的哪些动作 应该出现在助眠设置中 我们还在 NSUserActivity 上 添加了同样的属性 如果你是用它来表示你的动作的话 现在让我们看看你可以设置的不同选项

下面是不同的快捷键可用性选项 这些选项与助眠设置流程中的类别相匹配

例如 如果你是一个冥想 app 你可能想要标记你的开始冥想的意图 或用户活动与正念选项 在助眠状态下 你可以通过锁定屏幕 快速访问 app 的冥想

如果你是一个 帮助人们为明天做准备的 app 比如备忘录 app 或天气 app 你应该使用为明天做准备选项

下面是这些类别在代码中的样子 现在 让我们看一个例子

这款案例 app 我们就命名为 Bedtime 通过播放音景电台来帮助人们入睡 例如 “沉睡的恐龙声音”和舒缓的“烹饪白噪音” 也许不适合所有人 但对我来说 这听起来是“睡眠音乐”的一个不错的选择 让我们开始吧 首先 我要创建我的意图 在这种情况下 我使用的是 INPlayMediaIntent 系统 因为它允许我开始音频会话 然后我将把 快捷键可用性选项设置为睡眠音乐 接下来 我要用一个 INShortcut 来包装我的意图

在 INVoiceShortcutCenter 上 获取共享属性 最后 我将通过调用 setShortcutSuggestions 将其提供给系统

就这么简单 现在我的睡前动作会在 有人设置助眠体验时显示在音乐区 重要的是要记住 并不是 app 中的每一个动作 都能真正帮助人们达到睡眠目标

例如 为了放松而开始瑜伽 就非常适合瑜伽和伸展类的课程 但是开始热身跑可不是 准备入睡的最好方式 所以不是个好的候选 同样 在轻松的音景中助眠 比在唤醒混音中助眠更容易 很明显 开始冥想比开始开会 更能让你睡个好觉 所以 你只需要从你的 app 中选择正确的操作 最终 你将是最好的决策者 永远将用户体验感放在首位 什么有助于人们入睡？

现在让我们看看在从 app 中 选择正确的动作后 需要做些什么

你可以做两件事来让系统 在助眠设置时建议你的 app 的动作 首先 正如我前面提到的 你可以通过 调用 INVoiceShortcutCenter 上的 setShortcutSuggestions 来建议你想要的系统的快捷指令 如果你的 app 的动作 在某个时候发生了变化 确保再次设置 这样只有最相关的动作才会出现在 助眠设置中 你应该做的另一件事是当某人 在他们日常使用的 app 中执行动作时 将意图或用户活动捐赠给系统 这有助于系统理解最重要的操作是什么 因此我们可以 尽最大努力在助眠设置中突出它们 甚至在查询和锁定屏幕建议等其他地方 现在我们来谈谈 如何在建议和捐赠之间做出选择

你要同时向系统建议快捷指令和捐献 因为它们各有益处 通过 INVoiceShortcutCenter 提示快捷指令的一个好处是 它将确保你的 app 中的这些动作 会在助眠中显示出来

例如 我有一个动作来播放当天的音景 我总是希望它容易被找到 所以我将按照建议设置它 这里是如何在代码中做到这一点 首先 初始化 INPlayMediaIntent 接下来 如果适用的话 一定要设置快捷键的可用性 在本例中 我将其设置为睡眠音乐 不要忘记设置建议的调用短语 这将是人们可以对 Siri 说的话 以便用他们的声音执行这个动作 它也是助眠屏幕上的显示的一句话 用来描述这个快捷键

然后从意图创建一个快捷键 最后 在 INVoiceShortcutCenter 上 建议快捷键 现在让我们来看看捐赠 当一个动作在你的 app 中被执行时 比如播放一首曲目 你应该把这个动作捐赠给系统 这样系统就可以从这个人的行为中学习 让我们在代码中看看这一点 要在你的 app 中执行动作时捐赠意图 你首先要初始化意图 接下来 确保设置快捷键的可用性

同样 我将确保设置建议的调用短语 这次设置为曲目的名称

将其包装在 INInteraction 中 最后 在交互上调用捐赠 告诉系统有一首曲目被播放

而要捐献用户任务 首先要初始化用户任务 确保它适合查询和预测 设定一个标题 设置建议的调用短语和快捷键可用性 最后 设置视图控制器的用户活动属性将其捐赠 正如你在刚才的代码示例中看到的 你应该确保在你的意图或用户任务上 设置了建议的调用短语 因为这是 用于从你的 app 中命名快捷键的 以及在助眠期间锁屏上显示的内容

建议的调用短语应该简短而简洁 因为它必须适合锁定屏幕上的小屏幕 并且应该让用户能够根据名称 唯一地识别快捷键 让我们来看看如何选择一个好的短语

例如 如果你是一个白噪音 app 如 Bedtime 一个好的短语应该包括曲目的名称 如 “播放数数瞌睡龙” 这个名称具有足够的描述性 可以从 app 的其他动作中脱颖而出 同时又足够短 适合锁定屏幕

像“播放声音”这样的短语太笼统了 并且没有关于实际声音的任何信息 这使得它很难识别

确保通过省略不必要的信息 来限制短语的长度 以避免在空间有限的地方被截断

现在你知道了如何选择建议的调用短语 让我们看看如何在代码中实现这一点 你可以通过在提供或建议快捷键之前 在意图上 设置建议的调用短语来实现这一点 正如你所看到的 这个短语在关闭时显示在锁定屏幕上 用于命名快捷键 所以仔细选择短语很重要 总结一下 我们讨论了新的助眠体验 和它与快捷指令 app 的集成 以及如何 使用新的 API 使你的 app 中的动作 非常容易地成为这种体验的一部分 感谢各位的收看