71 lines
3.8 KiB
C++
71 lines
3.8 KiB
C++
// Copyright 2025 https://yuewu.dev/en All Rights Reserved.
|
||
|
||
#pragma once
|
||
|
||
#include "CoreMinimal.h"
|
||
#include "GGS_InteractionStructLibrary.h"
|
||
#include "SmartObjectSubsystem.h"
|
||
#include "SmartObjectTypes.h"
|
||
#include "Kismet/BlueprintFunctionLibrary.h"
|
||
#include "GGS_SmartObjectFunctionLibrary.generated.h"
|
||
|
||
class UGameplayInteractionSmartObjectBehaviorDefinition;
|
||
class UGameplayBehaviorSmartObjectBehaviorDefinition;
|
||
class UGameplayBehaviorConfig;
|
||
class USmartObjectBehaviorDefinition;
|
||
|
||
/**
|
||
* Blueprint function library for smart object interactions.
|
||
* 智能对象交互的蓝图函数库。
|
||
*/
|
||
UCLASS()
|
||
class GENERICGAMESYSTEM_API UGGS_SmartObjectFunctionLibrary : public UBlueprintFunctionLibrary
|
||
{
|
||
GENERATED_BODY()
|
||
|
||
public:
|
||
/**
|
||
* Retrieves the gameplay behavior config from a smart object behavior definition.
|
||
* 从智能对象行为定义获取游戏行为配置。
|
||
* @param BehaviorDefinition The smart object behavior definition. 智能对象行为定义。
|
||
* @return The gameplay behavior config. 游戏行为配置。
|
||
*/
|
||
UFUNCTION(BlueprintCallable, BlueprintPure, Category = "GGS|SmartObject")
|
||
static UGameplayBehaviorConfig* GetGameplayBehaviorConfig(const USmartObjectBehaviorDefinition* BehaviorDefinition);
|
||
|
||
/**
|
||
* Finds a specific gameplay behavior config by class.
|
||
* 按类查找特定游戏行为配置。
|
||
* @param BehaviorDefinition The smart object behavior definition. 智能对象行为定义。
|
||
* @param DesiredClass The desired config class. 期望的配置类。
|
||
* @param OutConfig The found config (output). 找到的配置（输出）。
|
||
* @return True if the config was found, false otherwise. 如果找到配置返回true，否则返回false。
|
||
*/
|
||
UFUNCTION(BlueprintCallable, Category = "GGS|SmartObject", meta=(DeterminesOutputType="DesiredClass", DynamicOutputParam="OutConfig", ExpandBoolAsExecs="ReturnValue"))
|
||
static bool FindGameplayBehaviorConfig(const USmartObjectBehaviorDefinition* BehaviorDefinition, TSubclassOf<UGameplayBehaviorConfig> DesiredClass, UGameplayBehaviorConfig*& OutConfig);
|
||
|
||
/**
|
||
* Searches for smart object slots with interaction entrances on an actor.
|
||
* 在演员上搜索带有交互入口的智能对象槽。
|
||
* @param Filter The search filter. 搜索过滤器。
|
||
* @param SearchActor The actor to search. 要搜索的演员。
|
||
* @param OutResults The found smart object slot candidates (output). 找到的智能对象槽候选（输出）。
|
||
* @param UserActor Optional actor for additional data in condition evaluation. 用于条件评估的可选演员。
|
||
* @return True if at least one candidate was found, false otherwise. 如果找到至少一个候选返回true，否则返回false。
|
||
*/
|
||
UFUNCTION(BlueprintCallable, BlueprintPure = False, Category = "GGS|SmartObject", Meta = (ReturnDisplayName = "bSuccess"))
|
||
static bool FindSmartObjectsWithInteractionEntranceInActor(const FSmartObjectRequestFilter& Filter, AActor* SearchActor, TArray<FSmartObjectRequestResult>& OutResults,
|
||
const AActor* UserActor = nullptr);
|
||
|
||
/**
|
||
* Finds the interaction definition for a smart object slot.
|
||
* 查找智能对象槽的交互定义。
|
||
* @param WorldContext The world context object. 世界上下文对象。
|
||
* @param SmartObjectSlotHandle The smart object slot handle. 智能对象槽句柄。
|
||
* @param OutDefinition The interaction definition (output). 交互定义（输出）。
|
||
* @return True if the definition was found, false otherwise. 如果找到定义返回true，否则返回false。
|
||
*/
|
||
UFUNCTION(BlueprintCallable, Category="GGS|SmartObject", meta=(WorldContext="WorldContext", ExpandBoolAsExecs="ReturnValue"))
|
||
static bool FindInteractionDefinitionFromSmartObjectSlot(UObject* WorldContext, FSmartObjectSlotHandle SmartObjectSlotHandle, UGGS_InteractionDefinition*& OutDefinition);
|
||
};
|