web-map/docs/elevator-status-guide.md

电梯状态监控功能使用指南

功能概述

电梯状态监控功能允许您：

1. 在地图上创建电梯点并绑定电梯设备
2. 实时监控电梯的运行状态
3. 在状态面板查看所有电梯的详细信息

使用步骤

1. 创建电梯点

1. 在场景编辑器中，选择点位工具
2. 在左侧属性面板中，将点位类型设置为"电梯点"
3. 输入点位标签（如：电梯1）
4. 保存点位

2. 绑定电梯设备

1. 点击已创建的电梯点
2. 在属性面板中找到"电梯设备"下拉框
3. 从下拉列表中选择对应的电梯设备
4. 系统自动保存设备ID

3. 查看电梯状态

方式一：电梯状态面板

1. 在左侧边栏点击"电梯状态"标签
2. 查看所有电梯的：
   • 总数、在线数、离线数、故障数
   • 每个电梯的设备ID、状态、楼层
   • 点击"定位"按钮聚焦到对应电梯点

方式二：地图实时状态

1. 电梯点的颜色会根据状态变化：
   • 蓝色：静止/门已关
   • 绿色：开门中/门已开
   • 紫色：上行中
   • 青色：下行中
   • 橙色：关门中
   • 红色：故障
   • 灰色：离线

方式三：查看详情

1. 点击电梯点
2. 右侧会显示详情卡片，包含：
   • 设备ID
   • 连接状态
   • 当前楼层
   • 电梯运行状态

状态说明

状态	说明	颜色
静止	电梯停止运行	蓝色
开门中	电梯门正在打开	绿色
关门中	电梯门正在关闭	橙色
上行中	电梯正在向上运行	紫色
下行中	电梯正在向下运行	青色
门已开	电梯门已经打开	绿色
门已关	电梯门已经关闭	蓝色
故障	电梯出现故障	红色
离线	电梯失去连接	灰色

WebSocket 数据格式

{
  "id": "2",              // 设备ID（必须与绑定的设备ID一致）
  "type": 102,            // 电梯类型标识（固定值）
  "status": 3,            // 电梯状态码（见状态说明表）
  "floor": 5,             // 当前楼层（可选）
  "isConnected": true     // 连接状态
}

开发环境测试

开发环境已启用模拟数据，包含4个测试电梯：

• 设备ID：2 - 1号电梯
• 设备ID：4 - 2号电梯
• 设备ID：6 - 3号电梯
• 设备ID：8 - 4号电梯

这些设备每3-5秒会自动更新状态，方便测试。

注意事项

1. 电梯点必须绑定设备ID才能接收状态更新
2. 设备ID必须与WebSocket推送的ID完全一致
3. 离线的电梯会显示为灰色
4. 故障电梯会显示为红色并在状态面板中标记

常见问题

Q: 为什么电梯状态没有更新？ A: 检查设备ID是否正确绑定，确保与WebSocket推送的ID一致。

Q: 如何重置电梯状态？ A: 重新加载页面或WebSocket重新连接后会自动获取最新状态。

Q: 设备列表为空怎么办？ A: 检查设备API是否正常，确保后端已配置电梯设备。