【虚幻引擎UE】UE5 蓝图/C++绘制图形（球体绘制为例）

已于 2023-08-01 17:34:26 修改
阅读量3.4k 收藏 6
点赞数 3
CC 4.0 BY-SA版权
分类专栏： 虚幻引擎UE5 常见问题合集2 文章标签： 虚幻 ue5 c++
于 2022-11-27 01:10:02 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_35079107/article/details/128052239
本文介绍了如何在虚幻引擎UE5中使用C++代码和蓝图进行球体绘制，包括网格球体和球体模型的创建过程，并提供拓展学习内容，如UE4的屏幕绘制技巧。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

一、网格球体绘制

在这里插入图片描述
在这里插入图片描述
center 中心点向量
segments参数越大，线条越多
radius是球体半径
thickness 厚度可以不用管
Depth Priority 是渲染深度可以不用管
F Life Time 是持续时间

C++代码如下——

.cpp

#include "drawBallFunc.h"
#include "Components/LineBatchComponent.h"
#include "Engine/World.h"
#include "EngineGlobals.h"
#include "PrimitiveViewRelevance.h"
#include "PrimitiveSceneProxy.h"
#include "Engine/Engine.h"
#include "MaterialShared.h"
#include "Materials/Material.h"
#include "Engine/CollisionProfile.h"
#include "SceneManagement.h"
#include "DynamicMeshBuilder.h"

void UdrawBallFunc::drawCustomBallFunc(UObject* WorldContextObject, const FVector& Center, int32 Segments, float Radius, const FColor& Color, uint8 DepthPriority, float fLifeTime, float Thickness)
{

	ULineBatchComponent* const LineBatcher = WorldContextObject->GetWorld()->PersistentLineBatcher;
	//LineBatcher->DrawCircle(Center, X, Y, Color, Radius, Segments, DepthPriority);
	//LineBatcher->DrawPoint(Center, Color, Radius, DepthPriority, fLifeTime);
	// Need at least 4 segments
	Segments = FMath::Max(Segments, 4);

	FVector Vertex1, Vertex2, Vertex3, Vertex4;
	const float AngleInc = 2.f * PI / float(Segments);
	int32 NumSegmentsY = Segments;
	float Latitude = AngleInc;
	int32 NumSegmentsX;
	float Longitude;
	float SinY1 = 0.0f, CosY1 = 1.0f, SinY2, CosY2;
	float SinX, CosX;

	TArray<FBatchedLine> Lines;
	Lines.Empty(NumSegmentsY * Segments * 2);
	while (NumSegmentsY--)
	{
		SinY2 = FMath::Sin(Latitude);
		CosY2 = FMath::Cos(Latitude);

		Vertex1 = FVector(SinY1, 0.0f, CosY1) * Radius + Center;
		Vertex3 = FVector(SinY2, 0.0f, CosY2) * Radius + Center;
		Longitude = AngleInc;

		NumSegmentsX = Segments;
		while (NumSegmentsX--)
		{
			SinX = FMath::Sin(Longitude);
			CosX = FMath::Cos(Longitude);

			Vertex2 = FVector((CosX * SinY1), (SinX * SinY1), CosY1) * Radius + Center;
			Vertex4 = FVector((CosX * SinY2), (SinX * SinY2), CosY2) * Radius + Center;

			Lines.Add(FBatchedLine(Vertex1, Vertex2, Color, fLifeTime, Thickness, DepthPriority));
			Lines.Add(FBatchedLine(Vertex1, Vertex3, Color, fLifeTime, Thickness, DepthPriority));

			Vertex1 = Vertex2;
			Vertex3 = Vertex4;
			Longitude += AngleInc;
		}
		SinY1 = SinY2;
		CosY1 = CosY2;
		Latitude += AngleInc;
	}
	LineBatcher->DrawLines(Lines);
}

.h

// Fill out your copyright notice in the Description page of Project Settings.

