使用指南
语言基础 / JSON节点
语言基础 / JSON 节点手册，包含 3 个节点的用途、引脚、使用场景和注意事项。
学习目标
用可视化方式表达字符串、数组、对象、集合、日期、JSON 和基础运算。
覆盖范围
- 节点数量：3
- 分类路径：语言基础 / JSON
典型使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
通用注意事项
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 检查JSON文本是否合法 | languageBaseJSONIsValid | 1 / 1 | 立即继续 |
| JSON文本解析为对象 | languageBaseJSONParse | 2 / 4 | 立即继续 |
| JSON序列化为文本 | languageBaseJSONStringify | 3 / 4 | 立即继续 |
检查JSON文本是否合法
检查JSON文本是否合法：只看一段文本的格式是不是标准 JSON，不做实际解析。 适合在正式解析之前先做安全检查：比如从服务器收到了一段数据、玩家输入了配置文本，你可以先用这个节点确认它是合法 JSON，再交给”JSON文本解析为对象”去处理。 注意：合法 JSON 不只有花括号包裹的对象——纯数字、纯字符串、布尔值和数组也是合法的 JSON 格式。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseJSONIsValid |
| 分类 | 语言基础 |
| 二级分类 | JSON |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
text | JSON文本 | 数据 | string | JSON文本 把需要验证的那段文本输进来。可以粘贴待检查的 JSON，也可以连接上游的输出。 | 输入框 默认值："" | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
result | 是否合法 | 数据 | boolean | 是否合法 true 表示文本是标准 JSON 格式；false 表示格式有问题，不适合拿去解析。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
JSON文本解析为对象
JSON文本解析为对象：把一段 JSON 格式的文本还原成对象、数组或数字等可以继续在节点里使用的数据。 适合处理网络请求返回的 JSON 数据、读取玩家存档、解析关卡配置文件等场景。你拿到的是文本，这个节点帮你变成真正可读写的数据结构。 执行逻辑：解析成功时，执行流会从”解析成功”出口继续。解析失败时（比如文本格式不对），执行流会走”解析失败”出口，同时打印错误日志以协助排查。 注意：具体解析出什么类型的数据，取决于 JSON 文本的内容。它可能是一个对象、数组、数字或字符串，因此输出类型无法在编辑期就确定。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseJSONParse |
| 分类 | 语言基础 |
| 二级分类 | JSON |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 执行流从这里进入，触发 JSON 解析。 | - | 可选 |
text | JSON文本 | 数据 | string | JSON文本 把要解析的 JSON 文本输进来。可以直接在引脚里粘贴 JSON，也可以连接变量、网络数据或资产内容。 | 输入框 默认值："" | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
success | 解析成功 | 执行流 | 执行流 | 解析成功 JSON 文本解析成功后从这里继续执行。此时”解析结果”端口已经包含了你需要的数据。 | - | 可选 |
value | 解析结果 | 数据 | object | 解析结果 解析成功后，这里是还原出来的对象。解析失败时这里是空值。 | - | 可选 |
error | 解析失败 | 执行流 | 执行流 | 解析失败 JSON 文本格式不正确时从这里继续执行。可以配合”错误信息”端口拿到具体原因。游戏运行时也会同时打印错误日志。 | - | 可选 |
errorMessage | 错误信息 | 数据 | string | 错误信息 解析失败时给出具体原因（如”第 5 个字符位置缺少引号”），成功时这里为空。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。
JSON序列化为文本
JSON序列化为文本：把对象、数组或其他能转成 JSON 的值，变成一段 JSON 格式的文本。 适合做存档保存、网络发送和数据展示。例如保存玩家进度、将游戏配置发送到服务器或备份游戏运行时状态。 美化输出：勾选”美化输出”后，生成的 JSON 文本会带上换行和缩进，方便人眼阅读，但会多用一些字符。 执行逻辑：转换成功时，执行流会从”转换成功”出口继续。转换失败时（比如传入循环引用），执行流会走”转换失败”出口，同时打印错误日志。 注意：JSON 只能处理数字、文本、布尔值、数组和普通对象。如果往里面塞了函数、引擎组件实例或循环嵌套引用，转换会失败。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | languageBaseJSONStringify |
| 分类 | 语言基础 |
| 二级分类 | JSON |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 执行流从这里进入，触发 JSON 解析。 | - | 可选 |
value | 待转换值 | 数据 | unknown | 待转换值 你想变成 JSON 文本的那个对象、数组或其它值。可以连接变量、上游数据节点或组件读取结果。 | - | 必填 |
pretty | 美化输出 | 数据 | boolean | 美化输出 勾选后输出会带换行和缩进方便阅读；取消勾选则尽量压缩在一行，适合网络传输。 | 开关 默认值：false | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
success | 转换成功 | 执行流 | 执行流 | 转换成功 JSON 文本生成完毕后从这里继续执行。此时”JSON文本”端口已经包含了序列化结果。 | - | 可选 |
result | JSON文本 | 数据 | string | JSON文本 序列化完成后的 JSON 文本。如果转换失败，这里会是空字符串。 | - | 可选 |
error | 转换失败 | 执行流 | 执行流 | 转换失败 转换失败时从这里继续执行。可以配合”错误信息”端口拿到具体原因。游戏运行时也会同时打印错误日志。 | - | 可选 |
errorMessage | 错误信息 | 数据 | string | 错误信息 转换失败时会给出原因（比如检测到循环引用），方便定位问题。成功时这里为空。 | - | 可选 |
使用场景
- 拼接 UI 文本和提示信息
- 处理数组列表、Map、Set 等集合
- 构造条件表达式和数据转换逻辑
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
- 集合类节点常区分元素、数组、映射和集合基数。