在 Android 上设计自动化操作

在开始使用 Automation API 之前,您应该先设计自动化操作。

为每个自动化操作确定以下参数:

  • 应向用户建议自动化的情形。 例如,如果用户刚刚在住宅中添加了三盏新灯,他们可能会对专门用于控制灯光的特定自动化操作感兴趣。
  • 自动化操作需要哪些设备类型。例如,如果用户刚刚在家中添加了三盏新灯,他们可能会对专门用于控制灯光的特定自动化操作感兴趣。示例灯具设备类型包括 OnOffLightDevice、ColorTemperatureLightDevice、DimmableLightDevice 或 ExtendedColorLightDevice。
  • 自动化操作需要哪些 trait 属性和命令,以及Android 上的 Automation API 是否支持这些属性和命令。
  • 应作为启动方式激活自动化操作的特征。Android 上的自动化组件中介绍了启动方式。
  • 用于确定自动化操作是否应实际运行以及要执行哪些操作的其他条件。
  • 自动化操作的执行流程。是应该依序执行还是并行执行?您是否需要多条逻辑路径?

在设计时,最好逐个节点地绘制自动化流程图,并注明每个步骤所需的逻辑。

设计好自动化操作后,请使用自动化操作 DSL 进行构建。您构建的自动化操作本质上是一个“模板”,其中的任何结构和设备都是占位符,当用户“采用”该自动化操作供自己使用时,系统会用每个用户的特定结构和设备填充这些占位符。

以下是应用可以使用 Home API 创建的不同类型的自动化操作。如需查看与这些示例相关的代码摘录,请参阅构建自动化操作页面。

简单自动化

假设您需要编写一个应用,用于创建在上午 8:00 升起百叶窗的自动化操作。为此,应用需要住宅中支持自动化的百叶窗(设备类型为 WindowCoveringDevice 的设备)列表,该列表可由 Discovery API 提供。

对于需要在特定时间运行的自动化操作,您还需要确保用户已为其所选结构分配了街道地址(在结构创建期间或在 Google Home app (GHA) 中),否则自动化操作不知道其运行所在的时区。Discovery API 可帮助您确定是否已为结构分配地址。

因此,执行流程如下所示:

  1. 使用 Discovery API 收集 WindowCoveringDevice 设备列表。
  2. 如果街道地址未填充,请通知用户他们需要提供街道地址(例如,在 GHA 中),并停止执行。
  3. 否则,请定义自动化操作:
    1. 在上午 8:00 启动自动化操作。
    2. 对于每个百叶窗,调用 WindowCovering 特性的 upOrOpen 命令。

复杂自动化

假设某个应用构建了一项自动化操作,可在检测到动作时触发灯光闪烁。

实现此应用的首要任务之一是使用 Discovery API 找出用户家中有哪些灯。有了这些信息,您的应用现在可以显示可用的指示灯,并可能允许用户选择要闪烁的指示灯。

执行流程:

  1. 使用 Discovery API 收集结构中存在的灯光设备列表,这些设备可以是设备类型为 OnOffLightDevice、ColorTemperatureLightDevice、DimmableLightDevice 或 ExtendedColorLightDevice 的任何设备。
  2. 提供一种选择闪烁灯的方法,例如通过自定义设置面板。
  3. 定义自动化操作:
    1. 通过监控 AreaPresenceState,在有人离开或到达场所时启动自动化操作。
    2. 如果 presenceState 指示结构体已被占用,则闪烁所选灯。

通用自动化

如需查看更复杂的自动化操作示例,请考虑一个引导用户根据其住宅中的任何或所有设备创建开放式自动化操作的示例。

自动化操作可能会先提示用户选择住宅。

然后,自动化操作可以采用可展开的大纲视图显示结构中的所有房间,展开房间即可显示其中的设备。进一步展开设备会列出该设备支持的启动方式和指令。

用户可以选择要使用的设备、启动方式和指令,然后自动化操作会引导用户完成自动化操作的组装。

当用户的所有选择和决定都最终确定后,自动化操作会生成自动化操作并将其保存到用户选择的结构中。

简而言之,此类自动化操作需要使用 Structure API for Android、Device API for Android 和 Discovery API 收集有关用户住宅的多组数据。

表 1:Home API 及其可提供的信息
API信息
Structure API
  • 有哪些结构可用
  • 住宅中有哪些房间
Device API
  • 所选结构中有哪些设备
  • 这些设备所在的位置(哪个房间)
Discovery API
  • 设备支持哪些特征
  • 这些特征有哪些可用的启动方式和指令
  • 这些命令的参数存在哪些限制