可视化大屏系列(5):设备状态面板与数据分析仪表盘

文章目录:
- 一、项目背景与功能概述
- 二、设备状态数据采集与接口设计
- 三、仪表盘组件封装与调用
- 四、工况统计图表设计与实现
- 五、告警与预警机制集成
- 六、视觉表现优化与交互细节
- 七、总结与后续优化方向
一、项目背景与功能概述
在智慧工地系统中,设备状态监测与工况统计是确保施工效率与安全的关键环节。本篇将围绕“设备状态可视化”与“数据仪表盘分析”,介绍如何基于 Vue3 + ECharts 打造高性能、易维护的数据展示面板,提升数据洞察与现场响应能力。
1. 项目代码结构
为了保持项目的整洁与可维护性,我们的代码结构应该符合常见的 Vue 3 项目规范,下面是完整的代码仓库结构示例:
├── src
│ ├── assets # 项目静态资源(图片、图标等)
│ ├── components # 可复用组件
│ │ ├── Dashboard
│ │ │ ├── EChartGauge.vue # 仪表盘组件
│ │ ├── DevicePanel.vue # 设备面板
│ ├── api # 请求接口封装
│ │ └── device.ts # 设备接口
│ ├── views # 页面组件
│ │ └── Dashboard.vue # 仪表盘展示页面
│ ├── utils # 工具类(如请求、格式化等)
│ │ └── request.ts # 请求封装
│ ├── App.vue # 根组件
│ └── main.ts # 入口文件
└── public
└── index.html # HTML入口文件
代码说明:
src/components/Dashboard/EChartGauge.vue:封装的仪表盘组件。src/api/device.ts:设备接口模块,负责设备状态数据的获取。src/views/Dashboard.vue:仪表盘页面,展示设备状态的多个图表组件。src/utils/request.ts:用于封装请求方法,简化接口调用。src/main.ts:项目的入口文件,初始化 Vue 实例。
二、设备状态数据采集与接口设计
设备状态通常通过物联网采集网关(如 PLC、RTU、传感器集线器)上传,经过边缘网关汇总后推送至后端系统,前端通过定时轮询或 WebSocket 获取。
1. 数据结构定义
后端应设计清晰、可拓展的设备数据结构,例如:
// 接口返回示例(单设备)
{
deviceId: "DZ-001",
name: "塔吊 01",
status: "运行中", // 停止/故障/维修/离线...
voltage: 220,
temperature: 36.5,
runningTime: 315, // 单位分钟
lastUpdate: "2025-04-21 14:03:00"
}
2. 后端接口设计规范
推荐使用 RESTful 风格,接口统一前缀 /api/device:
| 方法 | 接口地址 | 描述 |
|---|---|---|
GET |
/api/device/status/list |
获取设备状态列表 |
GET |
/api/device/status/:id |
获取指定设备状态 |
GET |
/api/device/stats/runtime |
获取运行时长统计数据 |
GET |
/api/device/stats/alarm |
获取告警数据统计 |
3. 前端接口封装(/src/api/device.ts)
为了便于调用和维护,封装成模块化接口:
// src/api/device.ts
import request from '@/utils/request'
// 获取所有设备当前状态
export const getDeviceStatusList = () => {
return request.get('/api/device/status/list')
}
// 获取单个设备状态详情
export const getDeviceStatusById = (id: string) => {
return request.get(`/api/device/status/${
id}`)
}
// 获取设备运行时长统计数据
export const getDeviceRuntimeStats = () => {
return request.get('/api/device/stats/runtime')
}
4. 示例:获取设备状态列表并绑定图表组件
// src/views/dashboard/DevicePanel.vue
import {
getDeviceStatusList } from '@/api/device'
import {
ref, onMounted } from 'vue'
const deviceList = ref([])
const fetchDeviceStatus = async () => {
try {
const res = await getDeviceStatusList()
deviceList.value = res.data
} catch (error) {
console.error('设备状态获取失败:', error)
}
}
onMounted(() => {
fetchDeviceStatus()
})
5. 实时数据更新方案(定时轮询 + WebSocket)
✅ 方案 A:定时轮询刷新设备状态(适合中低频设备)
onMounted(() => {
fetchDeviceStatus()
setInterval(fetchDeviceStatus, 10000) // 每10秒刷新一次
})
✅ 方案 B:WebSocket 实时推送(适合状态变更频繁场景)
let ws = new WebSocket('wss://example.com/ws/device/status')
ws.onmessage = (msg) => {
const newStatus = JSON.parse(msg.data)
const index = deviceList.value.findIndex(d => d.deviceId === newStatus.deviceId)
if (index > -1) {
deviceList.value[index] = newStatus
} else {
deviceList.value.push(newStatus)
}
}
6. 异常状态字段说明与 UI 标识
设备的运行状态不仅是“运行/停止”,还可能包括异常、预警、维护中等状态,可定义状态枚举与颜色提示:
const statusMap = {
'运行中': 'success',
'停止': 'info',
'故障': 'danger',
'预警': 'warning',
'离线': 'gray'
}
配合 UI 展示:
<el-tag :type="statusMap[item.status]">{
{ item.status }}</el-tag>
7. 最佳实践建议
- 每条设备数据应包含时间戳字段
lastUpdate,用于判断是否超时或离线; - 为每种设备类型设置不同的图表模板与颜色;
- WebSocket 仅用于状态变更通知,详细数据仍可通过接口拉取;
- 可引入缓存策略减少频繁请求(如 Vue Query/SWR)。
好的,继续写 “三、仪表盘组件封装与调用”,并配合完整的代码仓库结构说明。
三、仪表盘组件封装与调用
1. 仪表盘组件封装
1.1 仪表盘组件设计
我们将使用 uView UI 和 ECharts 来实现一个通用的仪表盘组件。uView UI 提供了常用的 UI 控件,ECharts 可以帮助我们更好地呈现图表数据。
<!-- src/components/Dashboard/EChartGauge.vue -->
<template>
<div class="dashboard-container">
<div ref="chart" class="dashboard-chart"></div>
</div>
</template>
<script>
import * as echarts from 'echarts'
export default {
name: 'EChartGauge',
props: {
value: {
type: Number,
required: true
},
minValue: {
type: Number,
default: 0
},
maxValue: {
type: Number,
default: 100
},
title: {
type: String,
default: '设备状态'
}
},
mounted() {
this.renderChart()
},
watch: {
value() {
this.renderChart()
}
},
methods: {
renderChart() {
const chart = echarts.init(this.$refs.chart)
const option =<
2297



被折叠的 条评论
为什么被折叠?



