
制造业数字孪生看板要求将 MES(制造执行系统)中的实况数据实时映射到三维空间。传统前端图表无法满足“设备位置寻址”需求,因此我们选择 UE5 作为渲染层,通过 WebSocket 将 MES 数据推流至实时看板,实现设备状态闪烁、产量刷新、告警定位。整体架构分为三层:MES 数据源 → WebSocket 网关 → UE5 客户端。客户端内部再拆为“数据总线(Game Instance) → 场景 Actor → UMG 大屏”。
MES 侧通过 MQTT/WebSocket 网关转发 JSON 报文。UE5 从 4.27 开始原生增强 WebSockets 模块,直接使用预编译的 IWebSocket 即可,无需第三方库。在自定义 UGameInstance 中建立连接:
#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();
}数据包的结构为:
{ "MachineID": "MC-01", "State": 1, "Output": 2453.5, "OEE": 87.3 }在 HandleMessage 中,我们使用 FJsonObjectConverter 自动完成 JSON → UStruct 的映射,避免手写解析:
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:
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 是安全的。
大屏 UI 用 UMG 制作,顶部放置统计框,中央是产线透视图。UI 与数据解耦的思路是:写一个 UMESWidget,在 NativeConstruct 中订阅 GameInstance 的广播:
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 秒重试:
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 删除。