使用指南
Cocos 组件 / 3D物理 / TerrainCollider节点
Cocos 组件 / 3D物理 / TerrainCollider 节点手册，包含 2 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。
覆盖范围
- 节点数量：2
- 分类路径：Cocos 组件 / 3D物理 / TerrainCollider
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取地形资产 | terrainColliderGetTerrain | 1 / 1 | 立即继续 |
| 设置地形资产 | terrainColliderSetTerrain | 3 / 2 | 立即继续 |
获取地形资产
获取地形资产：返回 TerrainCollider 当前引用的 TerrainAsset 资产。 这是碰撞体用于高度场碰撞检测的地形资产，不是场景中的 cc.Terrain 渲染组件实例。 未配置时返回 null。常用于判断地形碰撞体是否已绑定地形数据。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | terrainColliderGetTerrain |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | TerrainCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
terrainCollider | - | 数据 | cc.Component / TerrainCollider | 目标 TerrainCollider 组件 要操作的地形碰撞体组件。 TerrainCollider 是 3D 物理中专用于地形高度场碰撞的组件，常用于大地图地表、山体与坡道。terrain 属性决定碰撞所依据的高度场数据。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
terrain | 地形资产 | 数据 | cc.Asset / TerrainAsset | 地形资产 TerrainCollider 当前引用的地形资产（TerrainAsset），用于高度场碰撞检测。 注意：这是物理碰撞所依据的地形资产，不是场景中的 cc.Terrain 渲染组件实例。 未配置时返回 null。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置地形资产
设置地形资产：修改 TerrainCollider 引用的 TerrainAsset 资产。 注意：修改的是碰撞体所依据的地形资产，不会自动修改场景中 cc.Terrain 渲染组件所引用的资产。 传入 null 可清空当前地形资产引用。 常用于游戏运行时切换地形数据，如场景切换时更换碰撞地形。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | terrainColliderSetTerrain |
| 分类 | Cocos 组件 |
| 二级分类 | 3D物理 |
| 分组 | TerrainCollider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
terrainCollider | - | 数据 | cc.Component / TerrainCollider | 目标 TerrainCollider 组件 要操作的地形碰撞体组件。 TerrainCollider 是 3D 物理中专用于地形高度场碰撞的组件，常用于大地图地表、山体与坡道。terrain 属性决定碰撞所依据的高度场数据。 | - | 必填 |
terrain | 地形资产 | 数据 | cc.Asset / TerrainAsset | 地形资产 要设置的地形资产（TerrainAsset）。 传入 null 可清空当前地形资产引用。 无内联选择器，请连接上游 TerrainAsset 资产节点或已加载实例。 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
terrainCollider | - | 数据 | cc.Component / TerrainCollider | 目标 TerrainCollider 组件 透传当前操作的 TerrainCollider 组件，便于链式操作。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。