空间服务

更新时间:2019-07-31 15:31:18

概述

空间是设备在现实世界中的物理位置的抽象,例如,小区、单元、幢、房屋、房间、停车场等是属于不同类型的空间,当一个设备与空间绑定后,代表设备“存在”于这个空间中。

空间是一种树形结构,租户下可以创建多个根空间,即树形结构的根节点,根空间下可以创建多个不同类型的子空间,子空间下也可以递归地创建更多子空间。

空间分为空间实例和空间模板,前者代表一个具体的空间实体,后者则是一种固定的空间框架,用来简化空间批量创建流程,用户可以使用一个空间模板创建出一组相同结构的空间实例。以下空间实例简称空间。

空间服务提供空间与空间模板的管理功能,以及空间&空间模板与用户、设备的关系管理功能。具体包含以下几个部分:

创建空间时,如果希望支持语音控制,参考语音控制的空间结构

空间

提供空间实例的增、删、改、查接口。

空间模板

提供空间模板及其下产品的增、删、改、查,以及根据空间模板创建空间实例的接口。

用户与空间

用户与空间的关系是双向多对多的关系。通过用户与空间的服务接口,可以管理、查询用户与空间的二元关系,并结合其他服务接口关联到设备、场景等实体。

用户与空间模板

用户与空间模板的关系是双向多对多的关系。通过用户与空间模板的服务接口,可以管理、查询用户与空间模板的二元关系。

设备与空间

设备与空间的关系是双向多对一的,即,一个设备至多只能绑定到一个空间,一个空间可以绑定多个设备。通过设备与空间的服务接口,可以管理、查询设备与空间的二元关系。

虚拟设备与空间

虚拟设备相对于真实的物理设备而言,并不需要存在此类设备的实体。主要应用于人居的使用流程的解决方案,且必须与空间绑定。例如:SI在后台通过接口在房屋内添加好虚拟设备,然后把房屋指派给施工人员,施工人员将真实的设备完成配网后,再将虚拟设备替换为真实设备,完成施工。
通过虚拟设备与空间的服务接口,可以完成虚拟设备与空间的绑定、解绑,使用真实设备替换虚拟设备。

空间服务API

参考 API Reference:空间APIAPI Reference:空间模板API

results matching ""

    No results matching ""