生活物联网平台为自有品牌App提供了家空间功能,可以将App绑定的设备按照家庭、房间、设备组等进行空间分组。

功能概述

家空间功能的空间模型中,人、空间、设备三者之间的拓扑关系如下图所示。

jt13

家空间的设备规则

开发家空间服务时,您需要了解以下绑定设备的规则。

类别 规则说明
设备
  • 终端用户首次创建家时,App会将原先存在的设备归属到新创建的家下面。
  • 设备不能独立于家存在,即绑定设备时必须传入homeId
  • 设备可以被归属到房间,也可以独立于房间存在(只归属在家下面)。
  • 被分享的设备属于用户维度的数据,不属于任何一个家。您可以使用/uc/listBindingByAccount接口来获取绑定的设备。
设备组 设备组是归属在同一款产品下的设备集合,可用于组控。
  • 设备组功能目前仅支持灯和插座两个品类。
  • 一个设备组内最少需要存在2个设备,最多存在100个设备。
  • 一个设备只可以添加到一个设备组。
  • 设备组的属性状态更新会触发组内所有设备的属性状态更新;组内单个设备的属性状态更新不会触发设备组属性状态的更新。

    更新设备组状态的接口为/living/controlgroup/properties/set

  • 设备组属性状态与组内单个设备的属性状态存在不一致的情况。

    获取设备组状态的接口为/living/controlgroup/properties/get

API调用限制

生活物联网平台提供了家空间服务相关的一组API,为配合家空间的能力,对原有的部分API进行了升级改造,如下表所示。

  • 如果您的App使用了家空间服务,请使用支持家空间服务的版本API,否则会返回28806的错误码。详细接口请参见配网服务场景服务
  • 如果您的App不使用家空间的服务,请使用不支持家空间服务的历史版本API,否则会返回460错误码。详细接口介绍请参见历史版本配网服务历史版本场景服务
服务 API path 支持家空间服务的版本 不支持家空间服务的版本
配网服务 /awss/token/user/bind 1.0.8及以上 1.0.7及以下
配网服务 /awss/time/window/user/bind 1.0.8及以上 1.0.7及以下
配网服务 /uc/scanBindByShareQrCode 1.0.7及以上 1.0.6及以下
配网服务 /awss/enrollee/user/bind 1.0.3及以上 1.0.2及以下
配网服务 /awss/ble/user/bind 1.0.3及以上 1.0.2及以下
配网服务 /awss/gprs/user/bind 1.0.3及以上 1.0.2及以下
配网服务 /awss/subdevice/bind 1.0.3及以上 1.0.2及以下
场景服务 /living/scene/create 1.0.1及以上 1.0.0
场景服务 /scene/create 1.0.6及以上 1.0.5及以下
场景服务 /scene/info/get 1.0.6及以上 1.0.5及以下