空间管理

更新时间:2024-06-28 05:48:45下载pdf

空间 定义了物联网场景的地理位置、区域、布局信息,以树形结构展示不同智能设备之间的拓扑关系。树形结构的每个节点,都能添加实体资源(主要是智能设备),例如房间里的照明灯具、空调、监控等。

功能作用

空间模型灵活扩展、通用且不限定业务语义,能应对全行业、全场景的业务形态,让您在不同的业务场景中实现更高效的解决方案。在物联网应用开发中,空间 主要承担如下作用:

  • 映射物理空间:例如定义一栋大楼。
  • 管理用户权限:定义空间后,将用户与空间关联、资源与空间关联,通过空间桥接资源与用户的关系。
  • 管理实体资源:空间下,可以添加多种类型资源,例如设备、Mesh 网络等。

结构特点

空间 构建的层级结构,具有以下特点:

  • 呈现出树状多层级结构。
  • 一个空间只有一个根节点。
  • 每个节点只有一个父节点,可以有多个子节点。
  • 每个层级的节点都可以添加资源。
  • 每个资源允许添加在多个节点下。
  • 在同一个空间树下,网关及其子设备可以进入不同层级空间节点。

应用示例

示例一:体育馆空间布局及设备联动

体育馆是一个多功能场所,包含了不同层级的空间,如体育馆厅、楼层和不同的球类室。通过在空间模型中构建这些空间,可以实现设备联动,例如控制灯光和篮球场记分板。

下图展示的是一个空间结构示例,其中体育场为根节点,一层(包含篮球场)和二层(包含乒乓球室、羽毛球场)为子节点:

体育馆部分空间模型
体育馆
二层
一层
乒乓球室
羽毛球场
篮球场
灯 1
灯 2
记分板
视频监控
入门道闸

通过 空间 模型构建以上结构,可以实现:

  • 设置体育馆为整个空间的最顶层,包含一层和二层两个楼层。
  • 标记在一层的篮球场和对应的记分板,以及视频监控设备。
  • 标记在二层的乒乓球室和羽毛球场以及对应的照明设备。
  • 将入门道闸作为体育馆的访问控制入口,以实现照明设备、记分板设备的场景联动。

示例二:智慧公寓的数字化空间构建

智慧公寓是一种常见的商业场景,可能涉及公寓、单元、楼栋、房号、公共区域等维度的空间。某个住户既需要其所在房号的设备权限,也需要相关公共空间区域的设备权限,以此实现房间的设备与公共区域的设备之间的联动。

下图展示的是一个空间结构示例,其中公寓为根节点,A 座、一单元、一楼(包含 101 室和 102 室)为子节点:

A 座部分区域空间模型
进入 101 室
被分享
一楼
一单元
A 座
公寓
101 室 
102 室 
公区走廊
联动
设备 1(入户灯)
设备 3(走廊灯)
C 端用户

通过 空间 模型构建以上结构,可以实现:

  • 设置 公寓 > 楼栋 > 单元 > 楼层 > 的五层结构,表示物理世界的布局和逻辑关系。
  • 支持给用户授予特定房间的权限,例如 101 室。
  • 支持给用户授予特定设备的权限,例如设备 3。
  • 支持灵活创建不同空间下的设备联动规则。

在这个空间模型上,还方便后续进一步扩展和迭代功能,例如:

  • 添加门禁系统:在每个楼栋的入口处添加门禁系统,使得只有授权的人员才能进入楼栋。
  • 人脸识别技术:将门锁设备升级为带有人脸识别功能的设备,以增强安全性,并且使住户能够更加便捷地进入房间。
  • 智能家居控制:将智能家居设备(例如照明、空调)与空间模型相连,使住户可以通过 App 或语音指令控制房间内的各种设备。
  • 能源管理:添加能源管理系统,可以监测和控制房间内的能源使用情况,以实现节能和降低使用成本。
  • 安全监控:在楼栋和公共区域添加监控摄像头,用于安全监控和记录,以提高整个智慧公寓的安全性。
  • 社交互动:为住户提供一个社交平台,使住户能够互相交流和共享信息,增进社区的互动和友好氛围。

通过不断扩展和增强功能,智慧公寓的居住体验会更加便捷和舒适,同时提高住户的安全性和生活质量。

API 列表

API 路径
删除空间 DELETE:/v2.0/cloud/space/{space_id}
查询空间下资源列表 GET:/v2.0/cloud/space/{space_id}/resource
创建空间 POST:/v2.0/cloud/space/creation
查询空间 GET:/v2.0/cloud/space/{space_id}
查询空间节点列表 GET:/v2.0/cloud/space/child
修改空间信息 PUT:/v2.0/cloud/space/{space_id}
判断父子节点关系 GET:/v2.0/cloud/space/relation

使用限制

限制项 最高限制
单空间节点下设备数 100 个
单空间的子节点数量 100 个
空间层级 10 级

最佳实践

详情请参考 IoT Core 设备管理实践

常见问题

空间、家庭、资产之间有什么差异?

在涂鸦的某些业务场景中,经常会出现 家庭资产 的概念,两者是 空间 的上层业务包装。空间 是更抽象的一层模型,只保留了最基础的拓扑结构、资源关联等数据,并不会包含 资产家庭 的上层业务数据,例如家庭下的房间。

  • 如果您有获得上层业务数据的需求,请参考 资产管理全屋管理

  • 为了让空间模型也能应用在上层业务中,涂鸦也提供了业务升级能力,可以帮助您将底层 空间 升级为上层的 资产家庭。这样您可以无缝衔接使用上层业务能力,例如 OEM App 等。