。

本教程默认有ROS2导航及其gazebo仿真相关方面基础#xff0c;Nav2相关的学习教程可以参考本人的其他博…前言

本系列教程旨在使用UE5配置一个具备激光雷达深度摄像机的仿真小车并使用通过跨平台的方式进行ROS2和UE5仿真的通讯达到小车自主导航的目的。

本教程默认有ROS2导航及其gazebo仿真相关方面基础Nav2相关的学习教程可以参考本人的其他博客Nav2代价地图实现和原理–Nav2源码解读之CostMap2D(上)-CSDN博客往期教程

第一期基于UE5和ROS2的激光雷达深度RGBD相机小车的仿真指南(一)—UnrealCV获取深度分割图像-CSDN博客第二期基于UE5和ROS2的激光雷达深度RGBD相机小车的仿真指南(二)—ROS2与UE5进行图像数据传输-CSDN博客

UE5系列教程:

第一期:UE5-C入门教程(一)使用代码创建一个指定目标的移动小球-CSDN博客第二期:UE5-C入门教程(二)—编写Editor类别的自定义模型实现小球规划路线的可视化-CSDN博客

本教程环境支持

前两期我们讲了如何使用UnrealCV在UE5中捕获深度分割原始图像并借助rosbridge将图像数据实时传输到ubuntu22.04

ros2

humble中。

本期我们来讲讲如何在UE5中模拟激光雷达的仿真数据。

激光雷达

激光雷达Lidar是一种利用激光来探测和测量物体距离、速度、方位和形状的技术。

它通过发射激光脉冲并接收从目标反射回来的激光从而计算出目标的位置和特性。

激光雷达广泛应用于各种领域如地理信息系统GIS、环境监测、遥感、自动驾驶汽车、考古学等。

发射激光激光雷达系统发射激光脉冲这些脉冲可以是连续波或者脉冲波。

反射激光激光脉冲照射到目标物体后部分光波会被反射回来。

接收反射光激光雷达系统中的接收器会捕捉到反射回来的激光。

数据处理系统通过计算激光发射和接收之间的时间差以及激光的波长来确定目标的距离。

通过分析反射光的强度、频率变化等还可以获取目标的速度、方位和形状等信息。

性能指标

这里我们借助镭神智能公司旗下的16线机械式激光雷达来讲解激光雷达具备的基本参数(这里不是广告(迫真))

激光波长905nm

激光波长是激光雷达发射的激光的波长通常以纳米nm为单位。

常用的波长包括905nm和1550nm。

不同波长的激光具有不同的特性和应用例如905nm波长的激光雷达通常成本较低但容易受到阳光和其他环境因素的干扰而1550nm波长的激光雷达具有更好的抗干扰能力和较长的探测距离。

探测距离70/120/150/200m

探测距离是指激光雷达能够有效测量目标的最远距离。

探测距离受激光功率、目标反射率、大气条件等因素的影响。

通常激光雷达的探测距离从几米到几百米不等。

视场角FOV-

视场角是指激光雷达能够覆盖的水平或垂直角度范围。

水平视场角通常为360度而垂直视场角则取决于激光雷达的具体设计。

视场角越大激光雷达能够感知的环境范围就越广。

测距精度±3cm

测距精度是指激光雷达测量距离的准确程度通常以厘米或毫米为单位。

高精度的激光雷达可以提供非常准确的距离测量这对于需要高精度定位和测量的应用至关重要。

角分辨率垂直2°水平0.09°5Hz,

角分辨率是指激光雷达能够分辨的最小角度变化。

高角分辨率意味着激光雷达可以更细致地描绘目标的形状和轮廓。

角分辨率通常分为水平角分辨率和垂直角分辨率。

出点数-

出点数是指激光雷达每秒钟能够发射的激光点数。

出点数越多激光雷达获取的环境信息越丰富扫描速度越快。

线束16线

线束是指激光雷达在垂直方向上的激光束数量。

多线激光雷达通过多个激光发射器在垂直方向上的分布形成多条线束的扫描。

线束越多对环境的描述越充分。

安全等级

输出参数包括障碍物的位置、速度、方向、时间戳、反射率等这些参数对于后续的数据处理和分析至关重要。

IP防护等级IP67

IP防护等级表示激光雷达对固体颗粒和水的防护能力对于在恶劣环境下工作的激光雷达尤为重要。

功率和供电电压

功率和供电电压决定了激光雷达的能耗和适用场景。

激光雷达的功率通常以瓦特W为单位供电电压则取决于激光雷达的具体设计。

激光发射方式-

激光发射方式分为机械旋转和固态两种。

