通过带参数的 Siri 启动应用程序，不带 donations/shortcuts

Question

假设我正在制作一个应用程序，用户可以在其中安装一些小的互动体验（冥想）。

为了方便起见，我希望我的用户能够通过说：“嘿 Siri，在冥想中开始海滩日落。”

由于某些原因，用户通过语音执行此操作是有意义的，无需首先与 Beach Sunset 互动iOS 应用程序。 （例如，他们可能已经通过我服务的网络应用程序“拥有”它。）

也就是说：我想要像 “嘿 Siri，在冥想中启动海滩日落” 这样的语音操作，即使 没有 用户先为它设置快捷方式，或者我为它“捐赠”操作。

这可能吗？ （我觉得很多默认应用程序都有类似的行为，但也许它们很特别。）如果不是，我能做的下一件最好的事情是什么？

Siri 是否需要 "donations" 了解我的应用程序的语音操作，或者它们只是一种提示和预测用户行为的机制？

Siri 是否需要 "shortcuts" 来了解我的应用程序的语音操作，或者它们只是用户短语自定义的一种机制？

I've never added Siri support to an iOS app, but it seems “parameters” have gotten a lot more powerful in iOS 13. suggests something similar wasn't possible in iOS 12, but I think it's also doing something somewhat different (I want to launch the app; they want to “create an object” presumably just using Intent UI. I don't know if this matters.)

我做了什么

我在 开始 类别 (LaunchMeditation) 中使用单个参数 (meditationName) 定义了一个自定义意图。

我考虑了标准的 Media 意图，但这里的媒体是交互式的，严格来说并不 audio/video，我不想惹麻烦。

我已经在我的应用程序中添加了一个 Intents 扩展，并编写了一个基本测试 "handler"，它只是试图将冥想名称传递给应用程序：

@interface IntentHandler () <LaunchMeditationIntentHandling>
@end

@implementation IntentHandler
- (id)handlerForIntent:(INIntent *)intent { return self; }

- (void)handleLaunchMeditation:(nonnull LaunchMeditationIntent *)intent
                    completion:(nonnull void (^)(LaunchMeditationIntentResponse * _Nonnull))completion {
  // XXX: Maybe activity can just be nil?
  NSUserActivity *activity = [[NSUserActivity alloc] initWithActivityType:@"com.example.meditations.activity.launch"];
  activity.title           = [NSString stringWithFormat:@"Launch %@ in Meditations", intent.meditationName]; // Do I need this?
  activity.userInfo        = @{@"meditationName": intent.meditationName};
  completion([[LaunchMeditationIntentResponse alloc] initWithCode:LaunchMeditationIntentResponseCodeContinueInApp
                                                     userActivity:activity]);
}

- (void)resolveMeditationNameForLaunchMeditation:(nonnull LaunchMeditationIntent *)intent
                                  withCompletion:(nonnull void (^)(INStringResolutionResult * _Nonnull))completion {
  completion([INStringResolutionResult successWithResolvedString:intent.meditationName]);
}
@end

当我测试 Intents Extension 时，我现在可以在 Shortcuts 中为它创建一个 Shortcut，设置它的参数，给它一个名字（比如“Beach time”），然后通过告诉 Siri 这个名字来启动它——这是我不希望用户必须做的一切。

除此之外，Siri 会回复

Meditations hasn't added support for that with Siri.

…无论我如何表达我开始 Beach Sunset 的请求。 “没有添加支持” 听起来很痛苦，就像我缺少了什么。

Answer 1

我会尽量简短地回答您的所有问题。

• 您不能在不提供动作的情况下创建 Siri 动作。一旦你捐赠了你的动作，它们也不会注册到 Siri。用户必须创建一个快捷方式才能使用它们。
• 您可以做的下一个最好的事情是告知您的用户您的 Siri 快捷方式。为此，您可以在入职屏幕上显示弹出窗口或通知新用户。好的部分是您可以通过此代码将您的用户重定向到 "Creating Siri Shortcut" 屏幕，您可以通过单击按钮或点击手势触发。

let shortcut = INShortcut(userActivity: shortcutActivity!) // shortcutActivity is your donated activity.          
let vc = INUIAddVoiceShortcutViewController(shortcut: shortcut)
vc.delegate = self // INUIAddVoiceShortcutViewControllerDelegate
self.present(vc, animated: true, completion: nil)

• 快捷方式对于 Siri 了解您的实施是必要的。
• 据我所知，意图域可以帮助您为 Siri 快捷方式指定更多参数。这使您能够创建更多 Siri 交互。
• Apple 还推广了常用应用程序的 Siri 快捷方式。如果您的用户定期或比其他人更频繁地使用您的应用程序，他们可能会在主屏幕上看到 Siri 快捷方式建议。类似于这个one。

我也认为在没有任何用户操作的情况下捐赠 Siri Shortcuts 会很棒，但会存在某些问题，例如：

• 如果两个或多个不同的应用程序对 Siri 快捷方式使用相同的短语怎么办？
• Siri 将如何区分未注册的命令和简单的对话？例如，如果有人使用短语 "Hi Siri".
创建了快捷方式
• 即使您使用特定短语捐赠了一个动作，Siri 也必须了解它的用户如何发音该特定短语。

这些可能弊大于利，因此我认为Apple选择了当前的方式。希望这些能回答您的问题。