使用 Android 示例应用

Android 示例应用展示了使用 Home API 访问和控制其支持的设备类型的基本功能。

账号授权完成并选择结构后,示例应用会加载在该结构中找到的所有本地设备。

如果设备位于某个房间,则会列在该房间下。示例应用支持以下设备类型:

  • 色温灯(开关、亮度)
  • 接触传感器(布尔值状态)
  • 可调光灯(开关、亮度)
  • 门锁
  • 扩展彩色灯(开和关、亮度)
  • 通用开关
  • Google 边界路由器
  • Google 相机
  • Google 门铃
  • 在家/外出传感器(在家/外出感知)
  • 开关灯(开和关、亮度)
  • 电灯开关
  • 开关插接单元(开和关)
  • 开/关传感器

对现有设备和自动化操作执行的操作

示例应用包含两个标签页:设备和自动化操作。每个标签页都会提供有关结构的信息,并允许您执行任务。

“设备”标签

设备标签页(图 1)显示了结构中的房间(后院、阁楼、旅行)和每个房间的设备,以及每个设备的状态。如需查看或修改设备上的特征,请点按设备名称。这会将您转到该设备的控制界面(图 2)。

如需向结构中添加设备,请在设备标签页中点按添加设备(图 1),然后按照说明添加设备(无论是否使用二维码)。

Home API 示例应用的“设备”标签页。
图 1:示例应用界面:“设备”标签页视图
Home API 示例应用的设备控件。
图 2:示例应用设备控件

“自动化操作”标签页

自动化操作标签页(图 3)会显示住宅的所有自动化操作列表。每项自动化操作都会显示其启动方式和操作。支持多个启动方式和操作。

点按某个自动化操作即可查看其详细信息,如图 4 中的示例所示。 在此详细视图中,您可以删除自动化操作,也可以手动执行自动化操作,而无需启动器,前提是此自动化操作支持手动执行按钮。

此外,在自动化操作的详细视图(图 4)中,您可以切换 isActive 来开启或关闭自动化操作。isValid 字段由 SDK 设置,如果设备或 trait 支持存在问题或其他问题,则该字段为 false。

Home API 示例应用的“自动化操作”标签页。
图 3:“自动化操作”标签页视图
所选自动化操作的详细视图。
图 4:一项自动化操作的详细视图

创建自动化操作

如需创建新的自动化操作,请在自动化操作列表视图中点按创建按钮(图 3)。系统会显示新自动化操作界面(图 5)。

使用 +添加启动方式和 +添加操作按钮(图 5)为自动化操作添加一个或多个启动方式和操作。图 6 和图 7 分别展示了选择启动方式和操作的示例。做出选择并保存启动方式或操作后,系统会显示启动方式的更新启动方式和移除启动方式按钮(以及操作的更新操作和移除操作)。这样,您就可以在保存自动化操作本身之前,修改或移除启动方式或操作。

添加完启动方式和操作后,您可以返回新自动化操作界面,然后点按创建自动化操作(图 8)。

用于启动新自动化操作的示例应用界面。
图 5:开始创建新自动化操作
用于为自动化操作添加启动方式的应用界面示例。
图 6:向自动化操作添加启动方式
用于为自动化操作添加操作的示例应用屏幕。
图 7:向自动化操作添加操作
用于创建自动化操作的示例应用界面。
图 8:创建自动化操作

问题排查

该应用会针对可能发生的一些常见事件显示对话框消息。 如需了解如何解决这些事件,请参阅 adb 日志。

如果您在使用示例应用时遇到问题,请参阅排查 Android 问题。