首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >MES 生产数据接入 UE5:三维可视化大屏实时看板搭建记录

MES 生产数据接入 UE5:三维可视化大屏实时看板搭建记录

原创
作者头像
用户12339161
发布于 2026-11-17 17:07:09
发布于 2026-11-17 17:07:09
160
举报

一、场景与架构

制造业数字孪生看板要求将 MES(制造执行系统)中的实况数据实时映射到三维空间。传统前端图表无法满足“设备位置寻址”需求,因此我们选择 UE5 作为渲染层,通过 WebSocket 将 MES 数据推流至实时看板,实现设备状态闪烁、产量刷新、告警定位。整体架构分为三层:MES 数据源 → WebSocket 网关 → UE5 客户端。客户端内部再拆为“数据总线(Game Instance) → 场景 Actor → UMG 大屏”。

二、基于 WebSocket 的高频实时接入

MES 侧通过 MQTT/WebSocket 网关转发 JSON 报文。UE5 从 4.27 开始原生增强 WebSockets 模块,直接使用预编译的 IWebSocket 即可,无需第三方库。在自定义 UGameInstance 中建立连接:

代码语言:javascript
复制
#include "WebSocketsModule.h"
#include "IWebSocket.h"

UCLASS()
class UMyGameInstance : public UGameInstance
{
    GENERATED_BODY()
    TSharedPtr<IWebSocket> Socket;
public:
    virtual void Init() override;
    void HandleMessage(const FString& Msg);
};

void UMyGameInstance::Init()
{
    Socket = FWebSocketsModule::Get().CreateWebSocket(TEXT("ws://192.168.1.100:8080/stats"));
    Socket->OnConnected().AddLambda([]{ UE_LOG(LogTemp, Log, TEXT("MES Connected")); });
    Socket->OnMessage().AddUObject(this, &UMyGameInstance::HandleMessage);
    Socket->Connect();
}

数据包的结构为:

代码语言:javascript
复制
{ "MachineID": "MC-01", "State": 1, "Output": 2453.5, "OEE": 87.3 }

在 HandleMessage 中,我们使用 FJsonObjectConverter 自动完成 JSON → UStruct 的映射,避免手写解析:

代码语言:javascript
复制
USTRUCT()
struct FMachineData
{
    GENERATED_BODY()
    UPROPERTY() FString MachineID;
    UPROPERTY() int32 State;   // 0停止 / 1运行 / 2故障
    UPROPERTY() float Output;
    UPROPERTY() float OEE;
};

void UMyGameInstance::HandleMessage(const FString& Message)
{
    FMachineData Data;
    FJsonObjectConverter::JsonObjectStringToUStruct(Message, &Data);
    OnMESDataReceived.Broadcast(Data);
}

广播的 OnMESDataReceived 是 DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnMESData, const FMachineData&, Data),让任何 Actor 或 Widget 都能监听。

三、用数据驱动三维场景中的设备

为每台设备创建一个 ADeviceActor 放置在产线三维模型的对应位置。Actor 中持有一个 UMaterialInstanceDynamic,在收到广播事件时改变颜色并更新头顶悬浮 UI:

代码语言:javascript
复制
UPROPERTY(BlueprintAssignable)
FOnMESData OnMESDataReceived;

void ADeviceActor::BeginPlay()
{
    Super::BeginPlay();
    GetGameInstance<UMyGameInstance>()->OnMESDataReceived.AddDynamic(this, &ADeviceActor::ReceiveData);
}

void ADeviceActor::ReceiveData(const FMachineData& Data)
{
    if (Data.MachineID != DeviceID) return;
    static const FName ColorParam(TEXT("BaseColor"));
    FLinearColor NewColor = FLinearColor::Gray;
    if (Data.State == 1) NewColor = FLinearColor::Green;
    else if (Data.State == 2) NewColor = FLinearColor::Red;
    DynamicMat->SetVectorParameterValue(ColorParam, NewColor);
    // 更新头顶标签
    OutputLabel->SetText(FText::AsNumber(Data.Output));
}

由于 GameInstance 的广播可能在任意线程触发(WebSocket 回调线程并非游戏线程),但 UE5 会自动将 AddDynamic 的事件分发到游戏线程,因此直接操作 UMG 和 Mesh 组件的 API 是安全的。

四、UMG 大屏看板实时刷新

大屏 UI 用 UMG 制作,顶部放置统计框,中央是产线透视图。UI 与数据解耦的思路是:写一个 UMESWidget,在 NativeConstruct 中订阅 GameInstance 的广播:

代码语言:javascript
复制
void UMESWidget::NativeConstruct()
{
    UMyGameInstance* GI = GetGameInstance<UMyGameInstance>();
    GI->OnMESDataReceived.AddDynamic(this, &UMESWidget::UpdateUI);
}

void UMESWidget::UpdateUI(const FMachineData& Data)
{
    TotalOutput = TotalOutput + (Data.Output - LastStoredValues.Contains(Data.MachineID) ? LastStoredValues[Data.MachineID] : 0);
    TotalOEE = (TotalOEE * OldMachines + Data.OEE) / NewMachines;
    // 仅更新文本控件
    TextBlock_TotalOutput->SetText(FText::AsNumber(TotalOutput));
}

若要显示告警列表,则维护一个 TArray<FString>,当 State==2 时插入新条目并刷新 UListView。注意每次数据到达不直接 SetText 整个列表,而使用 AddItem 或 SetNum 来避免 GC 卡顿。

五、画面调度与断线保护

实际搭建中遇到两个坑:一是数据频率过高导致 UI 跳变;二是网络波动造成连接断开后数据冻结。针对跳变,在 UMG 中加 500ms 的 Timer 汇总一次数据,把多次更新合并为一次刷新。断线处理则在 GameInstance 中监听 OnClosed,延时 5 秒重试:

代码语言:javascript
复制
Socket->OnClosed().AddLambda([this]()
{
    FTimerHandle Handle;
    GetTimerManager().SetTimer(Handle, [this]()
    {
        if (!Socket->IsConnected())
            Socket->Connect();   // 自动重连
    }, 5.0f, false);
});

另外,因为 UE5 启动时 WebSocket 模块可能未加载,需要在 Build.cs 中加入 "WebSockets"、"JsonUtilities" 依赖。

六、总结

本次平仓记录验证了“WebSocket + UStruct 广播 + UMG 绑定”是一个轻量而稳定的 MES 三维可视化方案。工程价值在于:数据与表现分离,后续若更换数据库或消息中间件,只需改写 GameInstance 中的解析代码,场景与 UI 完全不受影响。落盘文件已附在软件版本库中,可直接作为新项目模板复用。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、场景与架构
    • 二、基于 WebSocket 的高频实时接入
    • 三、用数据驱动三维场景中的设备
    • 四、UMG 大屏看板实时刷新
    • 五、画面调度与断线保护
    • 六、总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档