跳到主要内容

节点共享

概述

ESP RainMaker 支持用户通过互联网远程控制节点。但在实际场景中,往往需要允许他人访问同一节点。例如:准许家庭成员控制智能灯泡、临时为租客或保姆开启门锁权限,或是允许多名员工远程访问共享硬件资源。为满足此类需求,ESP RainMaker 提供了节点共享功能。


用户角色

节点共享引入了“用户角色”概念。本节特指终端用户的两种角色:主要用户和次要用户。详细了解二者差异请参阅此文档


用户-节点映射流程

共享节点

  1. 主要用户向 ESP RainMaker 云平台发起节点共享请求。
  2. 被共享用户可查看收到的请求列表,按需选择接受/拒绝。
  3. 主要用户可通过 primary user 标志查看已发起的请求列表,需要时可取消请求。
  4. 请求一旦被接受/拒绝/取消,将不再显示于请求列表。
信息
  • 待处理请求有效期为 7 天,超时未处理将自动删除。
  • 次要用户无权限二次共享节点,仅主要用户具备该权限。
提示

节点共享成功后,次要用户可直接通过手机应用操作节点。


取消共享节点

主要用户可随时解除次要用户的节点共享权限。

信息
  • 主要用户解除自身与节点的关联(该节点存在多名主要用户时),不影响其他用户的节点权限。
  • 唯一主要用户解除自身节点关联,所有次要用户权限将自动解除。
  • 次要用户主动解除节点关联,不影响其他用户的权限状态。
  • 新用户通过配网关联节点时,所有历史共享关系(主/次要用户)将被清除,新用户自动成为主要用户。

查看共享详情

  • 用户(主/次要)可查询已关联节点的共享信息。
  • 每个节点的共享详情包含:节点 ID、主要用户及次要用户列表。

使用指南

体验 ESP RainMaker 节点共享功能可通过两种方式:

  • 手机应用操作
  • ESP RainMaker 命令行工具

手机应用操作

通过 ESP RainMaker 手机应用是最便捷的共享方式。


ESP RainMaker 命令行工具

学习通过命令行实现节点共享,请点击此处


API

详细 API 文档请参阅此处

On this page