使用指南
Cocos 节点 / 变换节点
Cocos 节点 / 变换 节点手册，包含 22 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
操作场景中的 Node 对象，包括层级、变换、组件、激活状态和场景查找。
覆盖范围
- 节点数量：22
- 分类路径：Cocos 节点 / 变换
典型使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
通用注意事项
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 变换是否需要更新 | nodeGetIsTransformDirty | 1 / 1 | 立即继续 |
| 朝向目标点 | nodeLookAt | 4 / 2 | 立即继续 |
| 更新世界变换 | nodeUpdateWorldTransform | 2 / 2 | 立即继续 |
| 获取本地缩放 | nodeGetScale | 1 / 1 | 立即继续 |
| 获取本地位置 | nodeGetPosition | 1 / 1 | 立即继续 |
| 获取本地旋转 | nodeGetRotation | 1 / 1 | 立即继续 |
| 获取前向向量 | nodeGetForward | 1 / 1 | 立即继续 |
| 获取上向向量 | nodeGetUp | 1 / 1 | 立即继续 |
| 获取世界缩放 | nodeGetWorldScale | 1 / 1 | 立即继续 |
| 获取世界位置 | nodeGetWorldPosition | 1 / 1 | 立即继续 |
| 获取世界旋转 | nodeGetWorldRotation | 1 / 1 | 立即继续 |
| 获取右向向量 | nodeGetRight | 1 / 1 | 立即继续 |
| 平移 | nodeTranslate | 4 / 2 | 立即继续 |
| 设置本地缩放 | nodeSetScale | 3 / 2 | 立即继续 |
| 设置本地位置 | nodeSetPosition | 3 / 2 | 立即继续 |
| 设置本地旋转 | nodeSetRotation | 3 / 2 | 立即继续 |
| 设置变换 | nodeSetRTS | 5 / 2 | 立即继续 |
| 设置世界缩放 | nodeSetWorldScale | 3 / 2 | 立即继续 |
| 设置世界位置 | nodeSetWorldPosition | 3 / 2 | 立即继续 |
| 设置世界旋转 | nodeSetWorldRotation | 3 / 2 | 立即继续 |
| 世界点转本地点 | nodeInverseTransformPoint | 2 / 1 | 立即继续 |
| 旋转增量 | nodeRotate | 4 / 2 | 立即继续 |
变换是否需要更新
获取变换是否需要更新：检查节点的变换是否有未同步的修改。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeGetIsTransformDirty |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
node | 节点 | 数据 | cc.Node | 目标节点 要检查变换状态的节点 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
dirty | 需要更新 | 数据 | boolean | 是否需要更新 true表示变换有待同步的修改 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
朝向目标点
朝向目标点：使节点朝向指定的世界坐标点。 适合让敌人朝向玩家、摄像机对准目标等。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeLookAt |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发朝向操作 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要调整朝向的节点 | - | 必填 |
target | 目标点 | 数据 | vector3 | 目标世界坐标 节点要朝向的目标点（三维坐标） | 可编辑控件 默认值：[0,0,0] | 必填 |
up | 上方向 | 数据 | vector3 | 上方向向量 定义”上”的方向，默认 Y 轴正方向 | 可编辑控件 默认值：[0,1,0] | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 朝向设置完成后继续执行 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要调整朝向的节点 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
更新世界变换
更新世界变换：强制刷新节点的世界变换。 在修改位置/旋转/缩放后，需要立即获取准确的世界坐标时使用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeUpdateWorldTransform |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发更新操作 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要更新世界变换的节点 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 更新完成后继续执行 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要更新世界变换的节点 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取本地缩放
获取本地缩放：获取相对父节点的缩放。 适合读取物体的大小比例。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeGetScale |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
node | 节点 | 数据 | cc.Node | 目标节点 要获取缩放的节点 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scale | 本地缩放 | 数据 | vector3 | 本地缩放 三维向量 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取本地位置
获取本地位置：获取相对父节点的位置。 适合读取角色当前位置，输出三维向量。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeGetPosition |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
node | 节点 | 数据 | cc.Node | 目标节点 要获取位置的节点 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
position | 本地位置 | 数据 | vector3 | 本地位置 三维向量 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取本地旋转
获取本地旋转：获取相对父节点的旋转。 适合读取角色的朝向信息。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeGetRotation |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
node | 节点 | 数据 | cc.Node | 目标节点 要获取旋转的节点 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
rotation | 本地旋转 | 数据 | quaternion | 本地旋转 四元数 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取前向向量
获取前向向量：获取节点前方朝向的单位向量。 适合控制角色朝前移动、发射子弹等。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeGetForward |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
node | 节点 | 数据 | cc.Node | 目标节点 要获取前向向量的节点 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
dir | 前向 | 数据 | vector3 | 前向向量 单位向量（三维） | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取上向向量
获取上向向量：获取节点上方朝向的单位向量。 适合控制角色跳跃方向或定义”上”的参照。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeGetUp |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
node | 节点 | 数据 | cc.Node | 目标节点 要获取上向向量的节点 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
dir | 上向 | 数据 | vector3 | 上向向量 单位向量（三维） | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取世界缩放
获取世界缩放：获取场景全局坐标系下的累积缩放。 包含父节点缩放影响的最终结果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeGetWorldScale |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
node | 节点 | 数据 | cc.Node | 目标节点 要获取世界缩放的节点 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scale | 世界缩放 | 数据 | vector3 | 世界缩放 三维向量 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取世界位置
获取世界位置：获取场景全局坐标系下的位置。 适合获取角色在场景中的绝对坐标。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeGetWorldPosition |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
node | 节点 | 数据 | cc.Node | 目标节点 要获取世界位置的节点 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
position | 世界位置 | 数据 | vector3 | 世界位置 三维向量 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取世界旋转
获取世界旋转：获取场景全局坐标系下的旋转。 适合读取物体在世界空间中的朝向。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeGetWorldRotation |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
node | 节点 | 数据 | cc.Node | 目标节点 要获取世界旋转的节点 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
rotation | 世界旋转 | 数据 | quaternion | 世界旋转 四元数 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取右向向量
获取右向向量：获取节点右方朝向的单位向量。 适合控制角色左右移动或侧向偏移。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeGetRight |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
node | 节点 | 数据 | cc.Node | 目标节点 要获取右向向量的节点 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
dir | 右向 | 数据 | vector3 | 右向向量 单位向量（三维） | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
平移
平移：沿指定方向和距离移动节点。 适合实现角色行走、子弹飞行等持续移动效果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeTranslate |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发平移操作 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要平移的节点 | - | 必填 |
delta | 位移 | 数据 | vector3 | 位移向量 平移的方向和距离（三维向量） | 可编辑控件 默认值：[0,0,0] | 必填 |
space | 空间 | 数据 | enum / NodeSpace | 空间类型 LOCAL: 本地空间 WORLD: 世界空间 | 下拉选择 默认值：“LOCAL” | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 平移完成后继续执行 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要平移的节点 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
设置本地缩放
设置本地缩放：设置相对父节点的缩放。 适合实现物体变大变小、UI缩放动画等效果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeSetScale |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发设置缩放 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置缩放的节点 | - | 必填 |
scale | 本地缩放 | 数据 | vector3 | 本地缩放 要设置的缩放（三维向量） | 可编辑控件 默认值：[1,1,1] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 设置完成后继续执行 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置缩放的节点 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
设置本地位置
设置本地位置：设置相对父节点的位置。 适合控制角色移动、传送道具到指定位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeSetPosition |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发设置位置 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置位置的节点 | - | 必填 |
position | 本地位置 | 数据 | vector3 | 本地位置 要设置的位置（三维向量） | 可编辑控件 默认值：[0,0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 设置完成后继续执行 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置位置的节点 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
设置本地旋转
设置本地旋转：设置相对父节点的旋转。 适合控制角色转向、物体旋转等。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeSetRotation |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发设置旋转 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置旋转的节点 | - | 必填 |
rotation | 本地旋转 | 数据 | quaternion | 本地旋转 要设置的旋转（四元数） | 可编辑控件 默认值：[0,0,0,1] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 设置完成后继续执行 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置旋转的节点 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
设置变换
一次性设置变换：同时设置旋转、位置和缩放。 所有参数均为可选，未设置的属性保持原值。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeSetRTS |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发变换设置 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置变换的节点 | - | 必填 |
rotation | 旋转 | 数据 | quaternion | 旋转 四元数，可选 | - | 可选 |
position | 位置 | 数据 | vector3 | 位置 三维向量，可选 | - | 可选 |
scale | 缩放 | 数据 | vector3 | 缩放 三维向量，可选 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 变换设置完成后继续执行 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置变换的节点 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
设置世界缩放
设置世界缩放：设置场景全局坐标系下的缩放。 适合直接控制物体在世界中的最终大小。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeSetWorldScale |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发设置世界缩放 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置世界缩放的节点 | - | 必填 |
scale | 世界缩放 | 数据 | vector3 | 世界缩放 要设置的世界缩放（三维向量） | 可编辑控件 默认值：[1,1,1] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 设置完成后继续执行 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置世界缩放的节点 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
设置世界位置
设置世界位置：设置场景全局坐标系下的位置。 适合将角色传送到场景中的指定绝对位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeSetWorldPosition |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发设置世界位置 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置世界位置的节点 | - | 必填 |
position | 世界位置 | 数据 | vector3 | 世界位置 要设置的世界位置（三维向量） | 可编辑控件 默认值：[0,0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 设置完成后继续执行 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置世界位置的节点 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
设置世界旋转
设置世界旋转：设置场景全局坐标系下的旋转。 适合直接控制物体在世界中的朝向。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeSetWorldRotation |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发设置世界旋转 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置世界旋转的节点 | - | 必填 |
rotation | 世界旋转 | 数据 | quaternion | 世界旋转 要设置的世界旋转（四元数） | 可编辑控件 默认值：[0,0,0,1] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 设置完成后继续执行 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要设置世界旋转的节点 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
世界点转本地点
世界点转本地点：将世界坐标转换为节点的本地坐标。 适合判断目标相对于自身的位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeInverseTransformPoint |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
node | 节点 | 数据 | cc.Node | 目标节点 作为参照的节点 | - | 必填 |
worldPoint | 世界坐标 | 数据 | vector3 | 世界坐标 要转换的世界坐标（三维） | 可编辑控件 默认值：[0,0,0] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
localPoint | 本地坐标 | 数据 | vector3 | 本地坐标 转换后的本地坐标（三维） | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
旋转增量
旋转增量：按指定的旋转量旋转节点。 适合实现物体持续旋转或转动效果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | nodeRotate |
| 分类 | Cocos 节点 |
| 二级分类 | 变换 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发旋转操作 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要旋转的节点 | - | 必填 |
deltaRotation | 旋转增量 | 数据 | quaternion | 旋转增量 四元数 | 可编辑控件 默认值：[0,0,0,1] | 必填 |
space | 空间 | 数据 | enum / NodeSpace | 空间类型 LOCAL: 本地空间 WORLD: 世界空间 | 下拉选择 默认值：“LOCAL” | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 旋转完成后继续执行 | - | 可选 |
node | 节点 | 数据 | cc.Node | 目标节点 要旋转的节点 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。