生活物联网平台为自有品牌App提供了家空间功能,可以将App绑定的设备按照家庭、房间、设备组等进行空间分组。
功能概述
家空间功能的空间模型中,人、空间、设备三者之间的拓扑关系如下图所示。
家空间的设备规则
开发家空间服务时,您需要了解以下绑定设备的规则。
类别 | 规则说明 |
---|---|
设备 |
|
设备组 | 设备组是归属在同一款产品下的设备集合,可用于组控。
|
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及以下 |