生活物聯(lián)網(wǎng)平臺(tái)為自有品牌App提供了家空間功能,可以將App綁定的設(shè)備按照家庭、房間、設(shè)備組等進(jìn)行空間分組。
功能概述
家空間功能的空間模型中,人、空間、設(shè)備三者之間的拓?fù)潢P(guān)系如下圖所示。
家空間的設(shè)備規(guī)則
開(kāi)發(fā)家空間服務(wù)時(shí),您需要了解以下綁定設(shè)備的規(guī)則。
類(lèi)別 | 規(guī)則說(shuō)明 |
---|---|
設(shè)備 |
|
設(shè)備組 | 設(shè)備組是歸屬在同一款產(chǎn)品下的設(shè)備集合,可用于組控。
|
API調(diào)用限制
生活物聯(lián)網(wǎng)平臺(tái)提供了家空間服務(wù)相關(guān)的一組API,為配合家空間的能力,對(duì)原有的部分API進(jìn)行了升級(jí)改造,如下表所示。
- 如果您的App使用了家空間服務(wù),請(qǐng)使用支持家空間服務(wù)的版本API,否則會(huì)返回28806的錯(cuò)誤碼。詳細(xì)接口請(qǐng)參見(jiàn)配網(wǎng)服務(wù)和場(chǎng)景服務(wù)。
- 如果您的App不使用家空間的服務(wù),請(qǐng)使用不支持家空間服務(wù)的歷史版本API,否則會(huì)返回460錯(cuò)誤碼。詳細(xì)接口介紹請(qǐng)參見(jiàn)歷史版本配網(wǎng)服務(wù)和歷史版本場(chǎng)景服務(wù)。
服務(wù) | API path | 支持家空間服務(wù)的版本 | 不支持家空間服務(wù)的版本 |
---|---|---|---|
配網(wǎng)服務(wù) | /awss/token/user/bind | 1.0.8及以上 | 1.0.7及以下 |
配網(wǎng)服務(wù) | /awss/time/window/user/bind | 1.0.8及以上 | 1.0.7及以下 |
配網(wǎng)服務(wù) | /uc/scanBindByShareQrCode | 1.0.7及以上 | 1.0.6及以下 |
配網(wǎng)服務(wù) | /awss/enrollee/user/bind | 1.0.3及以上 | 1.0.2及以下 |
配網(wǎng)服務(wù) | /awss/ble/user/bind | 1.0.3及以上 | 1.0.2及以下 |
配網(wǎng)服務(wù) | /awss/gprs/user/bind | 1.0.3及以上 | 1.0.2及以下 |
配網(wǎng)服務(wù) | /awss/subdevice/bind | 1.0.3及以上 | 1.0.2及以下 |
場(chǎng)景服務(wù) | /living/scene/create | 1.0.1及以上 | 1.0.0 |
場(chǎng)景服務(wù) | /scene/create | 1.0.6及以上 | 1.0.5及以下 |
場(chǎng)景服務(wù) | /scene/info/get | 1.0.6及以上 | 1.0.5及以下 |