使用指南
资产 / 材质 / PhysicsMaterial节点
资产 / 材质 / PhysicsMaterial 节点手册，包含 13 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
读取和验证 Cocos 资产对象，把图片、音频、材质、Prefab 等资源接入工作流逻辑。
覆盖范围
- 节点数量：13
- 分类路径：资产 / 材质 / PhysicsMaterial
典型使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
通用注意事项
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取弹性系数 | physicsMaterialGetRestitution | 1 / 1 | 立即继续 |
| 获取滚动摩擦系数 | physicsMaterialGetRollingFriction | 1 / 1 | 立即继续 |
| 获取摩擦系数 | physicsMaterialGetFriction | 1 / 1 | 立即继续 |
| 获取全部系数 | physicsMaterialGetProperties | 1 / 4 | 立即继续 |
| 获取自旋摩擦系数 | physicsMaterialGetSpinningFriction | 1 / 1 | 立即继续 |
| 克隆物理材质 | physicsMaterialClone | 2 / 2 | 立即继续 |
| 批量设置属性 | physicsMaterialSetProperties | 6 / 2 | 立即继续 |
| 批量设置系数 | physicsMaterialSetValues | 6 / 2 | 立即继续 |
| 设置弹性系数 | physicsMaterialSetRestitution | 3 / 2 | 立即继续 |
| 设置滚动摩擦系数 | physicsMaterialSetRollingFriction | 3 / 2 | 立即继续 |
| 设置摩擦系数 | physicsMaterialSetFriction | 3 / 2 | 立即继续 |
| 设置自旋摩擦系数 | physicsMaterialSetSpinningFriction | 3 / 2 | 立即继续 |
| 新建物理材质 | physicsMaterialCreate | 1 / 2 | 立即继续 |
获取弹性系数
读取 PhysicsMaterial 的 弹性系数（restitution）。 推荐范围 [0, 1]；0 = 完全非弹性碰撞（不弹跳），1 = 完全弹性碰撞。调整此值可以控制物体碰撞后的弹跳程度，如制作弹跳球效果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialGetRestitution |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
restitution | 弹性系数 | 数据 | number | 弹性系数（restitution） 控制碰撞后的弹跳程度，推荐范围 [0, 1]。 0 = 完全非弹性碰撞；1 = 完全弹性碰撞（能量无损失）。 引擎本身不做强制裁剪，超出范围的值由物理后端决定行为。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取滚动摩擦系数
读取 PhysicsMaterial 的 rollingFriction 属性（滚动摩擦系数）。 仅 Bullet 物理后端支持；其他后端该值不生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialGetRollingFriction |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
rollingFriction | 滚动摩擦系数 | 数据 | number | 滚动摩擦系数（rollingFriction） 控制物体滚动时的摩擦力大小。 仅 Bullet 物理后端支持；其他后端（如 PhysX）节点可写但该值无效果。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取摩擦系数
读取 PhysicsMaterial 的 摩擦系数（friction）。 值越大，接触面阻力越大。可配合物理材质调整，让物体表面更”滑”或更”涩”。引擎默认值为 0.6。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialGetFriction |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
friction | 摩擦系数 | 数据 | number | 摩擦系数（friction） 控制物体接触面的摩擦力大小。 0 = 无摩擦；值越大，接触时阻力越大。默认为 0.6。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取全部系数
一次性读取 PhysicsMaterial 的全部 4 项系数，适合同时查看多个物理属性。 注意：滚动摩擦与自旋摩擦仅 Bullet 后端支持，其他后端可能返回 0。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialGetProperties |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
friction | 摩擦系数 | 数据 | number | 摩擦系数（friction） 控制物体接触面的摩擦力大小。 0 = 无摩擦；值越大，接触时阻力越大。默认为 0.6。 | - | 可选 |
rollingFriction | 滚动摩擦系数 | 数据 | number | 滚动摩擦系数（rollingFriction） 控制物体滚动时的摩擦力大小。 仅 Bullet 物理后端支持；其他后端（如 PhysX）节点可写但该值无效果。 | - | 可选 |
spinningFriction | 自旋摩擦系数 | 数据 | number | 自旋摩擦系数（spinningFriction） 控制物体自旋时的摩擦力大小。 仅 Bullet 物理后端支持；其他后端（如 PhysX）节点可写但该值无效果。 | - | 可选 |
restitution | 弹性系数 | 数据 | number | 弹性系数（restitution） 控制碰撞后的弹跳程度，推荐范围 [0, 1]。 0 = 完全非弹性碰撞；1 = 完全弹性碰撞（能量无损失）。 引擎本身不做强制裁剪，超出范围的值由物理后端决定行为。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取自旋摩擦系数
读取 PhysicsMaterial 的 spinningFriction 属性（自旋摩擦系数）。 仅 Bullet 物理后端支持；其他后端该值不生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialGetSpinningFriction |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
spinningFriction | 自旋摩擦系数 | 数据 | number | 自旋摩擦系数（spinningFriction） 控制物体自旋时的摩擦力大小。 仅 Bullet 物理后端支持；其他后端（如 PhysX）节点可写但该值无效果。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
克隆物理材质
复制原实例的系数，生成全新的 PhysicsMaterial 实例。 克隆产生的是独立对象，修改克隆不会影响原始资产。适用于”复制后局部调整”的场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialClone |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
clone | 克隆 | 数据 | cc.Asset / PhysicsMaterial | 克隆实例 与原物理材质系数相同的全新实例，修改它不会影响原始资产。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
批量设置属性
按公开引脚语义批量修改 PhysicsMaterial 的系数。只有被显式公开的引脚才参与写入，未公开的引脚保持不变。 注意：滚动摩擦与自旋摩擦仅 Bullet 后端支持，其他后端写入不生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialSetProperties |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
friction | 摩擦系数 | 数据 | number | 摩擦系数（friction） 控制物体接触面的摩擦力大小。 0 = 无摩擦；值越大，接触时阻力越大。默认为 0.6。 | 输入框 默认值：0.6 | 可选 默认隐藏 |
rollingFriction | 滚动摩擦系数 | 数据 | number | 滚动摩擦系数（rollingFriction） 控制物体滚动时的摩擦力大小。 仅 Bullet 物理后端支持；其他后端（如 PhysX）节点可写但该值无效果。 | 输入框 默认值：0 | 可选 默认隐藏 |
spinningFriction | 自旋摩擦系数 | 数据 | number | 自旋摩擦系数（spinningFriction） 控制物体自旋时的摩擦力大小。 仅 Bullet 物理后端支持；其他后端（如 PhysX）节点可写但该值无效果。 | 输入框 默认值：0 | 可选 默认隐藏 |
restitution | 弹性系数 | 数据 | number | 弹性系数（restitution） 控制碰撞后的弹跳程度，推荐范围 [0, 1]。 0 = 完全非弹性碰撞；1 = 完全弹性碰撞（能量无损失）。 引擎本身不做强制裁剪，超出范围的值由物理后端决定行为。 | 输入框 默认值：0 | 可选 默认隐藏 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质（透传） 把当前操作的 PhysicsMaterial 实例原样传出，便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
批量设置系数
一次性覆盖物理材质的全部 4 个系数（摩擦、滚动摩擦、自旋摩擦、弹性）。 这是整组覆盖，每一项都会被写入。若只想修改部分字段，请改用 批量设置属性。注意：滚动摩擦与自旋摩擦仅 Bullet 后端支持，其他后端写入不生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialSetValues |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
friction | 摩擦系数 | 数据 | number | 摩擦系数（friction） 控制物体接触面的摩擦力大小。 0 = 无摩擦；值越大，接触时阻力越大。默认为 0.6。 | 输入框 默认值：0.6 | 可选 |
rollingFriction | 滚动摩擦系数 | 数据 | number | 滚动摩擦系数（rollingFriction） 控制物体滚动时的摩擦力大小。 仅 Bullet 物理后端支持；其他后端（如 PhysX）节点可写但该值无效果。 | 输入框 默认值：0 | 可选 |
spinningFriction | 自旋摩擦系数 | 数据 | number | 自旋摩擦系数（spinningFriction） 控制物体自旋时的摩擦力大小。 仅 Bullet 物理后端支持；其他后端（如 PhysX）节点可写但该值无效果。 | 输入框 默认值：0 | 可选 |
restitution | 弹性系数 | 数据 | number | 弹性系数（restitution） 控制碰撞后的弹跳程度，推荐范围 [0, 1]。 0 = 完全非弹性碰撞；1 = 完全弹性碰撞（能量无损失）。 引擎本身不做强制裁剪，超出范围的值由物理后端决定行为。 | 输入框 默认值：0 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质（透传） 把当前操作的 PhysicsMaterial 实例原样传出，便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置弹性系数
设置 PhysicsMaterial 的 弹性系数（restitution）。 推荐范围 [0, 1]；引擎不做强制裁剪，超出范围的值由物理后端决定行为。用于控制碰撞后的弹跳效果，如制作弹跳球、蹦床等物理效果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialSetRestitution |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
restitution | 弹性系数 | 数据 | number | 弹性系数（restitution） 控制碰撞后的弹跳程度，推荐范围 [0, 1]。 0 = 完全非弹性碰撞；1 = 完全弹性碰撞（能量无损失）。 引擎本身不做强制裁剪，超出范围的值由物理后端决定行为。 | 输入框 默认值：0 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质（透传） 把当前操作的 PhysicsMaterial 实例原样传出，便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置滚动摩擦系数
设置 PhysicsMaterial 的 rollingFriction 属性（滚动摩擦系数）。 仅 Bullet 物理后端支持；其他后端节点可写但该值不生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialSetRollingFriction |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
rollingFriction | 滚动摩擦系数 | 数据 | number | 滚动摩擦系数（rollingFriction） 控制物体滚动时的摩擦力大小。 仅 Bullet 物理后端支持；其他后端（如 PhysX）节点可写但该值无效果。 | 输入框 默认值：0 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质（透传） 把当前操作的 PhysicsMaterial 实例原样传出，便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置摩擦系数
设置 PhysicsMaterial 的 摩擦系数（friction）。 值越大，接触面阻力越大。引擎默认值为 0.6。可用于实现冰面滑行、粗糙地面减速等不同手感。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialSetFriction |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
friction | 摩擦系数 | 数据 | number | 摩擦系数（friction） 控制物体接触面的摩擦力大小。 0 = 无摩擦；值越大，接触时阻力越大。默认为 0.6。 | 输入框 默认值：0.6 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质（透传） 把当前操作的 PhysicsMaterial 实例原样传出，便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置自旋摩擦系数
设置 PhysicsMaterial 的 spinningFriction 属性（自旋摩擦系数）。 仅 Bullet 物理后端支持；其他后端节点可写但该值不生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialSetSpinningFriction |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质 这里需要连接一个已经加载好的 PhysicsMaterial 实例。 该端口没有”选择资产”按钮，请先使用以下方式获取实例： - 加载资产：把”类型”选为 PHYSICS_MATERIAL，从资产包按路径异步加载。 - 获取资产：取出资产包里已加载的 PhysicsMaterial。 - 新建物理材质：创建一个新实例。 | - | 必填 |
spinningFriction | 自旋摩擦系数 | 数据 | number | 自旋摩擦系数（spinningFriction） 控制物体自旋时的摩擦力大小。 仅 Bullet 物理后端支持；其他后端（如 PhysX）节点可写但该值无效果。 | 输入框 默认值：0 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 物理材质（透传） 把当前操作的 PhysicsMaterial 实例原样传出，便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
新建物理材质
在游戏运行时创建一个全新的 PhysicsMaterial 实例。 新实例的初始系数为引擎默认值（摩擦 0.6、其余 0）。若要加载已有的物理材质文件，请使用 加载资产，并把类型选为 PHYSICS_MATERIAL。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | physicsMaterialCreate |
| 分类 | 资产 |
| 二级分类 | 材质 |
| 分组 | PhysicsMaterial |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
physicsMaterial | 物理材质 | 数据 | cc.Asset / PhysicsMaterial | PhysicsMaterial 实例 新建的物理材质实例。可直接使用，也可通过 设置类节点调整系数。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。