使用 iOS 示例应用

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

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

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

  • 色温灯
  • 可调光灯
  • 门锁
  • 扩展彩色灯
  • 风扇
  • Google 边界路由器
  • Google 相机
  • Google 门铃
  • 在家/外出传感器
  • 开/关灯
  • 开关插接单元
  • 温度传感器
  • 温控器
  • 窗饰

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

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

“设备”标签

设备标签页(图 1)显示了结构中的房间(浴室、书房、办公室)和每个房间的设备,以及每个设备的状态。您还可以点击屏幕右上角的 more_horiz 图标,断开设备连接或更新权限(图 2)。

Home iOS API 示例应用的“Devices”(设备)标签页。
图 1:“设备”标签页视图
Home iOS API 示例应用的设备控件。
图 2:断开连接或更新权限

“自动化操作”标签页

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

点按某个自动化操作即可查看其详细信息,如图 4 中的示例所示。 在此详细视图中,您可以查看启动方式、条件和操作的详细说明。

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

创建自动化操作

如需创建新的自动化操作,请在自动化操作列表视图中点按 +添加按钮(图 3)。下一个界面会显示建议的自动化操作列表。 选择所需的自动化操作(图 5)。如果没有任何内容自动填充,则表示结构中不包含自动化操作所需的足够设备。例如,如果您想打开风扇和灯,则结构应同时包含风扇和灯设备,否则自动化操作将不会显示。

选择自动化操作后,您会看到启动方式、条件和操作(图 6)。点击保存以添加自动化操作(图 7)。

建议的自动化操作的示例应用屏幕
图 5:自动化操作建议
自动化操作的示例应用界面。
图 6:保存自动化操作
已创建的自动化操作的示例应用界面。
图 7:自动化操作已创建

修改自动化操作

如需修改自动化操作的名称和说明,请在自动化操作详细视图(图 4)中点击设置图标,然后点击修改名称(图 8)。如图 9 所示,修改名称和说明,完成后返回(图 8)。如需保存,请点击设置图标,然后点击保存。

用于选择“修改名称”按钮的示例应用界面。
图 8:修改自动化操作名称
用于修改自动化操作名称和说明的示例应用界面。
图 9:名称和说明编辑器

删除自动化操作

如需删除自动化操作,请前往自动化操作概览(图 7)。在要删除的自动化操作上向左滑动,然后点击删除图标(图 10)。

用于删除自动化操作的应用界面示例。
图 10:删除自动化操作

通用自动化操作编辑器

借助通用编辑器,您可以在创建自动化脚本时,选择结构中的任何设备,将其用作启动方式和操作,并使用支持的特征作为条件。

如需添加通用自动化操作,请在“自动化建议”界面中点按通用自动化操作(图 5)。

在下一个界面中,您可以修改自动化操作的名称和说明。

添加候选启动方式

如需添加启动方式候选,请点按添加启动方式和条件(图 11)。启动器候选界面会显示结构中的可用启动器(图 12)。选择一个候选启动方式以继续(图 13)。

通用自动化操作编辑器界面,其中显示了“添加启动方式和条件”按钮
图 11:通用编辑器界面
候选启动器列表。
图 12:候选启动器列表
启动器选择界面,显示所选设备的可用特征
图 13:选择启动器

选择开启或关闭或更改亮度(图 14 和图 15),然后切换开启或关闭,或更改亮度。完成配置后,点按完成以返回到通用编辑器界面。您将在通用编辑器屏幕上看到所选的起始项目(图 16)。

开灯或关灯。
图 14:开灯或关灯
用于配置亮度控制启动器的亮度滑块控件
图 15:调节亮度
通用自动化操作编辑器,其中显示了列表中新添加的启动方式
图 16:已添加启动方式

添加操作候选对象

如需添加操作候选,请点按添加操作(图 17)。Action Candidates 界面会显示可用的候选操作(图 18)。 选择其中一个候选操作以继续(图 19)。

通用自动化操作编辑器,在启动方式下方显示“添加操作”按钮
图 17:添加操作
候选操作列表
图 18:操作候选项列表
操作选择界面,显示所选设备支持的特征
图 19:选择操作
开灯或关灯
图 20:操作不支持 LevelControlTrait

选择开启或关闭,然后选择让设备开启或关闭。点按完成,返回通用编辑器界面(图 21)。点按保存以创建自动化操作(图 22)。您的自动化操作将显示在“自动化操作”标签页中(图 23)。

开灯或关灯
图 21:开灯或关灯
已添加启动方式和操作。
图 22:已添加启动方式和操作
“自动化操作”标签页,其中显示了新创建的通用自动化操作
图 23:已创建通用自动化操作