连接

Home API 的某些功能因网络连接状态和是否存在集线器而异。

表 1 和表 2 指明了在不同条件下适用于不同类型设备的用例。

  • 本地是指用户在与设备连接到同一 Wi-Fi 网络的情况下运行控制器(例如 Google Home app (GHA))或第三方应用(换句话说,用户在家中)。
  • 远程表示用户符合以下条件之一:

    • 在单独的 Wi-Fi 网络上运行控制器(例如 GHA)或第三方应用(也就是说,当用户外出时),或者
    • 使用 Google Home for web
表 1:当集线器处于“在线”状态时 Home API 连接功能
使用场景 Matter 设备类型 Cloud 设备类型
局部 远程 局部 远程
佣金和添加设备 不适用 不适用
添加设备 不适用 不适用
查看设备状态
控制设备
使用设备创建自动化操作
通过设备运行自动化操作
表 2:当集线器处于离线状态时 Home API 连接功能
使用场景 Matter 设备类型 Cloud 设备类型
局部 远程 局部 远程
佣金和添加设备 不适用 不适用
添加设备 不适用 不适用
查看设备状态
控制设备
使用设备创建自动化操作
通过设备运行自动化操作
将设备分配到其他房间
移除设备