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

## 功能概述

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

## 使用步骤

### 1. 创建电梯点

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

### 2. 绑定电梯设备

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

### 3. 查看电梯状态

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

#### 方式二：地图实时状态
1. 电梯点的颜色会根据状态变化：
   - 蓝色：静止/门已关
   - 绿色：开门中/门已开
   - 紫色：上行中
   - 青色：下行中
   - 橙色：关门中
   - 红色：故障
   - 灰色：离线

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

## 状态说明

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

## WebSocket 数据格式

```json
{
  "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是否正常，确保后端已配置电梯设备。