第一次提交

Plugins/GIS/Source/GenericInventorySystem/Public/GIS_InventorySubsystem.h

@@ -0,0 +1,148 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GIS_SerializationStructLibrary.h"
+#include "Subsystems/GameInstanceSubsystem.h"
+#include "GIS_InventorySubsystem.generated.h"
+
+class UGIS_InventorySystemComponent;
+class UDataTable;
+class UGIS_InventoryFactory;
+
+
+/**
+ * Subsystem for managing inventory-related operations, such as item creation.
+ * 用于管理库存相关操作（如道具创建）的子系统。
+ */
+UCLASS(Config=Game, DefaultConfig)
+class GENERICINVENTORYSYSTEM_API UGIS_InventorySubsystem : public UGameInstanceSubsystem
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Gets the inventory subsystem instance from a world context object.
+	 * 从世界上下文对象获取库存子系统实例。
+	 * @param WorldContextObject The object providing the world context. 提供世界上下文的对象。
+	 * @return The inventory subsystem instance, or nullptr if not found. 库存子系统实例，如果未找到则返回nullptr。
+	 */
+	static UGIS_InventorySubsystem* Get(const UObject* WorldContextObject);
+
+	/**
+	 * Initializes the subsystem.
+	 * 初始化子系统。
+	 * @param Collection The subsystem collection. 子系统集合。
+	 */
+	virtual void Initialize(FSubsystemCollectionBase& Collection) override;
+
+	/**
+	 * Deinitializes the subsystem.
+	 * 反初始化子系统。
+	 */
+	virtual void Deinitialize() override;
+
+	/**
+	 * Creates an item instance from a definition.
+	 * 从道具定义创建道具实例。
+	 * @param Owner The actor that will own this item (required for network replication). 将拥有此道具的演员（网络复制所需）。
+	 * @param ItemDefinition The item definition to create the instance from. 用于创建实例的道具定义。
+	 * @return The newly created item instance, or nullptr if creation failed. 新创建的道具实例，如果创建失败则返回nullptr。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GIS")
+	UGIS_ItemInstance* CreateItem(AActor* Owner, TSoftObjectPtr<UGIS_ItemDefinition> ItemDefinition);
+
+	/**
+	 * Creates an item instance from a definition (C++ version).
+	 * 从道具定义创建道具实例（C++版本）。
+	 * @param Owner The actor that will own this item. 将拥有此道具的演员。
+	 * @param ItemDefinition The item definition to create the instance from. 用于创建实例的道具定义。
+	 * @return The newly created item instance, or nullptr if creation failed. 新创建的道具实例，如果创建失败则返回nullptr。
+	 */
+	UGIS_ItemInstance* CreateItem(AActor* Owner, const UGIS_ItemDefinition* ItemDefinition);
+
+	/**
+	 * Creates a new item by duplicating an existing item.
+	 * 通过复制现有道具创建新道具。
+	 * @param Owner The actor that will own the duplicated item. 将拥有复制道具的演员。
+	 * @param FromItem The original item to duplicate. 要复制的原始道具。
+	 * @attention The duplicated item will have a new unique ID. 复制的道具将具有新的唯一ID。
+	 * @return The duplicated item instance, or nullptr if duplication failed. 复制的道具实例，如果复制失败则返回nullptr。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GIS")
+	UGIS_ItemInstance* DuplicateItem(AActor* Owner, UGIS_ItemInstance* FromItem, bool bGenerateNewId = true);
+
+	/**
+	 * Serializes an item instance into a record.
+	 * 将道具实例序列化为记录。
+	 * @param Item The item instance to serialize. 要序列化的道具实例。
+	 * @param Record The resulting item record (output). 输出的道具记录。
+	 * @return True if serialization was successful, false otherwise. 如果序列化成功则返回true，否则返回false。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GIS")
+	bool SerializeItem(UGIS_ItemInstance* Item, FGIS_ItemRecord& Record);
+
+	/**
+	 * Deserializes an item from an item record.
+	 * 从道具记录反序列化道具。
+	 * @param Owner The actor owning the item instance (generally inventory system component's owner). 拥有此道具实例的演员，通常是库存系统组件的Owner。
+	 * @param Record The item record to deserialize. 要反序列化的道具记录。
+	 * @return The deserialized item instance, or nullptr if deserialization failed. 反序列化的道具实例，如果失败则返回nullptr。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GIS")
+	UGIS_ItemInstance* DeserializeItem(AActor* Owner, const FGIS_ItemRecord& Record);
+
+	/**
+	 * Serializes an item collection into a record.
+	 * 将道具集合序列化为记录。
+	 * @param ItemCollection The item collection to serialize. 要序列化的道具集合。
+	 * @param Record The resulting collection record (output). 输出的集合记录。
+	 * @return True if serialization was successful, false otherwise. 如果序列化成功则返回true，否则返回false。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GIS")
+	bool SerializeCollection(UGIS_ItemCollection* ItemCollection, FGIS_CollectionRecord& Record);
+
+	/**
+	 * Deserializes a collection from a collection record.
+	 * 从集合记录反序列化集合。
+	 * @param InventorySystem The inventory system component to associate with the collection. 与集合关联的库存系统组件。
+	 * @param Record The collection record to deserialize. 要反序列化的集合记录。
+	 * @param ItemsMap A map of item IDs to item instances (output). 道具ID到道具实例的映射（输出）。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GIS")
+	void DeserializeCollection(UGIS_InventorySystemComponent* InventorySystem, const FGIS_CollectionRecord& Record, TMap<FGuid, UGIS_ItemInstance*>& ItemsMap);
+
+	/**
+	 * Serializes an entire inventory into a record.
+	 * 将整个库存序列化为记录。
+	 * @param InventorySystem The inventory system component to serialize. 要序列化的库存系统组件。
+	 * @param Record The resulting inventory record. 输出的库存记录。
+	 * @return True if serialization was successful, false otherwise. 如果序列化成功则返回true，否则返回false。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GIS")
+	bool SerializeInventory(UGIS_InventorySystemComponent* InventorySystem, FGIS_InventoryRecord& Record);
+
+	/**
+	 * Deserializes an inventory from an inventory record.
+	 * 从库存记录反序列化库存。
+	 * @param InventorySystem The inventory system component to populate. 要填充的库存系统组件。
+	 * @param Record The inventory record to deserialize. 要反序列化的库存记录。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GIS")
+	void DeserializeInventory(UGIS_InventorySystemComponent* InventorySystem, const FGIS_InventoryRecord& Record);
+
+protected:
+	/**
+	 * Initializes the item factory for the subsystem.
+	 * 初始化子系统的道具工厂。
+	 */
+	virtual void InitializeFactory();
+
+	/**
+	 * The item factory used to create item instances.
+	 * 用于创建道具实例的道具工厂。
+	 */
+	UPROPERTY()
+	TObjectPtr<UGIS_InventoryFactory> Factory;
+};