使用指南
资产 / JSON / JsonAsset节点
资产 / JSON / JsonAsset 节点手册，包含 3 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
读取和验证 Cocos 资产对象，把图片、音频、材质、Prefab 等资源接入工作流逻辑。
覆盖范围
- 节点数量：3
- 分类路径：资产 / JSON / JsonAsset
典型使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
通用注意事项
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取 JSON 对象 | jsonAssetGetJson | 1 / 1 | 立即继续 |
| 设置 JSON 对象 | jsonAssetSetJson | 3 / 2 | 立即继续 |
| 新建 JSON 资产 | jsonAssetCreate | 1 / 2 | 立即继续 |
获取 JSON 对象
读取 JsonAsset 的 json 属性，返回引擎已解析好的 JSON 对象（Record<string, any>）。 适合传给对象变量、条件判断或自定义逻辑进行消费。若 JsonAsset 尚未填充内容（例如新建空实例），则返回 null。 注意：这是已解析对象，不是原始 JSON 文本。若要读取原始文本，请使用文本资产相关的 获取文本 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | jsonAssetGetJson |
| 分类 | 资产 |
| 二级分类 | JSON |
| 分组 | JsonAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
jsonAsset | JSON 资产 | 数据 | cc.Asset / JsonAsset | JsonAsset JSON 配置资产 这里需要连接一个已经加载好的 JsonAsset 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取 JSON 资产实例： - 加载资产：把”类型”选为 JSON_ASSET，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 JsonAsset。 - 新建 JSON 资产：创建一个空 JsonAsset 实例。 注意：JsonAsset 是已解析 JSON 对象的资产容器，不是原始 JSON 文本文件。若要读取未解析的原始文本，请使用文本资产相关的 获取文本 节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
json | JSON 对象 | 数据 | object | JSON 对象 引擎已解析好的 JSON 对象（Record<string, any>），适合继续传给对象变量、条件判断或自定义逻辑。 若 JsonAsset 尚未填充内容则返回 null。 注意：这是已解析对象，不是原始 JSON 文本。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置 JSON 对象
以整对象替换的方式将新内容写入 JsonAsset 的 json 属性。 推荐在上游先用对象变量、对象构造节点准备好完整对象，再整体写回。该操作不是字段级 patch，旧的字段会被全部覆盖。 json 端口不提供内联编辑器，需要通过连线连接上游对象，不要将 JSON 字符串连入此端口。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | jsonAssetSetJson |
| 分类 | 资产 |
| 二级分类 | JSON |
| 分组 | JsonAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
jsonAsset | JSON 资产 | 数据 | cc.Asset / JsonAsset | JsonAsset JSON 配置资产 这里需要连接一个已经加载好的 JsonAsset 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取 JSON 资产实例： - 加载资产：把”类型”选为 JSON_ASSET，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 JsonAsset。 - 新建 JSON 资产：创建一个空 JsonAsset 实例。 注意：JsonAsset 是已解析 JSON 对象的资产容器，不是原始 JSON 文本文件。若要读取未解析的原始文本，请使用文本资产相关的 获取文本 节点。 | - | 必填 |
json | JSON 对象 | 数据 | object | JSON 对象 要写回 JsonAsset 的完整对象（整对象替换，非字段级 patch）。 该端口不提供内联编辑器，请通过连线连接上游对象变量、对象构造节点或业务逻辑准备的完整对象。 注意：不要尝试将 JSON 字符串连入此端口，JsonAsset 需要的是已解析对象。 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
jsonAsset | JSON 资产 | 数据 | cc.Asset / JsonAsset | JsonAsset（透传） 把当前操作的 JsonAsset 实例原样传出，便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
新建 JSON 资产
在游戏运行时创建一个全新的空 JsonAsset 实例。 空实例的 json 属性为 null，需要通过 设置 JSON 对象 节点写入对象内容后才可使用。 若要加载已有的 .json 资产文件，请改用 加载资产（类型选 JSON_ASSET）或 获取资产。 重要：JsonAsset 是已解析 JSON 对象的资产容器，不是原始 JSON 文本。若需要读取原始文本，请使用文本资产相关的 获取文本 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | jsonAssetCreate |
| 分类 | 资产 |
| 二级分类 | JSON |
| 分组 | JsonAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
jsonAsset | JSON 资产 | 数据 | cc.Asset / JsonAsset | JsonAsset 实例 新建的空 JsonAsset 实例，json 属性为 null。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。