Android 版 Automation API 支持大多数特征,但对某些特征中的属性、事件和命令的支持可能有限。
如需验证 Automation API 是否支持您的使用情形,请在下表中搜索。
一般来说:
- 您打算在应用中通过 Automation API 使用的任何特征和类型都必须在初始化时注册。请参阅创建 Home 实例。
- 任何属性都可用于启动方式或条件。
- 不报告状态的 Cloud-to-cloud 设备无法用作自动化操作中的触发器,无论是手动创建的自动化操作还是通过发现创建的自动化操作。
即使设备支持此处列出的特征,也可能因报告状态质量阈值而无法在 Automation API 中用作启动器或操作:
- 如果设备的“报告状态”成功率低于 90%,则无法用作启动器。
- 如果设备的命令执行成功率低于 95%,则无法用作操作。
请参阅此设备型号列表,了解这些设备型号支持的特定启动器和操作(适用于 Automations API)。
命令只能用作操作。
某些特征(例如
AssistantBroadcast
)仅适用于 Automation API。okGoogle
命令是结构级命令,可用于自动执行结构中的任何设备。不过,Home API 应用可能无法访问所有设备。请参阅 OkGoogle 权限,了解在各种情况下如何强制执行权限。部分特质有前提条件:
- 如需使用
Time.ScheduledTimeEvent
,自动化操作运行的结构必须具有在 Google Home app (GHA) 中设置的街道地址。更改 Google 家庭住址一文介绍了用户如何输入结构化地址。如果未在 GHA 中设置地址,自动化操作将无法创建,并抛出一条错误消息:“structure 不支持 ScheduledTimeEvent。” - 如需使用
AreaPresenceState
或AreaAttendanceState
特征,用户必须在 GHA 中设置在家/外出感知功能。 - 如需使用
ObjectDetection
特征,用户必须拥有有效的 Nest Aware 订阅。
- 如需使用
某些特征的简化版本也可用于自动化操作。 如需了解详情,请参阅 Android 上的简化特征。
禁止表示相应命令不支持在自动化操作中用于一种或多种设备类型。如需了解详情,请参阅 Android 自动化中的受限操作。