第一次提交

2026-03-03 01:23:02 +08:00
commit 3e434877e8
1053 changed files with 102411 additions and 0 deletions
--- a/Plugins/GCS/Source/GenericInputSystem/Public/GIPS_InputControlSetup.h
+++ b/Plugins/GCS/Source/GenericInputSystem/Public/GIPS_InputControlSetup.h
@@ -0,0 +1,143 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GIPS_InputTypes.h"
+#include "GIPS_InputControlSetup.generated.h"
+
+struct FInputActionInstance;
+class UGIPS_InputChecker;
+class UGIPS_InputProcessor;
+class UGIPS_InputSystemComponent;
+
+/**
+ * Data asset for defining input checkers and processors.
+ * 定义输入检查器和处理器的数据资产。
+ */
+UCLASS(BlueprintType, Const)
+class GENERICINPUTSYSTEM_API UGIPS_InputControlSetup : public UDataAsset
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Handles input actions for the input system.
+	 * 为输入系统处理输入动作。
+	 * @param IC The input system component. 输入系统组件。
+	 * @param ActionData The input action data. 输入动作数据。
+	 * @param InputTag The gameplay tag for the input. 输入的游戏标签。
+	 * @param TriggerEvent The trigger event type. 触发事件类型。
+	 */
+	void HandleInput(UGIPS_InputSystemComponent* IC, const FInputActionInstance& ActionData, const FGameplayTag& InputTag, ETriggerEvent TriggerEvent) const;
+
+	/**
+	 * Checks if an input is allowed.
+	 * 检查输入是否被允许。
+	 * @param IC The input system component. 输入系统组件。
+	 * @param ActionData The input action data. 输入动作数据。
+	 * @param InputTag The gameplay tag for the input. 输入的游戏标签。
+	 * @param TriggerEvent The trigger event type. 触发事件类型。
+	 * @return True if the input is allowed, false otherwise. 如果输入被允许则返回true，否则返回false。
+	 */
+	bool CheckInput(UGIPS_InputSystemComponent* IC, const FInputActionInstance& ActionData, const FGameplayTag& InputTag, ETriggerEvent TriggerEvent);
+
+protected:
+	/**
+	 * Determines if debugging is enabled for the input.
+	 * 确定是否为输入启用调试。
+	 * @param InputTag The gameplay tag for the input. 输入的游戏标签。
+	 * @param TriggerEvent The trigger event type. 触发事件类型。
+	 * @return True if debugging is enabled, false otherwise. 如果启用调试则返回true，否则返回false。
+	 */
+	bool ShouldDebug(const FGameplayTag& InputTag, const ETriggerEvent& TriggerEvent) const;
+
+	/**
+	 * Internal logic for checking input validity.
+	 * 检查输入有效性的内部逻辑。
+	 * @param IC The input system component. 输入系统组件。
+	 * @param ActionData The input action data. 输入动作数据。
+	 * @param InputTag The gameplay tag for the input. 输入的游戏标签。
+	 * @param TriggerEvent The trigger event type. 触发事件类型。
+	 * @return True if the input is valid, false otherwise. 如果输入有效则返回true，否则返回false。
+	 */
+	virtual bool InternalCheckInput(UGIPS_InputSystemComponent* IC, const FInputActionInstance& ActionData, const FGameplayTag& InputTag, ETriggerEvent TriggerEvent);
+
+	/**
+	 * Filters input processors based on the input tag and trigger event.
+	 * 根据输入标签和触发事件过滤输入处理器。
+	 * @param InputTag The gameplay tag for the input. 输入的游戏标签。
+	 * @param TriggerEvent The trigger event type. 触发事件类型。
+	 * @return Array of filtered input processors. 过滤后的输入处理器数组。
+	 */
+	TArray<TObjectPtr<UGIPS_InputProcessor>> FilterInputProcessors(const FGameplayTag& InputTag, const ETriggerEvent& TriggerEvent) const;
+
+	/**
+	 * List of input events will bypass all the input checkers.
+	 * 此列表中的输入时间会绕过所有的输入检查器。
+	 */
+	UPROPERTY(EditAnywhere, Category="GIPS|Input", meta=(TitleProperty="InputTag"))
+	TArray<FGIPS_AllowedInput> AlwaysAllowedInputs;
+
+	/**
+	 * List of input checkers to validate input events.
+	 * 验证输入事件的一组输入检查器。
+	 */
+	UPROPERTY(EditAnywhere, Instanced, Category="GIPS|Input")
+	TArray<TObjectPtr<UGIPS_InputChecker>> InputCheckers;
+
+	/**
+	 * If enabled, disallowed inputs are attempted to be stored in the input buffer.
+	 * 如果启用，不允许的输入将尝试存储在输入缓冲区中。
+	 * @attention Input buffering may not be needed for some setups, like UI. 对于某些设置（如UI），可能不需要输入缓冲。
+	 */
+	UPROPERTY(EditAnywhere, Category="GIPS|Input")
+	bool bEnableInputBuffer{false};
+
+	/**
+	 * Controls the execution order of input processors for a single input event.
+	 * 控制单个输入事件的处理器执行顺序。
+	 */
+	UPROPERTY(EditAnywhere, Category="GIPS|Input")
+	EGIPS_InputProcessorExecutionType InputProcessorExecutionType{EGIPS_InputProcessorExecutionType::MatchAll};
+
+	/**
+	 * List of input processors to handle allowed input events sequentially.
+	 * 处理允许的输入事件的一组输入处理器，按顺序执行。
+	 */
+	UPROPERTY(EditAnywhere, Instanced, Category="GIPS|Input", meta=(TitleProperty="EditorFriendlyName", ShowOnlyInnerProperties))
+	TArray<TObjectPtr<UGIPS_InputProcessor>> InputProcessors;
+
+	/**
+	 * Enables debug logging for input events.
+	 * 为输入事件启用调试日志。
+	 * @attention Requires LogGIPS to be set to VeryVerbose to take effect. 需要将LogGIPS设置为VeryVerbose才能生效。
+	 */
+	UPROPERTY(EditAnywhere, Category="GIPS|Debug")
+	bool bEnableInputDebug{false};
+
+	/**
+	 * Input tags to debug (logs all tags if empty).
+	 * 要调试的输入标签（如果为空则记录所有标签）。
+	 */
+	UPROPERTY(EditAnywhere, Category="GIPS|Debug", meta=(EditCondition="bEnableInputDebug", Categories="InputTag,GIPS.InputTag"))
+	FGameplayTagContainer DebugInputTags{};
+
+	/**
+	 * Trigger events to debug (logs all events if empty).
+	 * 要调试的触发事件（如果为空则记录所有事件）。
+	 */
+	UPROPERTY(EditAnywhere, Category="GIPS|Debug", meta=(EditCondition="bEnableInputDebug"))
+	TArray<ETriggerEvent> DebugTriggerEvents{ETriggerEvent::Started, ETriggerEvent::Completed};
+
+public:
+#if WITH_EDITOR
+	/**
+	 * Validates the data asset in the editor.
+	 * 在编辑器中验证数据资产。
+	 * @param Context The data validation context. 数据验证上下文。
+	 * @return The validation result. 验证结果。
+	 */
+	virtual EDataValidationResult IsDataValid(FDataValidationContext& Context) const override;
+#endif
+};