机械旋转激光雷达通过旋转发射器来扫描环境而固态激光雷达则通过电子方式控制激光束的方向。

使用寿命

使用寿命是指激光雷达在正常工作条件下的预期寿命。

机械旋转激光雷达的使用寿命一般在几千小时而固态激光雷达的使用寿命可高达10万小时。

题外话-旧版本UE5插件支持(不使用)

值得一提的是在UE5的虚幻商城中是存在一款免费的2D雷达仿真插件的但是由于其支持的引擎版本本期我们不使用该插件。

1.创建自定义雷达插件

本小结我们将借助激光雷达的原理不借助任何现成插件尝试在UE5中借助内置函数通过cpp代码实现完成上述激光雷达的仿真。

1-1

提供了一个强大的插件系统允许开发者扩展和定制引擎的功能。

插件可以是社区创建的也可以是

Epic

中这意味着它们可以独立于引擎的其他部分进行开发、编译和更新。

可定制性开发者可以根据自己的需求定制插件添加新的功能或改进现有功能。

可重用性插件可以在不同的项目中重用节省开发时间和资源。

易于安装Unreal

Engine

项目中。

一旦插件被导入开发者可以在项目的插件管理器中启用或禁用插件并根据需要配置插件的设置。

1-2

新建一个新的项目这里取名为Plugins_project选择C而不是蓝图,否则我们将会只有一种类型的插件

打开你的新建的项目(记得确保是C)在左上角菜单栏点击编辑在下拉菜单栏中找到插件在新打开的插件窗口中选择

添加会出现如下画面

VS2022打开项目记得重新加载在项目根目录下会多出一个Plugins文件夹

.uplugin

中的插件描述文件它定义了插件的各种元数据和设置包括插件的名称、版本、描述、作者、加载阶段、模块列表等。

这个文件是插件的重要组成部分它告诉

Unreal

如何加载、集成和管理插件。

我们来关注LaserScannerSim.uplugin这个文件的结尾部分

Modules:

这是模块的名称它应该是独一无二的并且会用作模块的标识符。

在代码中通常会与模块相关的文件和目录同名。

Type:

这表示模块类型为运行时模块。

运行时模块包含在游戏或应用程序的运行时阶段加载的代码和资源。

LoadingPhase:

Default

加载阶段意味着模块将在默认的加载时间点被加载这对于大多数插件来说是合适的。

如果需要更细粒度的控制可以指定其他加载阶段例如

PostLoadMap。

这里我们把这个插件的LoadingPhase改为PostEngineInit,我希望模块在引擎初始化完成后加载。

Modules:

]紧接着我们来看看该插件文件夹下的两个文件夹Public:LaserScannerSim.hpp

Copyright

FLaserScannerSimModule::StartupModule()

