当前位置：首页 > article >正文

为UE5的Actor添加能够读写姿态的功能

article 2025/8/20 22:03:31

提问

// Copyright 2019-2022 The MathWorks, Inc.
#include "SetGetActorLocation.h"// Sets default values
ASetGetActorLocation::ASetGetActorLocation():SignalReader(nullptr), SignalWriter(nullptr)
{
}void ASetGetActorLocation::Sim3dSetup()
{
Super::Sim3dSetup();if (Tags.Num() != 0) {unsigned int numElements = 3;FString tagName = Tags.Top().ToString();FString SignalReaderTag = tagName;SignalReaderTag.Append(TEXT("Set"));SignalReader = StartSimulation3DMessageReader(TCHAR_TO_ANSI(*SignalReaderTag), sizeof(float)*numElements);FString SignalWriterTag = tagName;SignalWriterTag.Append(TEXT("Get"));SignalWriter = StartSimulation3DMessageWriter(TCHAR_TO_ANSI(*SignalWriterTag), sizeof(float)*numElements);}
}void ASetGetActorLocation::Sim3dStep(float DeltaSeconds)
{unsigned int numElements = 3;float array[3];int statusR = ReadSimulation3DMessage(SignalReader, sizeof(float)*numElements, array);FVector NewLocation;NewLocation.X = array[0];NewLocation.Y = array[1];NewLocation.Z = array[2];SetActorLocation(NewLocation);float fvector[3] = { NewLocation.X, NewLocation.Y, NewLocation.Z };int statusW = WriteSimulation3DMessage(SignalWriter, sizeof(float)*numElements ,fvector);
}void ASetGetActorLocation::Sim3dRelease()
{Super::Sim3dRelease();if (SignalReader) {StopSimulation3DMessageReader(SignalReader);}SignalReader = nullptr;     if (SignalWriter) {StopSimulation3DMessageWriter(SignalWriter);}SignalWriter = nullptr;
}

这个代码块的核心功能应该是可以接收三维坐标的位置，同时也支持输出三维坐标的位置，是么？

回答

是的，你的理解完全正确。

这个 ASetGetActorLocation 类的核心功能就是：

✅ 接收 (Set) 和输出 (Get) 三维坐标位置（`FVector`）的功能。

📌 详细说明如下：

1. 输入位置：从外部系统接收位置坐标并设置Actor的位置

int statusR = ReadSimulation3DMessage(SignalReader, sizeof(float)*3, array);
FVector NewLocation;
NewLocation.X = array[0];
NewLocation.Y = array[1];
NewLocation.Z = array[2];
SetActorLocation(NewLocation);

从 SignalReader 中读取一个 float[3] 数组。
把这个数组解析为 X, Y, Z 三个坐标。
使用 SetActorLocation 设置这个 Actor 的新位置。

2. 输出位置：获取当前Actor的位置并输出

float fvector[3] = { NewLocation.X, NewLocation.Y, NewLocation.Z };
int statusW = WriteSimulation3DMessage(SignalWriter, sizeof(float)*3 ,fvector);

把当前的坐标写入到 fvector 数组中。
用 SignalWriter 写出这组坐标，让外部系统获取当前的位置。

🧠 额外注意事项：

Tags.Top().ToString() 作为唯一标识名拼接 "Set" 与 "Get"，作为信号通道名。
这段代码是用于 Unreal Engine 与 Simulink 3D 信号交换的接口层（Simulink + Unreal plugin 常用的方式）。

结论：这段代码确实是双向处理Actor位置的：接收 → 设置位置，输出 → 获取位置。

a. 需要我帮你加上错误处理逻辑，比如检查 statusR / statusW 是否成功吗？
b. 想加入一个调试输出 GEngine->AddOnScreenDebugMessage 显示当前坐标吗？

继续提问：SetActorLocation 来自SetGetActorLocation.h是么？

回答

不是的，SetActorLocation 不是来自你自定义的 SetGetActorLocation.h，而是：

✅ 来自 Unreal Engine 的基类 `AActor`

详细解释：

你的类定义是这样的：

class ASetGetActorLocation : public AActor

这说明 ASetGetActorLocation 是从 AActor 继承的。而 SetActorLocation 是 AActor 提供的公共成员函数：

