init

Plugins/Dialog/EDialogPresentationScriptCommandParamType.md

@@ -0,0 +1,72 @@
+# EDialogPresentationScriptCommandParamType
+
+## 基本信息
+- **类型**: UENUM(BlueprintType)
+- **父类**: uint8
+- **源文件**: Plugins/Dialog/Source/Dialog/Public/DialogPresentationScript.h
+- **模块**: Dialog
+
+## 功能概述
+对话脚本命令参数类型的枚举：None、Number、String、Boolean、Array、Object。在 FDialogPresentationScriptParam 中作为类型标签使用，实现带标签的联合体语义。
+
+## 设计用意
+由于 USTRUCT 无法持有变体值，因此需要显式的类型鉴别机制。运行时代码通过 switch 该枚举值来读取正确的字段。Array 和 Object 类型以序列化的 JSON 字符串形式存储，以兼容蓝图。
+
+## 职责范围
+类型标签枚举。被 FDialogPresentationScriptParam 和 UPresentationJsonLibrary 引用，用于 JSON 解析和分发。
+
+## 项目内依赖
+| 依赖项 | 关系 | 源文件 |
+|--------|------|--------|
+（无项目内依赖）
+
+## 对外接口
+BlueprintType 枚举，作为 `FDialogPresentationScriptParam` 中 `Type` 字段的类型标签。消费者通过 switch 该枚举来决定读取哪个值字段。
+
+枚举值：
+- **None**: 无类型/空值。构造函数默认值，JSON 解析失败时也为 None。
+- **Number**: 对应 JSON Number 类型，值存储在 `FDialogPresentationScriptParam::NumberValue` (float)。
+- **String**: 对应 JSON String 类型，值存储在 `FDialogPresentationScriptParam::StringValue`。
+- **Boolean**: 对应 JSON Boolean 类型，值存储在 `FDialogPresentationScriptParam::BooleanValue`。
+- **Array**: 对应 JSON Array 类型，整个数组序列化为 JSON 字符串存储在 `FDialogPresentationScriptParam::ArrayValue`。
+- **Object**: 对应 JSON Object 类型，整个对象序列化为 JSON 字符串存储在 `FDialogPresentationScriptParam::ObjectValue`。
+
+注意：Array 和 Object 以序列化 JSON 字符串形式存储，而非嵌套结构体。消费者需要在蓝图或 C++ 中自行反序列化。
+
+## 使用方法
+在 JSON 解析中按值类型分发：
+```cpp
+// Plugins/Dialog/Source/Dialog/Private/DialogPresentationScript.cpp:163-196
+switch (JsonValue->Type)
+{
+case EJson::String:
+    Param.Type = EDialogPresentationScriptCommandParamType::String;
+    Param.StringValue = JsonValue->AsString();
+    break;
+case EJson::Number:
+    Param.Type = EDialogPresentationScriptCommandParamType::Number;
+    Param.NumberValue = static_cast<float>(JsonValue->AsNumber());
+    break;
+// ... Boolean, Array, Object cases ...
+}
+```
+
+在 JSON 序列化中按类型标签写入：
+```cpp
+// Plugins/Dialog/Source/Dialog/Private/DialogPresentationScript.cpp:353-389
+switch (Param.Type)
+{
+case EDialogPresentationScriptCommandParamType::String:
+    return FString::Printf(TEXT("\"%s\""), *lambda(Param.StringValue));
+case EDialogPresentationScriptCommandParamType::Number:
+    return FString::SanitizeFloat(Param.NumberValue);
+// ... Boolean, Array, Object, default cases ...
+}
+```
+
+## 用例
+| 文件 | 行号 | 用途 |
+|------|------|------|
+| Plugins/Dialog/Source/Dialog/Public/DialogPresentationScript.h | 43-51,61,69 | 枚举定义；FDialogPresentationScriptParam 构造函数默认值 (None)；字段声明 |
+| Plugins/Dialog/Source/Dialog/Private/DialogPresentationScript.cpp | 155-195 | JsonValueToParam 中按 JSON 类型分发到对应枚举值 |
+| Plugins/Dialog/Source/Dialog/Private/DialogPresentationScript.cpp | 355-389 | ParamToJson 中按枚举值序列化到 JSON 字符串 |