#pragma once

#include "CoreMinimal.h"
#include "Kismet/BlueprintFunctionLibrary.h"
#include "drawBallFunc.generated.h"

/**
 *
 */
UCLASS()
class DRAWBALL_API UdrawBallFunc : public UBlueprintFunctionLibrary
{
	GENERATED_BODY()
		UFUNCTION(BlueprintCallable, Category = "Custom", meta = (Keywords = "draw"))
		static void drawCustomBallFunc(UObject* WorldContextObject, const FVector& Center, int32 Segments, float Radius, const FColor& Color, uint8 DepthPriority, float fLifeTime, float Thickness);
};

二、球体模型绘制

在这里插入图片描述

1、创建一个默认球体
在这里插入图片描述
2、创建球体对象生成器，并输入缩放向量（后面根据需要，也可以补充一下材质替换的代码）
在这里插入图片描述3、传入半径*2是最终尺寸 在这里插入图片描述

三、拓展学习

UE4 C++ 在屏幕上绘制线和文字的方法

拓展绘制方法！！！

绘制函数 Debug drawing functions相关方法 （仅限于开发调试和参考）：

FORCEINLINE void FlushPersistentDebugLines(const UWorld* InWorld) {}
FORCEINLINE void DrawDebugLine(const UWorld* InWorld, FVector const& LineStart, FVector const& LineEnd, FColor const& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawDebugPoint(const UWorld* InWorld, FVector const& Position, float Size, FColor const& PointColor, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0) {}
FORCEINLINE void DrawDebugDirectionalArrow(const UWorld* InWorld, FVector const& LineStart, FVector const& LineEnd, float ArrowSize, FColor const& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawDebugBox(const UWorld* InWorld, FVector const& Center, FVector const& Extent, FColor const& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawDebugBox(const UWorld* InWorld, FVector const& Center, FVector const& Extent, const FQuat& Rotation, FColor const& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawDebugCoordinateSystem(const UWorld* InWorld, FVector const& AxisLoc, FRotator const& AxisRot, float Scale, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawDebugCrosshairs(const UWorld* InWorld, FVector const& AxisLoc, FRotator const& AxisRot, float Scale, const FColor& Color = FColor::White, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0) {}
FORCEINLINE void DrawDebugCircle(const UWorld* InWorld, const FMatrix& TransformMatrix, float Radius, int32 Segments, const FColor& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f, bool bDrawAxis = true) {}
FORCEINLINE void DrawDebugCircle(const UWorld* InWorld, FVector Center, float Radius, int32 Segments, const FColor& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f, FVector YAxis = FVector(0.f, 1.f, 0.f), FVector ZAxis = FVector(0.f, 0.f, 1.f), bool bDrawAxis = true) {}
FORCEINLINE void DrawDebugCircleArc(const UWorld* InWorld, FVector const& Center, float Radius, FVector const& Direction, float AngleWidth, int32 Segments, const FColor& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawDebug2DDonut(const UWorld* InWorld, const FMatrix& TransformMatrix, float InnerRadius, float OuterRadius, int32 Segments, const FColor& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawDebugSphere(const UWorld* InWorld, FVector const& Center, float Radius, int32 Segments, FColor const& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawDebugCylinder(const UWorld* InWorld, FVector const& Start, FVector const& End, float Radius, int32 Segments, FColor const& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawDebugCone(const UWorld* InWorld, FVector const& Origin, FVector const& Direction, float Length, float AngleWidth, float AngleHeight, int32 NumSides, FColor const& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawDebugAltCone(const UWorld* InWorld, FVector const& Origin, FRotator const& Rotation, float Length, float AngleWidth, float AngleHeight, FColor const& DrawColor, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawDebugString(const UWorld* InWorld, FVector const& TextLocation, const FString& Text, class AActor* TestBaseActor = NULL, FColor const& TextColor = FColor::White, float Duration = -1.000000, bool bDrawShadow = false, float FontScale = 1.f) {}
FORCEINLINE void DrawDebugFrustum(const UWorld* InWorld, const FMatrix& FrustumToWorld, FColor const& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0.f) {}
FORCEINLINE void DrawCircle(const UWorld* InWorld, const FVector& Base, const FVector& X, const FVector& Y, const FColor& Color, float Radius, int32 NumSides, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0) {}
FORCEINLINE void DrawDebugCapsule(const UWorld* InWorld, FVector const& Center, float HalfHeight, float Radius, const FQuat& Rotation, FColor const& Color, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0, float Thickness = 0) {}
FORCEINLINE void DrawDebugCamera(const UWorld* InWorld, FVector const& Location, FRotator const& Rotation, float FOVDeg, float Scale = 1.f, FColor const& Color = FColor::White, bool bPersistentLines = false, float LifeTime = -1.f, uint8 DepthPriority = 0) {}
FORCEINLINE void FlushDebugStrings(const UWorld* InWorld) {}
FORCEINLINE void DrawDebugSolidBox(const UWorld* InWorld, FBox const& Box, FColor const& Color, const FTransform& Transform = FTransform::Identity, bool bPersistent = false, float LifeTime = -1.f, uint8 DepthPriority = 0) {}
FORCEINLINE void DrawDebugSolidBox(const UWorld* InWorld, FVector const& Center, FVector const& Extent, FColor const& Color, bool bPersistent = false, float LifeTime = -1.f, uint8 DepthPriority = 0) {}
FORCEINLINE void DrawDebugSolidBox(const UWorld* InWorld, FVector const& Center, FVector const& Extent, FQuat const& Rotation, FColor const& Color, bool bPersistent = false, float LifeTime = -1.f, uint8 DepthPriority = 0) {}
FORCEINLINE void DrawDebugMesh(const UWorld* InWorld, TArray<FVector> const& Verts, TArray<int32> const& Indices, FColor const& Color, bool bPersistent = false, float LifeTime = -1.f, uint8 DepthPriority = 0) {}
FORCEINLINE void DrawDebugSolidPlane(const UWorld* InWorld, FPlane const& P, FVector const& Loc, float Size, FColor const& Color, bool bPersistent = false, float LifeTime = -1, uint8 DepthPriority = 0) {}
FORCEINLINE void DrawDebugSolidPlane(const UWorld* InWorld, FPlane const& P, FVector const& Loc, FVector2D const& Extents, FColor const& Color, bool bPersistent = false, float LifeTime = -1, uint8 DepthPriority = 0) {}
FORCEINLINE void DrawDebugFloatHistory(UWorld const & WorldRef, FDebugFloatHistory const & FloatHistory, FTransform const & DrawTransform, FVector2D const & DrawSize, FColor const & DrawColor, bool const & bPersistent = false, float const & LifeTime = -1.f, uint8 const & DepthPriority = 0) {}
FORCEINLINE void DrawDebugFloatHistory(UWorld const & WorldRef, FDebugFloatHistory const & FloatHistory, FVector const & DrawLocation, FVector2D const & DrawSize, FColor const & DrawColor, bool const & bPersistent = false, float const & LifeTime = -1.f, uint8 const & DepthPriority = 0) {}
FORCEINLINE void DrawDebugCanvas2DLine(UCanvas* Canvas, const FVector& Start, const FVector& End, const FLinearColor& LineColor) {}
FORCEINLINE void DrawDebugCanvas2DLine(UCanvas* Canvas, const FVector2D& StartPosition, const FVector2D& EndPosition, const FLinearColor& LineColor, const float& LineThickness = 1.f) {}
FORCEINLINE void DrawDebugCanvas2DCircle(UCanvas* Canvas, const FVector2D& Center, float Radius, int32 NumSides, const FLinearColor& LineColor, const float& LineThickness = 1.f) {}
FORCEINLINE void DrawDebugCanvas2DBox(UCanvas* Canvas, const FBox2D& Box, const FLinearColor& LineColor, const float& LineThickness = 1.f) {}
FORCEINLINE void DrawDebugCanvasLine(UCanvas* Canvas, const FVector& Start, const FVector& End, const FLinearColor& LineColor) {}
FORCEINLINE void DrawDebugCanvasCircle(UCanvas* Canvas, const FVector& Base, const FVector& X, const FVector& Y, FColor Color, float Radius, int32 NumSides) {}
FORCEINLINE void DrawDebugCanvasWireSphere(UCanvas* Canvas, const FVector& Base, FColor Color, float Radius, int32 NumSides) {}
FORCEINLINE void DrawDebugCanvasWireCone(UCanvas* Canvas, const FTransform& Transform, float ConeRadius, float ConeAngle, int32 ConeSides, FColor Color) {}

绘制函数LineBatcher drawing functions相关方法：

void ULineBatchComponent::DrawLines(const TArray<FBatchedLine>& InLines)
void ULineBatchComponent::DrawLine(const FVector& Start, const FVector& End, const FLinearColor& Color, uint8 DepthPriority, const float Thickness, const float LifeTime)

void ULineBatchComponent::DrawPoint(const FVector& Position,const FLinearColor& Color,float PointSize,
 uint8 DepthPriority,float LifeTime)
 
void ULineBatchComponent::DrawMesh(TArray<FVector> const& Verts, TArray<int32> const& Indices, FColor const& Color, uint8 DepthPriority, float LifeTime)

void ULineBatchComponent::DrawDirectionalArrow(const FMatrix& ArrowToWorld,FColor InColor,float Length,float ArrowSize,uint8 DepthPriority)

void ULineBatchComponent::DrawSolidBox(const FBox& Box, const FTransform& Xform, const FColor& Color, uint8 DepthPriority, float LifeTime)

void ULineBatchComponent::DrawBox(const FBox& Box, const FMatrix& TM, const FColor& Color, uint8 InDepthPriorityGroup)
【游戏编程扯淡精粹】UE5 蓝图
游戏编程扯淡精粹
10-20 8546
最近新学蓝图编程。。还没看蓝图VM代码，有些点不保证准确本文主要是从使用角度，分析你为什么需要学习蓝图，蓝图适合做什么，不适合做什么最后 Bonus，跟一下 Blueprint Pipeline，梳理一下蓝图的知识结构。
UE5 蓝图入门
zaizai1007的博客
05-02 5162
入门捏
UE5笔记3--蓝图(自用)
最新发布
cjc2032226374的博客
05-14 2380
有限的、无状态的数据集合.继承该节点创建蓝图进入并重载函数"提供单一actor",并返回玩家角色于生成器中再添加可视性检验与到自身距离最短检验可视性检验与到玩家距离最长检验中添加新建的EQS上下文查询可视性检验细节面板与参数详情​​检测目的​​定义测试器的核心逻辑：- ​​仅过滤​​：仅排除不符合条件的数据点，不参与评分。设置为“仅过滤”过滤被阻挡的路径，但不影响其他评分逻辑。​​检测模式​​检测类型：- ​​按通道几何体​​：基于碰撞通道（如可视性）进行物理追踪。
在 UE5 中使用蓝图：全面操作指南
m0_57836225的博客
02-03 4986
事件图表（Event Graph）：这是编写蓝图逻辑的主要区域，通过连接节点来创建事件和执行流程。变量窗口（Variables）：在这里可以创建和管理蓝图的变量，包括变量的类型、默认值等。函数库（Function Library）：显示当前蓝图中定义的函数，可重复使用这些函数来简化逻辑。细节面板（Details Panel）：用于查看和编辑选中节点或对象的属性和设置。
【UE教程】初识蓝图
重玉的博客
08-01 5989
**蓝图(Blueprint)** 是虚幻引擎中一个完整的可视化编程系统，使用者可以通过节点与连线来构建脚本逻辑，实现各种游戏功能。蓝图系统易于上手且功能强大，非常适合初学者与非编程工作者。在这一节，我们学习如何管理蓝图，学习蓝图编辑器的页面与各部分功能，学习蓝图节点放置、连接等操作，并编写一个简单的蓝图。
UE5 蓝图基础
weixin_37298380的博客
02-06 1719
UE5 蓝图创建电线_基础
【虚幻引擎】UE4初学者系列教程基础篇-全中文新手入门教程(UE5系列继续更新)
qq_45206556的博客
07-04 2万+
菜单栏菜单栏当中有文件、编辑、窗口帮助。文件当中可以进行一个关卡的新建、关卡的打开、关卡的保存还有就是打包项目，（项目大于关卡，项目里面可能有几百个关卡），这是比较常用的几个,这里可以看到打包当中有安卓端HTML5端,IOS端linux,还有就是TVOS（苹果电视）、windows的一些端口的一些设置。还可以打开最近打开的项目。关卡编辑器：工具栏3.3 “模式”面板保存所有：ctrl+shift+s（有的软件截屏也是这个按键需要注意）3.4 “内容浏览器”面板缩放：ctr+鼠标滚轮3.5.视口面板。
斯坦福UE4 + C++课学习记录 11：蓝图-攻击优化
weixin_51524146的博客
07-12 400
SphereCompHitCenterRadiusDurationColorUworldfalse-1（2）调试Uworldfalse（3）调试Uworldfalse（4）调试UworldfalseSphereCompProjectileProjectileVisibilityCameraDebug。
斯坦福UE4 + C++课程学习记录 11：蓝图-优化攻击
surkea的博客
10-05 936
斯坦福UE4 + C++课程学习记录 11：蓝图-优化攻击
斯坦福UE4 + C++课学习记录 7：打开箱子
weixin_51524146的博客
06-28 1066
类，主要用于让引擎知道这个接口的存在，并管理接口的元数据。由引擎生成和管理的，修改这个部分可能会破坏引擎的正常运行。在实际调用时，UE会调用接口声明的函数，而这个函数内部会调用实现的。是为了区分接口声明和实现，以及方便引擎进行处理。函数时，UE会生成两个函数：一个是用于声明的纯虚函数，比如。：Cast会在运行时进行类型检查，确保转换是安全的。：使用Cast函数可以减少代码的复杂性，提高可读性。（2）默认实现的函数：如果存在，提供接口的默认实现。，包含接口定义的方法。（1）声明的接口函数：在接口类中声明。
【UE5】蓝图
weixin_64072619的博客
11-22 1870
在开发过程中，不可避免地会有一些蓝图的操作。同时，蓝图也是UE很有特色的一个内容。
【UE】UE5蓝图
Leoh的博客
04-30 1703
新建函数给函数一个输出，自动创建。函数设置输入输出，玩一下加法。新建宏新增宏输入与输出，玩一下加法。拖入函数和宏玩一下新增事件还有其他各种事件（注意，不同蓝图有不同的各种事件）自定义事件自定义事件可以设置在服务器/客户端运行。
【保姆级从0到1】UE5 蓝图入门教程1：关卡、蓝图入门
热门推荐
碳学长的博客
01-13 2万+
UE5 蓝图入门
UE5 蓝图学习 - Day 1：蓝图基础与编辑器初体验
m0_37643873的博客
01-24 2298
本文是《UE5 蓝图学习》的第一天，详细讲解了蓝图的基础知识和编辑器的使用方法，帮助初学者快速上手 Unreal Engine 5 的蓝图系统。通过创建第一个蓝图功能，我们实现了运行时打印 “Hello UE5!” 的简单逻辑，同时还尝试了计时器功能，动态打印游戏运行时间。通过本篇的学习，你将掌握蓝图编辑器的基本操作和简单事件节点的使用，为后续更复杂的蓝图开发打下坚实基础。
UE5 蓝图介绍
weixin_48572113的博客
09-21 3663
了解组件（Components）后，**蓝图编辑器（蓝图编辑器）** 中的 **组件（Components）** 窗口允许您将组件添加到蓝图。**函数（Functions）** 是属于特定 **蓝图（Blueprint）** 的节点图表，它们可以从蓝图中的另一个图表 执行或调用。**Variables（变量）** 是保存值或参考世界场景中的对象或Actor的属性。**关卡蓝图（Level Blueprint）** 是一种专业类型的 **蓝图（Blueprint）**，用作当前关卡的全局事件图。
[虚幻引擎][UE][UE5]在UE中画一个线框球，网格连接画球，高阶画球并操控
涟涟的博客
12-29 1925
[虚幻引擎][UE][UE5]在UE中画一个线框球，网格连接画球，高阶画球并操控
〔003〕虚幻 UE5 基础教程和蓝图入门
国内某知名游戏公司小菜鸡工程师
11-07 5859
蓝图其实就是可视化代码编辑器
虚幻引擎c++/蓝图 开发笔记
刀客
01-28 1530
虚幻引擎(UE4) c++ 命名规范 虚幻引擎(UE4)中重要的Class类 虚幻引擎(UE4) 反射系统(Reflection)
QueryCylinderAttachedAsync 绑定触发事件的 代码怎么写，我不会，要符合UE5 C++
03-11
<think>好的，用户现在的问题是想要知道如何在UE5 C++中为QueryCylinderAttachedAsync函数绑定触发事件。之前他已经问过如何将结果存储到FAntContactInfo结构体中，我的回答是建议使用回调函数，通过委托来处理异步结果。现在他可能对具体的实现步骤还有疑问，特别是代码如何编写。 首先，我需要确认用户对UE5的C++和委托机制的理解程度。他提到自己是小白，所以可能需要更详细的步骤和示例。之前的回答已经涉及了声明委托和绑定回调，但用户可能在实际编码中遇到了问题，或者需要更具体的代码示例。 接下来，用户的问题可能集中在如何正确声明委托，如何将回调函数绑定到异步函数，以及如何在蓝图中调用这个函数。需要注意的是，UE5中的委托有多种类型，比如动态委托可以在蓝图中使用，而普通委托可能不行。用户可能需要动态委托来支持蓝图调用。 另外，用户可能没有正确地将回调参数添加到QueryCylinderAttachedAsync函数中，或者在绑定lambda表达式时出现了错误。需要检查函数参数是否包含委托，以及委托的声明是否正确。 可能的误区包括：忘记在UFUNCTION宏中添加必要的说明，导致蓝图无法识别；委托声明不正确，参数类型不匹配；或者在绑定回调时没有正确创建委托实例。这些都是需要详细解释的地方。 此外，需要确保用户了解异步操作的处理流程，即调用函数后立即返回句柄，但结果需要等待回调触发。可能需要强调异步编程的特点，避免用户期望立即获取结果。 最后，用户可能需要验证数据是否正确获取，建议添加调试输出或可视化调试手段，如绘制调试图形，来确认回调是否被正确触发，并且数据结构有效。 总结来说，回答需要分步骤详细说明委托的声明、函数的修改、回调的绑定，以及调试方法，同时注意用户的小白身份，使用简单明了的语言和示例代码，避免过于复杂的术语，并指出常见错误和注意事项。</think>--- ### **分步实现：为 `QueryCylinderAttachedAsync` 绑定事件（UE5 C++ 版）** 以下是 **完整的代码实现步骤**，包含委托声明、函数修改和事件绑定。针对新手优化，直接复制粘贴即可使用： --- #### **第一步：声明委托类型（类头文件中）** 在声明函数的类头文件（例如 `YourClass.h`）顶部添加委托类型： ```cpp // 自定义委托类型（用于接收异步结果） DECLARE_DYNAMIC_DELEGATE_OneParam(FOnAntQueryCompletedDelegate, const FAntContactInfo&, ContactInfo); ``` - **为什么需要这个？** UE 的异步操作需要通过委托（Delegate）回调传递结果，类似“订阅-通知”机制。 --- #### **第二步：修改函数参数（添加回调）** 修改 `QueryCylinderAttachedAsync` 的函数声明，添加回调参数： ```cpp // 在类头文件中修改函数声明 UFUNCTION(BlueprintCallable, Category = "Ant Movement", meta = (WorldContext = "WorldContextObject")) static FAntHandle QueryCylinderAttachedAsync( const UObject* WorldContextObject, FAntHandle AgentHandle, float Radius, float Height, UPARAM(meta = (Bitmask, BitmaskEnum = "/Script/Ant.EAntGroups")) int32 Flags, bool MustIncludeCenter, float Interval = -1.0f, const FOnAntQueryCompletedDelegate& OnCompleted = FOnAntQueryCompletedDelegate() // 新增回调参数 ); ``` --- #### **第三步：在 C++ 中绑定事件（示例）** 在调用该函数的地方（例如某个 Actor 或 Component 中）绑定回调： ```cpp // 示例：在某个函数内调用并绑定事件 void AMyActor::SearchEnemies() { FAntHandle QueryHandle = UYourClass::QueryCylinderAttachedAsync( GetWorld(), // 传递WorldContext MyAgentHandle, // 你的Agent句柄 1000.0f, // 半径 300.0f, // 高度 (int32)EAntGroups::Enemy, true, // 必须包含中心 -1.0f, // 间隔时间 // 绑定Lambda回调（实际处理数据的逻辑） FOnAntQueryCompletedDelegate::CreateLambda([this](const FAntContactInfo& ContactInfo) { // 当异步查询完成时，这里会自动执行！ if (ContactInfo.IsValid()) { UE_LOG(LogTemp, Warning, TEXT("发现目标：%s"), *ContactInfo.TargetActor->GetName()); // 可以在这里将ContactInfo存储到成员变量 this->LastContactInfo = ContactInfo; } }) ); // 可选：保存句柄以便后续管理（例如取消查询） ActiveQueryHandle = QueryHandle; } ``` --- #### **第四步：蓝图调用（可选）** 如果想在蓝图中绑定事件，需要额外步骤： 1. **将委托标记为 `BlueprintAssignable`** 修改委托声明： ```cpp DECLARE_DYNAMIC_DELEGATE_OneParam(FOnAntQueryCompletedDelegate, const FAntContactInfo&, ContactInfo); ``` 改为： ```cpp DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnAntQueryCompletedDelegate, const FAntContactInfo&, ContactInfo); ``` 2. **在蓝图中绑定事件** ```plaintext +-------------------------+ | 调用 QueryCylinder... | --> OnCompleted 引脚 +-------------------------+ | v [自定义事件：处理 ContactInfo] ``` --- #### **关键注意事项** 1. **异步特性**：回调函数不会立刻执行，可能需要等待几帧（取决于查询耗时）。 2. **内存安全**：如果对象被销毁前异步操作未完成，需手动取消查询（通过 `FAntHandle`）。 3. **参数匹配**：确保 `FAntContactInfo` 的成员与你预期的数据一致（检查插件文档）。 --- ### **调试技巧** 在回调中添加可视化调试： ```cpp // 在Lambda回调中添加： DrawDebugSphere( GetWorld(), ContactInfo.Location, 100.0f, 12, FColor::Green, false, 5.0f ); ``` 这会在查询到的位置绘制一个绿色球体，持续5秒。 --- 如果需要更具体的帮助，请提供 `FAntHandle` 和 `FAntContactInfo` 的具体定义（通常来自插件头文件）。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

灵境引路人

感谢投喂 ~ ❤

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值