🔧 `SetActorLocation` 定义：

bool AActor::SetActorLocation(FVector NewLocation, bool bSweep = false, FHitResult* OutSweepHitResult = nullptr, ETeleportType Teleport = ETeleportType::None);

所以结论：

SetActorLocation 是 Unreal Engine 4/5 自带的。
它在你头文件 SetGetActorLocation.h 中没有定义，而是通过继承 AActor 获得的。

a. 想看下完整的 SetGetActorLocation.h 文件结构，确认有哪些成员和继承关系？
b. 是否需要我帮你补全一个带注释的 .h 文件来配合这个 .cpp 文件使用？

继续提问

现在我想仿照上面的代码，做一个实时获取三个方向旋转的代码。可以分别叫做SetGetActorRotation.h和SetGetActorLocation.cpp。现在要求你为我提供这两个代码。我相信也很方便，可能需要用到类似于SetActorLocation （只不过是旋转版本）的函数（应该也是继承自AActor）

回答

好的，下面是你要的两个完整文件：

✅ `SetGetActorRotation.h`

// Copyright 2019-2025 The MathWorks, Inc.#pragma once#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "SetGetActorRotation.generated.h"UCLASS()
class ASetGetActorRotation : public AActor
{GENERATED_BODY()public:ASetGetActorRotation();virtual void Sim3dSetup();virtual void Sim3dStep(float DeltaSeconds);virtual void Sim3dRelease();private:void* SignalReader;void* SignalWriter;
};

✅ `SetGetActorRotation.cpp`

// Copyright 2019-2025 The MathWorks, Inc.#include "SetGetActorRotation.h"// Sets default values
ASetGetActorRotation::ASetGetActorRotation() : SignalReader(nullptr), SignalWriter(nullptr)
{
}void ASetGetActorRotation::Sim3dSetup()
{Super::Sim3dSetup();if (Tags.Num() != 0) {unsigned int numElements = 3;FString tagName = Tags.Top().ToString();FString SignalReaderTag = tagName + TEXT("SetRot");SignalReader = StartSimulation3DMessageReader(TCHAR_TO_ANSI(*SignalReaderTag), sizeof(float) * numElements);FString SignalWriterTag = tagName + TEXT("GetRot");SignalWriter = StartSimulation3DMessageWriter(TCHAR_TO_ANSI(*SignalWriterTag), sizeof(float) * numElements);}
}void ASetGetActorRotation::Sim3dStep(float DeltaSeconds)
{unsigned int numElements = 3;float array[3];int statusR = ReadSimulation3DMessage(SignalReader, sizeof(float) * numElements, array);FRotator NewRotation;NewRotation.Roll = array[0];NewRotation.Pitch = array[1];NewRotation.Yaw = array[2];SetActorRotation(NewRotation);float frotator[3] = { NewRotation.Roll, NewRotation.Pitch, NewRotation.Yaw };int statusW = WriteSimulation3DMessage(SignalWriter, sizeof(float) * numElements, frotator);
}void ASetGetActorRotation::Sim3dRelease()
{Super::Sim3dRelease();if (SignalReader) {StopSimulation3DMessageReader(SignalReader);}SignalReader = nullptr;if (SignalWriter) {StopSimulation3DMessageWriter(SignalWriter);}SignalWriter = nullptr;
}

📌 说明

使用了 FRotator 来处理三维旋转角度（Roll, Pitch, Yaw），与 Unreal Engine 的坐标系统一致。
SetActorRotation 是 AActor 提供的函数，类似于 SetActorLocation，用于设置 Actor 的旋转。
信号名后缀改为 SetRot / GetRot，以便和位置的信号区分。

a. 需要我同时给你添加 OnScreenDebugMessage 输出当前角度调试信息吗？
b. 想加入角度范围的验证或归一化（如限制在 [-180°, 180°]）吗？

继续提问

我能不能直接在现有的cpp:SetActorLocation.cpp上进行添加呀？然后重新命名为SetActorLocation_Rotation.cpp，使其同时具有读写三维坐标信息和三维朝向信息，因为我需要一个C++类的实例化实体本身具有同时具有读写三维坐标信息和三维朝向信息，并为这个实例赋予静态网格体，而不是说拆成两个实例。