FDialogPresentationScriptParam

基本信息

类型: USTRUCT(BlueprintType)
父类: （无）
源文件: Plugins/Dialog/Source/Dialog/Public/DialogPresentationScript.h
模块: Dialog

功能概述

用于单个命令参数的带标签联合体值类型。包含一个 Type 枚举和多个值字段：String、Number（float）、Boolean、Array（JSON 字符串）、Object（JSON 字符串）。显式构造函数初始化为 None/0.0/false。

设计用意

采用带标签的联合体模式来处理异构命令参数。使得单一灵活的命令系统成为可能，各策略根据类型解释参数。对蓝图可用。

职责范围

单个命令参数的值容器。消费者通过 switch Type 来读取正确的值字段。不解释或执行参数值。

项目内依赖

依赖项	关系	源文件
EDialogPresentationScriptCommandParamType	成员类型	Plugins/Dialog/Source/Dialog/Public/DialogPresentationScript.h

对外接口

BlueprintType 结构体，作为对话脚本命令参数的带标签联合体值类型。

关键字段：

Type (EDialogPresentationScriptCommandParamType): 类型标签，指示哪个值字段有效。消费者应先检查此字段，然后读取对应的值字段。
StringValue (FString): 字符串值，当 Type == String 时有效。
NumberValue (float): 数值，当 Type == Number 时有效。
BooleanValue (bool): 布尔值，当 Type == Boolean 时有效。
ArrayValue (FString): JSON 数组的序列化字符串，当 Type == Array 时有效。需自行解析为 TArray。
ObjectValue (FString): JSON 对象的序列化字符串，当 Type == Object 时有效。需自行解析为 TSharedPtr。

构造函数行为：

Type 默认为 EDialogPresentationScriptCommandParamType::None
NumberValue 默认为 0.0f
BooleanValue 默认为 false
StringValue、ArrayValue、ObjectValue 默认为空字符串（FString 默认构造）

使用方法

从 FDialogPresentationScriptData 获取单个参数：

// Plugins/Dialog/Source/Dialog/Private/DialogPresentationScript.cpp:201-225
FDialogPresentationScriptParam Param = UPresentationJsonLibrary::GetPresentationScriptCommandParaAt(Data, CommandIndex, ParaIndex);

从字符串构建参数对象：

// Plugins/Dialog/Source/Dialog/Private/DialogPresentationScript.cpp:228-243
FDialogPresentationScriptParam Param = UPresentationJsonLibrary::BuildPresentationScriptCommandParaFromStr(SourceString);

消费者按 Type 分发读取正确的值字段，参见 ParamToJson 中的 switch 分发模式（DialogPresentationScript.cpp:353-389）。

用例

文件	行号	用途
Plugins/Dialog/Source/Dialog/Public/DialogPresentationScript.h	54-85	结构体定义，包含所有字段和构造函数
Plugins/Dialog/Source/Dialog/Private/DialogPresentationScript.cpp	150-198	JsonValueToParam 解析 JSON 值并填充字段
Plugins/Dialog/Source/Dialog/Private/DialogPresentationScript.cpp	201-225	GetPresentationScriptCommandParaAt 获取指定命令的指定参数
Plugins/Dialog/Source/Dialog/Private/DialogPresentationScript.cpp	228-243	BuildPresentationScriptCommandParaFromStr 从字符串构建参数
Plugins/Dialog/Source/Dialog/Private/DialogPresentationScript.cpp	246-276	GetPresentationScriptCommandParams 获取某命令的所有参数数组
Plugins/Dialog/Source/Dialog/Private/DialogPresentationScript.cpp	351-389	ParamToJson 按 Type 序列化为 JSON

3.5 KiB Raw Permalink Blame History Unescape Escape