使用指南
Cocos 组件 / 3D物理 / SimplexCollider节点
Cocos 组件 / 3D物理 / SimplexCollider 节点手册，包含 12 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。
覆盖范围
- 节点数量：12
- 分类路径：Cocos 组件 / 3D物理 / SimplexCollider
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取顶点0 | simplexColliderGetVertex0 | 1 / 1 | 立即继续 |
| 获取顶点1 | simplexColliderGetVertex1 | 1 / 1 | 立即继续 |
| 获取顶点2 | simplexColliderGetVertex2 | 1 / 1 | 立即继续 |
| 获取顶点3 | simplexColliderGetVertex3 | 1 / 1 | 立即继续 |
| 获取全部属性 | simplexColliderGetProperties | 1 / 6 | 立即继续 |
| 获取形状类型 | simplexColliderGetShapeType | 1 / 1 | 立即继续 |
| 设置顶点0 | simplexColliderSetVertex0 | 3 / 2 | 立即继续 |
| 设置顶点1 | simplexColliderSetVertex1 | 3 / 2 | 立即继续 |
| 设置顶点2 | simplexColliderSetVertex2 | 3 / 2 | 立即继续 |
| 设置顶点3 | simplexColliderSetVertex3 | 3 / 2 | 立即继续 |
| 设置全部属性 | simplexColliderSetProperties | 7 / 2 | 立即继续 |
| 设置形状类型 | simplexColliderSetShapeType | 3 / 2 | 立即继续 |
获取顶点0
获取单纯形顶点0（vertex0）：返回第 1 个顶点的本地空间坐标。 vertex0 在所有形态（点、线段、三角形、四面体）中始终参与碰撞计算，是点形态的唯一顶点。 节点缩放会叠加影响最终碰撞体在世界中的位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderGetVertex0 |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vertex0 | 顶点0 | 数据 | vector3 | 顶点0（本地空间） 所有形态均使用此顶点；点形态仅需此顶点。本地坐标，不含节点缩放。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取顶点1
获取单纯形顶点1（vertex1）：返回第 2 个顶点的本地空间坐标。 在线段、三角形、四面体形态中参与碰撞计算。当 shapeType 为点（VERTEX）时，该值保留但不参与当前碰撞。 节点缩放会叠加影响最终碰撞体在世界中的位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderGetVertex1 |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vertex1 | 顶点1 | 数据 | vector3 | 顶点1（本地空间） 仅在 LINE / TRIANGLE / TETRAHEDRON 形态中参与碰撞计算；VERTEX 形态下值仍保留但不生效。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取顶点2
获取单纯形顶点2（vertex2）：返回第 3 个顶点的本地空间坐标。 仅在三角形和四面体形态中参与碰撞计算。在点或线段形态下，该值保留但不参与当前碰撞。 节点缩放会叠加影响最终碰撞体在世界中的位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderGetVertex2 |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vertex2 | 顶点2 | 数据 | vector3 | 顶点2（本地空间） 仅在 TRIANGLE / TETRAHEDRON 形态中参与碰撞计算。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取顶点3
获取单纯形顶点3（vertex3）：返回第 4 个顶点的本地空间坐标。 仅在四面体形态中参与碰撞计算。在其他形态下，该值保留但不参与当前碰撞。 节点缩放会叠加影响最终碰撞体在世界中的位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderGetVertex3 |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vertex3 | 顶点3 | 数据 | vector3 | 顶点3（本地空间） 仅在 TETRAHEDRON（四面体）形态中参与碰撞计算。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取全部属性
一次性读取 SimplexCollider 全部属性：聚合读取 shapeType、vertex0vertex3，以及便利输出当前参与碰撞的顶点列表。
vertices 输出基于当前 shapeType 自动筛选实际参与碰撞计算的顶点：点→[顶点0]、线段→[顶点0, 顶点1]、三角形→[顶点02]、四面体→[顶点0~3]。
适合调试快照、条件判断或并行分发。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderGetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
shapeType | 形状类型 | 数据 | number | 单纯形形状类型。取值：1（VERTEX）=点，2（LINE）=线段，3（TRIANGLE）=三角形，4（TETRAHEDRON）=四面体。 | - | 可选 |
vertex0 | 顶点0 | 数据 | vector3 | 第 1 个顶点（本地空间），所有形态均参与碰撞计算。 | - | 可选 |
vertex1 | 顶点1 | 数据 | vector3 | 第 2 个顶点（本地空间），仅在 LINE / TRIANGLE / TETRAHEDRON 形态中参与碰撞计算。 | - | 可选 |
vertex2 | 顶点2 | 数据 | vector3 | 第 3 个顶点（本地空间），仅在 TRIANGLE / TETRAHEDRON 形态中参与碰撞计算。 | - | 可选 |
vertex3 | 顶点3 | 数据 | vector3 | 第 4 个顶点（本地空间），仅在 TETRAHEDRON（四面体）形态中参与碰撞计算。 | - | 可选 |
vertices | 当前顶点列表 | 数据 | vector3 / array | 当前参与碰撞的顶点列表 基于 shapeType 计算：VERTEX→[vertex0]、LINE→[vertex0, vertex1]、TRIANGLE→[vertex0, vertex1, vertex2]、TETRAHEDRON→[vertex0, vertex1, vertex2, vertex3]。 这是便利衍生输出，不是引擎原生独立属性；若需要所有 4 个原始槽位，请使用 vertex0~vertex3 端口。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取形状类型
获取单纯形形状类型（shapeType）：返回当前单纯形碰撞体的几何形态。 取值：1（VERTEX）=点，2（LINE）=线段，3（TRIANGLE）=三角形，4（TETRAHEDRON）=四面体。 shapeType 决定当前碰撞体使用多少个顶点参与碰撞计算：点用 1 个顶点、线段用 2 个、三角形用 3 个、四面体用全部 4 个。 常用于判断当前碰撞体的形状类型，用于条件分支或切换碰撞形态。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderGetShapeType |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
shapeType | 形状类型 | 数据 | number | 单纯形形状类型（ESimplexType） 取值：1（VERTEX）=点，2（LINE）=线段，3（TRIANGLE）=三角形，4（TETRAHEDRON）=四面体。 该值决定当前碰撞体实际使用多少个顶点。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置顶点0
设置单纯形顶点0（vertex0）：修改第 1 个顶点的本地空间坐标。 vertex0 在所有形态中始终参与碰撞计算，是点形态的唯一顶点。 节点缩放会叠加影响最终碰撞体在世界中的位置。 常用于动态调整碰撞体的首个顶点位置，如移动检测点的位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderSetVertex0 |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
vertex0 | 顶点0 | 数据 | vector3 | 顶点0（本地空间） 始终参与碰撞计算的第 1 个顶点。写入本地坐标，实际碰撞位置还会受节点缩放影响。 | 可编辑控件 默认值：{“x”:0,“y”:0,“z”:0} | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 透传当前操作的 SimplexCollider 组件，便于链式操作。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置顶点1
设置单纯形顶点1（vertex1）：修改第 2 个顶点的本地空间坐标。 在线段、三角形、四面体形态中参与碰撞计算。在点形态下，该值保留但暂不生效，切换到需更多顶点的形态后自动参与。 节点缩放会叠加影响最终碰撞体在世界中的位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderSetVertex1 |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
vertex1 | 顶点1 | 数据 | vector3 | 顶点1（本地空间） 在线段/三角形/四面体形态中参与碰撞计算；点形态下值仍保留。 | 可编辑控件 默认值：{“x”:0,“y”:0,“z”:1} | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 透传当前操作的 SimplexCollider 组件，便于链式操作。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置顶点2
设置单纯形顶点2（vertex2）：修改第 3 个顶点的本地空间坐标。 仅在三角形和四面体形态中参与碰撞计算。在其他形态下值保留，切换到三角形或四面体后自动参与。 节点缩放会叠加影响最终碰撞体在世界中的位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderSetVertex2 |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
vertex2 | 顶点2 | 数据 | vector3 | 顶点2（本地空间） 仅在 TRIANGLE / TETRAHEDRON 形态中参与碰撞计算。 | 可编辑控件 默认值：{“x”:1,“y”:0,“z”:0} | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 透传当前操作的 SimplexCollider 组件，便于链式操作。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置顶点3
设置单纯形顶点3（vertex3）：修改第 4 个顶点的本地空间坐标。 仅在四面体形态中参与碰撞计算。在其他形态下值保留，切换到四面体后自动参与。 节点缩放会叠加影响最终碰撞体在世界中的位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderSetVertex3 |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
vertex3 | 顶点3 | 数据 | vector3 | 顶点3（本地空间） 仅在 TETRAHEDRON（四面体）形态中参与碰撞计算。 | 可编辑控件 默认值：{“x”:0,“y”:1,“z”:0} | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 透传当前操作的 SimplexCollider 组件，便于链式操作。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置全部属性
批量修改 SimplexCollider 属性：聚合写入 shapeType、vertex0~vertex3。 除 exe 与 simplexCollider 外，所有可写属性引脚默认不公开，只有被显式公开且有值的属性才参与写入。 写入顺序：shapeType → vertex0 → vertex1 → vertex2 → vertex3，和”先选形状、再填顶点”的操作习惯一致。 常用于批量更新碰撞体的顶点配置，如帧动画中逐帧调整碰撞轮廓。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderSetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
shapeType | 形状类型 | 数据 | number | 单纯形形状类型。取值：1（VERTEX）=点，2（LINE）=线段，3（TRIANGLE）=三角形，4（TETRAHEDRON）=四面体。 | 下拉选择 默认值：4 | 可选 默认隐藏 |
vertex0 | 顶点0 | 数据 | vector3 | 第 1 个顶点（本地空间），始终参与碰撞计算。 | 可编辑控件 默认值：{“x”:0,“y”:0,“z”:0} | 可选 默认隐藏 |
vertex1 | 顶点1 | 数据 | vector3 | 第 2 个顶点（本地空间），LINE / TRIANGLE / TETRAHEDRON 形态时参与碰撞。 | 可编辑控件 默认值：{“x”:0,“y”:0,“z”:1} | 可选 默认隐藏 |
vertex2 | 顶点2 | 数据 | vector3 | 第 3 个顶点（本地空间），TRIANGLE / TETRAHEDRON 形态时参与碰撞。 | 可编辑控件 默认值：{“x”:1,“y”:0,“z”:0} | 可选 默认隐藏 |
vertex3 | 顶点3 | 数据 | vector3 | 第 4 个顶点（本地空间），仅 TETRAHEDRON 形态时参与碰撞。 | 可编辑控件 默认值：{“x”:0,“y”:1,“z”:0} | 可选 默认隐藏 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 透传当前操作的 SimplexCollider 组件，便于链式操作。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置形状类型
设置单纯形形状类型（shapeType）：修改当前单纯形碰撞体的几何形态。
取值：1（VERTEX）=点，2（LINE）=线段，3（TRIANGLE）=三角形，4（TETRAHEDRON）=四面体。
改变形态后，只有对应的前 N 个顶点参与碰撞计算：点只用顶点0，线段用顶点01，三角形用顶点02，四面体用全部 4 个。
常用于切换碰撞形状类型，如根据游戏状态在点检测和区域检测间切换。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | simplexColliderSetShapeType |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | SimplexCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 要操作的单纯形碰撞体组件。 SimplexCollider 是 3D 物理中用于点、线段、三角形、四面体等轻量凸形体的碰撞体。本地顶点配置会与节点缩放共同决定最终碰撞几何。 | - | 必填 |
shapeType | 形状类型 | 数据 | number | 单纯形形状类型（ESimplexType） 取值：1（VERTEX）=点，2（LINE）=线段，3（TRIANGLE）=三角形，4（TETRAHEDRON）=四面体。 | 下拉选择 默认值：4 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
simplexCollider | 单纯形碰撞体 | 数据 | cc.Component / SimplexCollider | 目标 SimplexCollider 组件 透传当前操作的 SimplexCollider 组件，便于链式操作。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。