使用指南
资产 / 文本 / TextAsset节点
资产 / 文本 / TextAsset 节点手册，包含 6 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
读取和验证 Cocos 资产对象，把图片、音频、材质、Prefab 等资源接入工作流逻辑。
覆盖范围
- 节点数量：6
- 分类路径：资产 / 文本 / TextAsset
典型使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
通用注意事项
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取全部属性 | textAssetGetProperties | 1 / 3 | 立即继续 |
| 获取文本 | textAssetGetText | 1 / 1 | 立即继续 |
| 获取文本长度 | textAssetGetLength | 1 / 1 | 立即继续 |
| 设置文本 | textAssetSetText | 3 / 2 | 立即继续 |
| 文本是否为空 | textAssetGetIsEmpty | 1 / 1 | 立即继续 |
| 新建文本资产 | textAssetCreate | 1 / 2 | 立即继续 |
获取全部属性
一次性读取文本资产的全部已节点化信息，同时输出 text（原始字符串）、length（字符长度）和 isEmpty（是否为空）。 等同于同时使用 获取文本、获取文本长度 和 文本是否为空，但只用一个节点即可，适合调试或需要完整文本状态快照的场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | textAssetGetProperties |
| 分类 | 资产 |
| 二级分类 | 文本 |
| 分组 | TextAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
textAsset | 文本资产 | 数据 | cc.Asset / TextAsset | TextAsset 文本资产 这里需要连接一个已经加载好的 TextAsset 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取文本资产实例： - 加载资产：把”类型”选为 TEXT_ASSET，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 TextAsset。 - 新建文本资产：创建一个空文本资产实例。 注意：TextAsset 是文本资产本体，不负责解析 JSON。如需读取已解析 JSON 对象，请使用 JSON 资产相关的 获取 JSON 对象 节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
text | 文本 | 数据 | string | 文本（text） 文本资产中的原始文本字符串。 | - | 可选 |
length | 长度 | 数据 | number | 长度（length） 字符长度。 | - | 可选 |
isEmpty | 为空 | 数据 | boolean | 为空（isEmpty） 是否为空字符串。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取文本
读取文本资产的 text 属性，返回原始文本字符串。 注意：这一步不会解析 JSON，只返回原始文本。如需读取已解析 JSON 对象，请使用 JSON 资产相关的 获取 JSON 对象 节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | textAssetGetText |
| 分类 | 资产 |
| 二级分类 | 文本 |
| 分组 | TextAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
textAsset | 文本资产 | 数据 | cc.Asset / TextAsset | TextAsset 文本资产 这里需要连接一个已经加载好的 TextAsset 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取文本资产实例： - 加载资产：把”类型”选为 TEXT_ASSET，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 TextAsset。 - 新建文本资产：创建一个空文本资产实例。 注意：TextAsset 是文本资产本体，不负责解析 JSON。如需读取已解析 JSON 对象，请使用 JSON 资产相关的 获取 JSON 对象 节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
text | 文本 | 数据 | string | 文本（text） 文本资产中的原始文本字符串。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取文本长度
返回文本资产中 text 属性的字符长度（text.length）。 常用于快速判断配置文本是否为空或是否超出预期长度，无需手动连接 获取文本 → 获取文本长度 → 比较节点的冗长链路。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | textAssetGetLength |
| 分类 | 资产 |
| 二级分类 | 文本 |
| 分组 | TextAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
textAsset | 文本资产 | 数据 | cc.Asset / TextAsset | TextAsset 文本资产 这里需要连接一个已经加载好的 TextAsset 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取文本资产实例： - 加载资产：把”类型”选为 TEXT_ASSET，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 TextAsset。 - 新建文本资产：创建一个空文本资产实例。 注意：TextAsset 是文本资产本体，不负责解析 JSON。如需读取已解析 JSON 对象，请使用 JSON 资产相关的 获取 JSON 对象 节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
length | 长度 | 数据 | number | 长度（length） 文本资产中 text 的字符长度。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置文本
将新的字符串写入目标文本资产的 text 属性。 短文本可直接在内联输入框中填写。长 JSON 文本建议改由字符串变量、上游字符串拼接节点或加载得到的文本输入，避免在小型输入框中手填大段内容。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | textAssetSetText |
| 分类 | 资产 |
| 二级分类 | 文本 |
| 分组 | TextAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
textAsset | 文本资产 | 数据 | cc.Asset / TextAsset | TextAsset 文本资产 这里需要连接一个已经加载好的 TextAsset 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取文本资产实例： - 加载资产：把”类型”选为 TEXT_ASSET，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 TextAsset。 - 新建文本资产：创建一个空文本资产实例。 注意：TextAsset 是文本资产本体，不负责解析 JSON。如需读取已解析 JSON 对象，请使用 JSON 资产相关的 获取 JSON 对象 节点。 | - | 必填 |
text | 文本 | 数据 | string | 文本（text） 要写入文本资产的字符串。短文本可直接填写，长 JSON 建议改由字符串变量或上游字符串节点提供。 | 输入框 默认值："" | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
textAsset | 文本资产 | 数据 | cc.Asset / TextAsset | TextAsset 文本资产（透传） 把当前操作的 TextAsset 实例原样传出，便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
文本是否为空
判断文本资产的 text 属性是否为空字符串（text.length === 0）。 返回 true 表示文本为空，false 表示文本非空。比手动连接 获取文本 → 获取文本长度 → 与 0 比较更直接。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | textAssetGetIsEmpty |
| 分类 | 资产 |
| 二级分类 | 文本 |
| 分组 | TextAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
textAsset | 文本资产 | 数据 | cc.Asset / TextAsset | TextAsset 文本资产 这里需要连接一个已经加载好的 TextAsset 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取文本资产实例： - 加载资产：把”类型”选为 TEXT_ASSET，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 TextAsset。 - 新建文本资产：创建一个空文本资产实例。 注意：TextAsset 是文本资产本体，不负责解析 JSON。如需读取已解析 JSON 对象，请使用 JSON 资产相关的 获取 JSON 对象 节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isEmpty | 为空 | 数据 | boolean | 为空（isEmpty） 文本资产内容是否为空字符串（true/false）。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
新建文本资产
在游戏运行时创建一个全新的空文本资产实例。 默认文本为空字符串，适合在游戏运行时临时组装 JSON 或文本内容。若要加载已有的文本资产文件，请使用 加载资产，并把类型选为 TEXT_ASSET。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | textAssetCreate |
| 分类 | 资产 |
| 二级分类 | 文本 |
| 分组 | TextAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
textAsset | 文本资产 | 数据 | cc.Asset / TextAsset | TextAsset 实例 新建的空文本资产实例，默认文本为空字符串。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。