使用SaasDemo

更新时间:2020-01-04 16:21:20

SaaSDemo是用智能人居平台的PaaS API搭建的演示系统。下面介绍SaaS Demo的功能以及功能对应的API。

回顾

智能人居平台除了设备接入以及设备生命周期管理,主要提供了四个基本实体的关系维护能力,和边缘网关的开发能力。回顾一下四个基本实体是:用户、空间、设备和场景,如下图:
image.png
ISV在开发时,原则上要在头脑中建立上图中的关系模型。


举例来说:

  • 用户是所有关系的核心,用“人”来组织4个关系实体;

  • 如果用户绑定了设备空间,则需要把设备空间的关系也维护起来;

  • 空间与场景的关系,同上;

功能

品类管理

品类管理中是智能人居平台支持分级品类和产品的查询能力。

品类

image.png

API

  1. 查询品类列表
  2. 查询产品列表

产品TSL

image.png

API

  1. 获取产品TSL

用户管理

账号

展示和管理当前租户下的账号
image.png

API

  1. 三方账号导入
  2. 根据三方提供的openId查询IoT
  3. 批量获取账号详情

用户

image.png

用户与其它实体关联时,需要输入用户信息。对于不同的用户标识类型:

  • OPEN:三方账号标识 openID

  • OA:OpenAccountsID

  • OA_PHONE:内置账号体系的用户手机号

  • IOT:阿里云IoT的统一用户标识

关联的场景

展示当前用户的关联场景
image.png

API

  1. 查询用户的场景
  2. 在云端部署/撤销场景
  3. 解绑用户和场景 - 把场景和当前的用户关系解绑掉
  4. 查看详情:场景详情

关联的设备

展示当前用户的关联设备
image.png

API

  1. 查询用户的设备
  2. 查看详情:设备详情

关联的空间

展示当前用户的关联空间
image.png

API

  1. 查询用户的空间

关联的边缘网关

image.png

API

  1. 查询人的边缘网关

设备管理

设备

image.png

API

  1. 查询设备
  2. 根据PK、DN查询设备信息
  3. 绑定公区设备
  4. 设备详情:跳转
  5. 边缘网关详情:跳转

设备详情

image.png

API

  1. 查询设备详情
  2. 更新设备的备注名
  3. 获取设备TSL
  4. 重置设备
  5. 查询网关的子设备
  6. 查询子设备网关

关联的用户

image.png

API

  1. 查询设备的用户(带角色)
  2. 绑定用户与设备
  3. 授予用户对某设备的权限
  4. 解绑用户与设备
  5. 查询详情:跳转

空间管理

空间

image.png
API

  1. 查询租户根空间列表
  2. 创建顶层空间
  3. 查看详情:跳转

空间详情

image.png

API

  1. 查询子空间
  2. 获取空间
  3. 创建子空间
  4. 绑定设备与空间
  5. 查询空间的设备
  6. 解绑设备与空间
  7. 查看详情:设备详情

关联的用户

image.png

API

  1. 绑定用户与空间
  2. 查询空间的用户
  3. 解绑用户与空间
  4. 查看详情:用户详情

关联的场景

image.png

API

  1. 绑定空间和场景
  2. 解绑空间的所有场景
  3. 查询空间的场景
  4. 解绑空间的场景
  5. 查看详情:场景详情

关联的边缘网关

查询空间的边缘网关类型设备。
image.png

API

  1. 查询空间的边缘网关
  2. 查看详情:边缘网关

场景管理

场景

image.png

API

  1. 查询场景
  2. 在云端部署/撤销场景
  3. 删除场景
  4. 执行场景
  5. 编辑:跳转
  6. 详情:跳转
  7. 新建场景
    1. 获取符合TCA功能的设备列表
      1. 按用户维护查询时:查询符合TCA条件的用户设备
    2. 创建场景

场景详情

image.png

API

  1. 执行场景
  2. 获取场景
  3. 查看设备详情:跳转

关联和用户

image.png

API

  1. 绑定用户和场景:用户表示见用户
  2. 查询场景的用户

编辑场景

image.png
image.png

API

  1. 获取符合TCA功能的设备列表
    1. 按用户维护查询时:查询符合TCA条件的用户设备
  2. 更新场景TCA / 更新场景的基本信息

边缘网关管理

边缘网关

image.png

API

  1. 查询租户的边缘网关
  2. 设备详情:跳转
  3. 边缘网关详情:跳转

网缘网关详情

image.png

API

  1. 设备详情
  2. 向边缘网关配置中添加设备
  3. 查询已经加入到边缘网关配置下的子设备列表
  4. 清空边缘网关上的配置
  5. 重置设备
  6. 推送配置到边缘网关设备
  7. 从边缘网关配置中删除设备

网关下未关联子设备

image.png

API

  1. 查询边缘网关已连接但未加入到配置下的子设备列表
  2. 从边缘网关配置中删除设备

关联的场景

image.png

API

  1. 向边缘网关配置中添加场景
  2. 查询边缘网关配置中的场景
  3. 从边缘网关配置中删除场景

日志管理

image.png
提供场景执行日志、业务日志和设备日志的实时接收。

操作:

  • 开始建立连接

  • 结束断开连接

  • 清空清除所有接收到的日志

  • 搜索按关键字过滤日志

注意,日志订阅是租户级的,所有建立连接的接收端组成了日志消费集群。如果租户下已经有了日志接收集群,不建议启动这个功能。强行开启会导致原集群日志接收不完整。
这个功能在ISV刚接触人居平台时,用来了解和掌握平台的使用方法,不建议用于生产和日常调试。

FAQ

接入的设备可以直接使用吗

可以!
一般的设备是通过手机APP配网接入智能人居平台的。所以初始情况下,设备会和操作的用户建立关系。通过查询用户的设备API可以查询到。

设备的控制,实际是由租户发起的,所以只有设备没有重置/删除,就可以控制。ISV要负责维护设备与用户的权限关系,云端不做用户与设备关系的校验。

如果设备需要被语音面板等中控类控制,则需要把设备与空间节点做关联操作。如何建立有效的空间结构,见《语音控制的空间结构》介绍

接入的语音设备可以马上使用吗

如果语音设备是中控类设备,如语音面板,需要把语音设备绑定在房屋或房间类型的空间节点下。控制的范围会限制在房屋以下其下连续的不多于4层的房间节点范围。

详细说明见《语音控制的空间结构》。

删除设备对场景的影响

执行重置/删除设备后,会检查对应的场景,并尝试从场景脚本中删除对应的设备。

如果设备删除后,场景脚本不完整,如无法执行(无action)则会直接删除场景。删除动作会通过消息发送给ISV服务,消息说明

results matching ""

    No results matching ""