为快捷方式添加功能

借助 shortcuts.xml 中的功能,您可以声明用户可以执行哪些类型的操作来启动应用并直接执行特定任务。

例如,Google 助理与应用有关的 Action 利用 capability 让开发者能够将应用内功能扩展到内置 intent (BII),从而让用户能够通过语音指令激活和控制这些功能。capability 由操作名称以及指向应用中用于解析用户 intent 的目的地的 intent 组成。

在 shortcuts.xml 中定义能力

您可以在 Android 应用开发项目的 shortcuts.xml 资源文件中定义 capability 元素。如需定义 capability 元素,请执行以下操作:

  1. 按照创建静态快捷方式中的说明创建 shortcuts.xml 资源。
  2. 请在您的 capability 中加入以下必要信息:

    • 功能名称:您希望应用支持的操作。如需了解需要功能定义的功能,请参阅组件文档。支持与应用有关的 Action 的语音命令会使用 BII Action ID 作为 capability 名称,您可以在 BII 参考文档中找到相应名称。例如,GET_THING BII 会将其 Action ID 列为 actions.intent.GET_THING

    • 应用目的地:操作为执行用户请求而启动的应用中的目的地。使用嵌套在 capability 中的 intent 元素定义应用目的地。

    • 参数映射:每个 intent 可能包含要作为 intent 的 extra 数据传递的参数。例如,每个与应用有关的 Action BII 都包含一些字段,这些字段表示用户在触发 BII 的查询中经常提供的信息。

以下示例演示了 shortcuts.xmlactions.intent.START_EXERCISE 的功能定义。actions.intent.START_EXERCISE 是一个 BII,可让用户通过语音指令与 Google 助理在健身应用中开始锻炼:

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
  <capability android:name="actions.intent.START_EXERCISE">
    <intent
      android:action="android.intent.action.VIEW"
      android:targetPackage="com.example.sampleApp"
      android:targetClass="com.example.sampleApp.ExerciseActivity">
      <parameter
        android:name="exercise.name"
        android:key="exerciseType"/>
    </intent>
  </capability>
</shortcuts>

在上例中,<capability> android:name 属性引用了 START_EXERCISE BII。如果用户通过向 Google 助理发出指令“Ok Google,启动 ExampleApp,开始跑步”来调用此 BII,Google 助理会使用嵌套 intent 元素中提供的信息执行用户请求。此示例中的 intent 定义了以下详细信息:

  • android:targetPackage 为此 intent 设置目标应用软件包。
  • android:targetClass 字段指定目的地 activity:com.example.sampleApp.ExerciseActivity
  • intent parameter 声明了对 BII 参数 exercise.name 的支持,以及如何将从用户收集的参数值作为额外数据传递到 intent 中。

将快捷方式与能力相关联

定义 capability 后,您可以通过将静态或动态快捷方式与其关联来扩展其功能。快捷方式如何与 capability 关联取决于要实现的功能以及用户请求中包含的实际字词。例如,当用户通过向 Google 助理发出“Hey Google,在 ExampleApp 中开始跑步”指令来开始在您的健身跟踪应用中开始跑步时。Google 助理可以使用快捷方式启动 capability 的实例,该实例会为 exercise.name 参数定义一个有效的运动实体“run”。

如需详细了解如何将快捷方式与与应用有关的 Action 相关联,请参阅与应用有关的 Action 概览