{//

FLaserScannerSimModule::ShutdownModule()

{//

LOCTEXT_NAMESPACEIMPLEMENT_MODULE(FLaserScannerSimModule,

ShutdownModule。

这两个函数分别在模块加载到内存后和卸载前调用。

稍后我们将讲述如何运用IModuleInterface类它定义了模块Module在Unreal

1-3

值得注意的是在UE5.4中在上述创建自定义插件后在VS2022进行编译会出现下述报错

Coding

我们来快速思考以下我们要创建的雷达插件应该是可以广泛运用到用户的各类模型(Actor)上用户可以根据调用我们的雷达组件根据其喜好参数把此组件运用到任意模组中可以是车辆或者是雷达模型上。

因此我们要创建一个Componet组件它可以被套用到用户希望的Actor上

2-1

创建组件的详细教程见-UE5-C入门教程(一)使用代码创建一个指定目标的移动小球-CSDN博客

这里我们快速创建一个组件选择ActorComponent作为父类

为新的组件取名为LaserScanner2D注意添加到我们的插件模块下并设置为私有

2-2

这里介绍一个UE5提供的内置函数LineTraceSingleByChannel我们打开官方API手册,搜索得到相关关于这个函数的API实现

用于执行光线投射Line

Tracing。

这个函数可以用来检测从起点到终点之间是否有碰撞并返回碰撞信息。

FHitResult

用于存储光线投射的结果。

如果检测到碰撞这个参数会被填充碰撞信息例如碰撞的位置、碰撞的物体等。

const

FVector

Params这是一个引用参数用于配置光线投射的查询参数允许你设置诸如忽略特定的Actor、检测隐藏的Actor等选项。

const

bool

表示当前世界上下文的对象。

通常你会传递GetWorld()的返回值给这个参数它会返回一个指向当前游戏世界的指针。

LineStart:

直线的起始位置它是一个FVector类型表示三维空间中的一个点。

LineEnd:

直线的结束位置它也是一个FVector类型表示三维空间中的另一个点。

LineColor:

直线的颜色它是一个FLinearColor类型允许你设置红、绿、蓝和透明度。

Duration:

直线在游戏世界中显示的时间以秒为单位。

如果设置为-1.0f直线会一直显示直到下一帧或显式地被清除。

Thickness:

static

那么我们来编写一下雷达组件的实现逻辑LaserScanner2D.hpp,我们为雷达组件添加以下逻辑的代码

FVector

LaserScanner2D.generated.hUCLASS(

ClassGroup(Custom),

meta(BlueprintSpawnableComponent)

class

propertiesULaserScanner2D();protected://

Called

override;private:UPROPERTY(EditAnywhere)FVector

//起始位置UPROPERTY(EditAnywhere)bool

bScanEnabled

//是否使能UPROPERTY(EditAnywhere)int32

Resolution

分辨率每10度检测一次UPROPERTY(EditAnywhere)float

ScanHz

扫描频率每秒30次UPROPERTY(EditAnywhere)float

LaserMinDistance

最近检测距离UPROPERTY(EditAnywhere)float

LaserMaxDistance

最远检测距离UPROPERTY(EditAnywhere)float

1.0f;

};LaserScanner2D.cpp我们在BeginPlay()初始化一个起始位置

#include

ULaserScanner2D::ULaserScanner2D()

{PrimaryComponentTick.bCanEverTick

true;

{Super::BeginPlay();StartRelativeLocation

FVector(0.0f,

}TickComponent将会一直运行我们让其根据我们指定的频率去调用我们写的雷达扫描函数

void

ULaserScanner2D::TickComponent(float

DeltaTime,

{Super::TickComponent(DeltaTime,

TickType,

ScanHz){ScanForObjects();AccumulatedTime

1.0f

Resolution)我们按照指定分辨率去选择扫描Rotation:

这个FRotator对象表示当前射线发射的方向。

它是一个绕Y轴旋转的旋转器其Z轴和X轴的值为0Y轴的值为当前的角度i。

EndLocation:

这是当前射线的结束位置。

它通过将StartLocation与Rotation的向量相加以LaserMaxDistance的长度来计算得出。

FMath::Clamp函数确保这个距离不会超过LaserMaxDistance的最远距离也不会小于LaserMinDistance的最近距离。

OutHit:

这是一个FHitResult对象它用于存储射线与场景中其他对象碰撞的信息。

Params:

这是一个FCollisionQueryParams对象它定义了射线检测的参数。

AddIgnoredActor(GetOwner())调用确保激光雷达不会与自己所在的Actor发生碰撞。

如果检测到膨胀则绘制一条从StartLocation到OutHit.Location的绿色直线。

OutHit.Location是射线碰撞点的位置。

如果没有检测到碰撞则绘制一条从StartLocation到EndLocation的红色直线。

GetWorld():

Engine中GetWorld()是一个成员函数用于获取当前Actor或Component所在的World对象。

World对象是Unreal

Engine中的一个核心概念它代表了游戏世界的环境包括场景中的所有Actor、地形、光照、音效等。

UWorld*

const;GetWorld()成员函数是许多类的接口的一部分尤其是那些与游戏世界直接交互的类。

以下是一些常见的具有GetWorld()函数的类

AActor:

代表附加到Actor上的组件它们通常需要访问游戏世界来进行各种操作。

UGameInstance:

代表游戏世界中的一个关卡。

APlayerController:

代表玩家控制器它可以访问游戏世界来控制玩家视角和输入。

AGameModeBase:

代表游戏模式它定义了游戏的基本规则和流程。

UUserWidget:

代表游戏中的用户界面元素它可能需要访问游戏世界来获取数据或执行操作。

UFieldSystem:

void

ULaserScanner2D::ScanForObjects()

{const

Params;Params.AddIgnoredActor(GetOwner());if

(GetWorld()-LineTraceSingleByChannel(OutHit,

StartLocation,

Params)){DrawDebugLine(GetWorld(),

StartLocation,

debugLineStayDuration);}else{DrawDebugLine(GetWorld(),

StartLocation,

在内容处创建一个蓝图类Lidar(UE教程我们详细见过了这里快速通过)

我们把新的Lidar蓝图类添加到常见中并为主场景添加一些基本的物体

本期我们通过自定义插件的方式实现了激光雷达的仿真下一期我们将讲述如何对雷达数据进行打包并转发给ubuntu的ROS2感谢大家对本教程的支持!如有错误欢迎指出!