第一次提交

Plugins/GIS/Source/GenericInventorySystem/Public/Exchange/GIS_CurrencyContainer.h

@@ -0,0 +1,105 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "Net/Serialization/FastArraySerializer.h"
+#include "GameplayTagContainer.h"
+#include "GIS_CurrencyEntry.h"
+#include "GIS_CurrencyContainer.generated.h"
+
+class UGIS_CurrencySystemComponent;
+class UGIS_CurrencyDefinition;
+struct FGIS_CurrencyContainer;
+
+/**
+ * Container for storing currency entries.
+ * 用于存储货币条目的容器。
+ */
+USTRUCT()
+struct GENERICINVENTORYSYSTEM_API FGIS_CurrencyContainer : public FFastArraySerializer
+{
+	GENERATED_BODY()
+
+	/**
+	 * Default constructor for the currency container.
+	 * 货币容器的默认构造函数。
+	 */
+	FGIS_CurrencyContainer()
+	{
+	};
+
+	/**
+	 * Constructor for the currency container with an owning component.
+	 * 使用拥有组件构造货币容器。
+	 * @param InOwner The owning currency system component. 拥有此容器的货币系统组件。
+	 */
+	FGIS_CurrencyContainer(UGIS_CurrencySystemComponent* InOwner)
+		: OwningComponent(InOwner)
+	{
+	}
+
+	//~FFastArraySerializer contract
+	/**
+	 * Called before entries are removed during replication.
+	 * 复制期间移除条目前调用。
+	 * @param RemovedIndices The indices of entries to remove. 要移除的条目索引。
+	 * @param FinalSize The final size of the entries array after removal. 移除后条目数组的最终大小。
+	 */
+	void PreReplicatedRemove(const TArrayView<int32> RemovedIndices, int32 FinalSize);
+
+	/**
+	 * Called after entries are added during replication.
+	 * 复制期间添加条目后调用。
+	 * @param AddedIndices The indices of added entries. 添加的条目索引。
+	 * @param FinalSize The final size of the entries array after addition. 添加后条目数组的最终大小。
+	 */
+	void PostReplicatedAdd(const TArrayView<int32> AddedIndices, int32 FinalSize);
+
+	/**
+	 * Called after entries are changed during replication.
+	 * 复制期间条目更改后调用。
+	 * @param ChangedIndices The indices of changed entries. 更改的条目索引。
+	 * @param FinalSize The final size of the entries array after change. 更改后条目数组的最终大小。
+	 */
+	void PostReplicatedChange(const TArrayView<int32> ChangedIndices, int32 FinalSize);
+	//~End of FFastArraySerializer contract
+
+	/**
+	 * Handles delta serialization for network replication.
+	 * 处理网络复制的增量序列化。
+	 * @param DeltaParms The serialization parameters. 序列化参数。
+	 * @return True if serialization was successful, false otherwise. 如果序列化成功则返回true，否则返回false。
+	 */
+	bool NetDeltaSerialize(FNetDeltaSerializeInfo& DeltaParms)
+	{
+		return FastArrayDeltaSerialize<FGIS_CurrencyEntry, FGIS_CurrencyContainer>(Entries, DeltaParms, *this);
+	}
+
+	/**
+	 * The owning currency system component.
+	 * 拥有此容器的货币系统组件。
+	 */
+	UPROPERTY()
+	TObjectPtr<UGIS_CurrencySystemComponent> OwningComponent{nullptr};
+
+	/**
+	 * Array of currency entries.
+	 * 货币条目数组。
+	 */
+	UPROPERTY(VisibleAnywhere, Category="Currency", meta=(DisplayName="Currencies", TitleProperty="{Definition}->{Value}"))
+	TArray<FGIS_CurrencyEntry> Entries;
+};
+
+/**
+ * Traits for the currency container to enable network delta serialization.
+ * 货币容器的特性，用于启用网络增量序列化。
+ */
+template <>
+struct TStructOpsTypeTraits<FGIS_CurrencyContainer> : TStructOpsTypeTraitsBase2<FGIS_CurrencyContainer>
+{
+	enum
+	{
+		WithNetDeltaSerializer = true,
+	};
+};