创建编写了脚本的自动化作业

1. 简介

学习内容

• 如何规划和编写脚本化自动化操作。
• 如何测试脚本自动化。

所需条件

• 一部运行 Google Home 应用的 Android 或 iOS 手机。
• 智能灯或其他设备，已经过 Works With Google Home 认证，可开启或关闭。

2. 设置设备

如果您尚未设置设备，请继续在您的住宅中进行设置。

确认该设备显示在 Google Home 应用中，并且您可以使用 Home 应用将其开启和关闭。

3. 规划脚本化自动化

我们首先会思考我们希望脚本化自动化执行什么操作，其中包括以下注意事项：

• 您要设置自动化操作的设备。
• 哪个启动方式（或事件）应触发脚本自动化的执行。
• 还有哪些其他条件（如果有）用于控制脚本自动化在触发后是否运行。
• 要执行的操作。

在此 Codelab 中，我们计划让脚本化自动化执行两项操作：

1. 在特定时间打开灯具（或其他智能设备）。
2. 在特定时间关闭设备。

现在我们已经明确了我们想要通过脚本自动化执行的确切操作，接下来，我们将打开脚本编辑器并编写脚本化的自动化操作。

4. 编写脚本化自动化规则

脚本化自动化操作是使用 YAML 数据序列化语言以声明方式编写的。

脚本化自动化由两个主要部分组成：

1. 元数据 - 脚本化自动化的名称及其用途说明。
2. 自动化规则 - 定义自动化操作的启动逻辑和行为。

元数据

自动化操作的元数据会告诉用户自动化功能的名称和用途。元数据在 metadata 块中指定，如下所示：

metadata:
  name: Scheduled light
  description: Turn the light on and off at specific times

自动化规则

实际工作是在自动化规则中进行的。它包含三个部分：启动方式、条件和操作。系统会按顺序评估它们：

自动化的 automations 代码块包含两条规则：

automations:
  - starters:
      - type: time.schedule
        at: 1:00 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: true
  - starters:
      - type: time.schedule
        at: 1:05 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: false

请注意以下几点：

1. 有两条 automations 规则。第一个可以开灯，第二个要关灯。
2. 每条规则都有一项操作。
3. on: true 表示开灯。同样，on: false 表示关灯。
4. 每条规则都有一个 time.schedule 启动方式，用于告知自动化系统何时启动自动化操作。
5. 此自动化操作中没有任何条件。

5. 完全脚本化的自动化

结合以上所有要素，完整的脚本自动化流程如下所示：

metadata:
  name: Scheduled light
  description: Turn the light on and off at specific times
automations:
  - starters:
      - type: time.schedule
        at: 1:00 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: true
  - starters:
      - type: time.schedule
        at: 1:05 PM
    actions:
      - type: device.command.OnOff
        devices: Desk light - Office
        on: false

1. 复制自动化操作（如上所示）。
2. 前往 Google Home 网页版。
3. 选择“自动化操作”标签页（以带有三颗星的图标表示）：
   
4. 点击 + 添加新对比项。
5. 在脚本编辑器中，删除该自动化模板。
6. 粘贴您的自动化操作。
7. 将 Desk light - Office 替换为您的设备的名称和位置。
8. 点击验证。脚本编辑器会为脚本化自动化中包含错误的部分添加下划线。修正出现的所有错误，然后不断验证和修正，直到错误不再出现为止。例如，您的设备名称可能有所不同。如果是这样，您可以使用自动补全功能来选择有效的设备名称。
9. 点击保存。
10. 确保脚本文本下方的启用开关处于开启位置：

6. 测试自动化操作

1. 请确保您的设备已接通电源，并显示在 Google Home 应用中。
2. 如果设备目前处于开机状态，请将其关机。
3. 在 Google Home 网页版的自动化操作页面上，点击自动化操作旁边的“运行”按钮。
   
4. 设备应该会开机。

现在，我们来测试自动化操作。

1. 关闭设备。
2. 修改自动化操作，将第 7 行的“设备开启”时间更改为 5 分钟后。
3. 将第 14 行的“设备关闭”时间更改为“准时”之后不久的某个时间。
4. 点击验证。解决可能出现的任何错误。
5. 点击保存。
6. 确保启用开关处于开启位置。
7. 等待两个启动时间结束。设备应该会在您指定的时间开启，然后关闭。

7. 恭喜！

您已成功创建脚本自动化，太棒了！

在此 Codelab 中，您学习了如何执行以下操作：

• 如何设计和编写自动化操作。
• 如何测试自动化操作。

后续步骤

在此 Codelab 中，我们创建了一个非常简单的自动化操作。自动化功能远远不止安排开关电源开关。现在，你已经了解了创建自动化操作的基础知识，接下来可以探索 Google Home 生态系统中提供的各种类型的启动方式、条件和操作。

尝试进行以下练习：

• 为自动化操作添加更多time.schedule启动方式。
• 修改相应自动化设置，让系统按照同一时间表开启和关闭另一台设备。
• 如果不移除time.schedule启动方式，请修改自动化操作，以便仅在另一台设备已开机时开启相应设备。请参阅使用 condition 子句的脚本示例。
• 修改自动化设置，仅在有人在家时开启设备。

深入阅读

如需详细了解 Google Home 自动化操作，请浏览自动化操作参考文档：

• 快速入门
• 支持的启动方式、条件和操作