105 lines
3.0 KiB
Markdown
105 lines
3.0 KiB
Markdown
# 电梯状态监控功能使用指南
|
||
|
||
## 功能概述
|
||
|
||
电梯状态监控功能允许您：
|
||
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是否正常，确保后端已配置电梯设备。 |