使用 iOS 示例应用

该示例应用展示了如何使用 Home API 来实现设备访问和控制的基本功能,并支持多种设备类型。

完成账号授权并选择结构后,示例应用会加载该结构中找到的所有本地设备。如果设备位于某个房间内,则会列在该房间下方。示例应用支持以下设备类型:

  • 色温灯
  • 可调光灯
  • 门锁
  • Extended Color Light
  • 风扇
  • 在家/外出传感器
  • 开灯/关灯
  • 开启/关闭插接式单元
  • 温度传感器
  • 温控器
  • 窗帘

对现有设备和自动化操作的影响

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

“设备”标签

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

Home iOS API 示例应用的“设备”标签页。
图 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)。系统会显示可用的操作候选对象(图 18)。选择其中一个操作候选项以继续操作(图 19)。

添加操作
图 17:添加操作
操作候选列表
图 18:操作候选列表
选择一项操作。
图 19:选择操作
开灯或关灯
图 20:操作不支持 LevelControlTrait

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

开灯或关灯
图 21:开启或关闭灯
添加了启动方式和操作。
图 22:添加了启动器和操作
已创建通用自动化操作
图 23:创建了通用自动化操作