在 Android 上设计自动化操作

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

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

  • 应在哪些情况下向用户推荐自动化操作。 例如,如果用户刚刚向家中添加了三盏新灯,他们可能会对专门用于控制灯的特定自动化操作感兴趣。
  • 自动化操作需要哪些设备类型。例如,如果用户刚刚向家中添加了三盏新灯,他们可能会对专门用于控制灯的特定自动化操作感兴趣。灯设备类型的示例包括 OnOffLightDeviceColorTemperatureLightDeviceDimmableLightDeviceExtendedColorLightDevice
  • 自动化操作需要哪些特征属性和命令,以及 Android 上的 Automation API 是否支持这些属性和命令
  • 应将哪些特征作为启动方式来激活自动化操作。启动方式将在 Android 上的自动化操作组件中讨论。
  • 其他条件,用于确定自动化操作是否应实际运行,以及要执行哪些操作。
  • 自动化操作的执行流程。是应按顺序执行还是并行执行?您是否需要多个逻辑路径?

在设计时,按节点绘制自动化操作的流程图,并注明每个步骤所需的逻辑,可能会很有帮助。

设计完自动化操作后,请使用 Automation 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 收集结构中存在的灯设备列表,这些设备将是设备类型为 OnOffLightDeviceColorTemperatureLightDeviceDimmableLightDeviceExtendedColorLightDevice 的任何设备。
  2. 提供一种选择闪烁灯的方式,或许可以通过自定义“设置”面板来实现。
  3. 定义自动化操作:
    1. 每当有人离开或到达场所时,通过监控 AreaPresenceState 来启动自动化操作。
    2. 如果 presenceState 表明结构有人,则闪烁所选的灯。

通用自动化操作

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

自动化操作可能会先提示用户选择一个结构。

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

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

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

从宏观层面来看,此类自动化操作需要使用适用于 Android的 Structure API、适用于 Android 的 Device API和 Discovery API 收集有关用户住宅的多组数据 。

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