生活物聯(lián)網(wǎng)平臺(tái)為自有品牌App提供了家空間功能,可以將App綁定的設(shè)備按照家庭、房間、設(shè)備組等進(jìn)行空間分組。

功能概述

家空間功能的空間模型中,人、空間、設(shè)備三者之間的拓?fù)潢P(guān)系如下圖所示。

jt13

家空間的設(shè)備規(guī)則

開(kāi)發(fā)家空間服務(wù)時(shí),您需要了解以下綁定設(shè)備的規(guī)則。

類(lèi)別 規(guī)則說(shuō)明
設(shè)備
  • 終端用戶(hù)首次創(chuàng)建家時(shí),App會(huì)將原先存在的設(shè)備歸屬到新創(chuàng)建的家下面。
  • 設(shè)備不能獨(dú)立于家存在,即綁定設(shè)備時(shí)必須傳入homeId
  • 設(shè)備可以被歸屬到房間,也可以獨(dú)立于房間存在(只歸屬在家下面)。
  • 被分享的設(shè)備屬于用戶(hù)維度的數(shù)據(jù),不屬于任何一個(gè)家。您可以使用/uc/listBindingByAccount接口來(lái)獲取綁定的設(shè)備。
設(shè)備組 設(shè)備組是歸屬在同一款產(chǎn)品下的設(shè)備集合,可用于組控。
  • 設(shè)備組功能目前僅支持燈和插座兩個(gè)品類(lèi)。
  • 一個(gè)設(shè)備組內(nèi)最少需要存在2個(gè)設(shè)備,最多存在100個(gè)設(shè)備。
  • 一個(gè)設(shè)備只可以添加到一個(gè)設(shè)備組。
  • 設(shè)備組的屬性狀態(tài)更新會(huì)觸發(fā)組內(nèi)所有設(shè)備的屬性狀態(tài)更新;組內(nèi)單個(gè)設(shè)備的屬性狀態(tài)更新不會(huì)觸發(fā)設(shè)備組屬性狀態(tài)的更新。

    更新設(shè)備組狀態(tài)的接口為/living/controlgroup/properties/set

  • 設(shè)備組屬性狀態(tài)與組內(nèi)單個(gè)設(shè)備的屬性狀態(tài)存在不一致的情況。

    獲取設(shè)備組狀態(tài)的接口為/living/controlgroup/properties/get

API調(diào)用限制

生活物聯(lián)網(wǎng)平臺(tái)提供了家空間服務(wù)相關(guān)的一組API,為配合家空間的能力,對(duì)原有的部分API進(jìn)行了升級(jí)改造,如下表所示。

服務(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及以下