在 Android 上支持 Automation API trait

Android Automation API 支持大多数特征，但对特征中的某些属性、事件和命令的支持可能会受到限制。

一般来说：

• 您打算在应用中使用 Automation API 的任何特征和类型都必须在初始化时注册。请参阅 创建 Home 实例。
• 任何属性都可以在启动器或条件中使用。
• 无法将不报告状态的 Cloud-to-cloud 设备用作手动创建或通过发现创建的自动化中的触发器。

• 即使设备支持此处列出的特征，也可能会因 报告状态 质量阈值而无法在 Automation API 中用作启动器或操作：

  • 报告状态成功率低于 90% 的设备无法用作启动器。
  • 命令执行成功率低于 95% 的设备无法用作操作。

  请参阅此 设备型号列表 以及它们支持的特定启动器和操作，了解 Automations API。

• 命令只能用作操作。

• 某些特征（例如 AssistantBroadcast 和 Notification） 只能在 Automation API 中使用。

• The okGoogle 命令是结构级命令，可用于自动执行结构中的任何设备 在结构中。不过，Home API 应用可能无法访问每个设备。如需了解在各种情况下如何强制执行权限，请参阅 OkGoogle 权限。

• 某些特征有前提条件：

  • 如需使用 Time.ScheduledTimeEvent, 自动化运行的结构必须具有街道地址。您可以在创建结构期间提供 地址，也可以在 Google Home app (GHA)中设置地址。更改 Google 住址 介绍了用户如何在GHA中输入或更新结构地址。如果未设置地址，自动化 将无法创建，并且会抛出错误，并显示消息“The ScheduledTimeEvent is not supported by the structure。”
  • 为了让家庭成员接收来自 Notification.sendNotifications的通知， 他们必须安装 GHA 并启用通知 。通知通过 GHA传递给成员，无法直接发送到第三方应用。
  • 如需使用 AreaPresenceState 或 AreaAttendanceState 特征， 用户必须在 GHA 中设置在家/外出感知。
  • 如需使用 ObjectDetection 特征，用户必须拥有有效的 Google Home Premium 订阅。

某些特征的简化版本也可用于自动化。 如需了解详情，请参阅 Android 上的简化特征。