Search Results for

    Show / Hide Table of Contents

    配置轮式载具

    中文 | English

    在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。 命令也会重拍两种语言的配图。

    python Docs/Manual/manual/tools/tutorials.py run physics-wheels --capture
    
    点击展开 MCP 操作点击收起 MCP 操作

    准备教学样例。${变量} 由配方提供。

    {
      "variables": {
        "vehicle": "${fixture}/Tutorial_WheeledVehicle.asset",
        "model": "${fixture}/Tutorial_WheeledBody.prefab",
        "collider": "${fixture}/Tutorial_WheelCollider.prefab"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "regex": "\\(String\\) [a-f0-9]{32}"
          }
        }
      ]
    }
    

    当前载具使用 TrackController 的轮式模式。旧教程在车体根节点使用 NPhysicCarController、Rigidbody、CenterOfMass 和 NPhysic,并给每个轮子挂 WheelController 和摩擦预设。迁移旧工程时可以根据这些名字认出旧配置。当前模式由 PTCParameter 选择,车轮和摩擦使用下述轮碰撞器模板。

    1. 准备车体和轮子节点

    1. 按载具基础配置准备车体。在显示模型根节点下建立 Wheels,下面放 FrontLeft、FrontRight、RearLeft、RearRight。从侧面和正面检查每个轮子原点在对应车轴中心,左右轮模型方向一致。构建后的 VehicleDynamics 和 Wheels 使用同一父节点,组装器会创建 VehicleDynamics。
    2. 根节点已有 Rigidbody 时,打包器会用它。否则会根据载具参数生成。用 VehicleData → 编辑移动橙色的 Center Of Gravity 节点,在 Scene 视图按 K 保存重心调整。

    图中展示最终完成后的移动配置。TankWheelCollider 提供轮胎碰撞器参数,isWheelVehicle 打开轮式模式。

    移动页签中的轮式模式和碰撞器模板,带编号高亮

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${model}",
            "mode": "create",
            "component": "UnityEngine.Rigidbody",
            "children": [
              "VehicleDynamics",
              "Wheels/FrontLeft",
              "Wheels/FrontRight",
              "Wheels/RearLeft",
              "Wheels/RearRight"
            ]
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/CopyAsset",
          "args": [
            "Packages/com.shanghaiwindy.coreresources/BuiltInVehicles/PatriotRadar/BuiltIn-Patriot-Radar_VehicleTextData.asset",
            "${vehicle}"
          ]
        },
        "expect": {
          "contains": "(Boolean) True"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${vehicle}/isStationary",
          "value": "false"
        },
        "expect": {
          "contains": "OK:"
        }
      }
    ]
    

    2. 按驱动和转向分组

    在 VehicleTextData 的「移动」页签展开 PTCParameter。把带 Unity WheelCollider 的模板 prefab 指给 TankWheelCollider。模板的半径、悬挂和摩擦参数会复制到运行时轮子。每组可用 steerData.wheelCollider 指定自己的模板,留空则沿用总模板。

    在 steerableWheels 中建两组。wheels 的路径从 VehicleDynamics 的父节点查找。

    分组 路径 isMotor isSteerable maxSteerAngle
    前轮 Wheels/FrontLeft、Wheels/FrontRight true true 28°
    后轮 Wheels/RearLeft、Wheels/RearRight true false 0°

    前轮路径、驱动、转向和最大转向角,带编号高亮

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/CopyAsset",
          "args": [
            "Packages/com.shanghaiwindy.coreresources/BuiltInVehicles/PatriotRadar/BuiltIn-Patriot-Radar_WheelCollider.prefab",
            "${collider}"
          ]
        },
        "expect": {
          "contains": "(Boolean) True"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${vehicle}/PTCParameter/TankWheelCollider",
          "value": "@asset:${collider}"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${vehicle}/PTCParameter/steerableWheels",
          "value": "[{\"wheels\": [\"Wheels/FrontLeft\", \"Wheels/FrontRight\"], \"steerData\": {\"isMotor\": true, \"isSteerable\": true, \"maxSteerAngle\": 28}}, {\"wheels\": [\"Wheels/RearLeft\", \"Wheels/RearRight\"], \"steerData\": {\"isMotor\": true, \"isSteerable\": false, \"maxSteerAngle\": 0}}]"
        },
        "expect": {
          "contains": "OK:"
        }
      }
    ]
    

    3. 启用轮式模式

    在相同的移动配置内勾选 isWheelVehicle。本例不使用履带数据,将 TrackData 留空。确认固定底座开关关闭,载具按普通地面载具进入 TrackController 分支。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${vehicle}/PTCParameter/isWheelVehicle",
          "value": "true"
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "inspect_set",
        "arguments": {
          "path": "asset:${vehicle}/PTCParameter/TrackData",
          "value": "null"
        },
        "expect": {
          "contains": "OK:"
        }
      }
    ]
    

    4. 保存并核对

    保存车体与配置并重打包。核对每个轮子的路径都指向一个车轴节点。用测试场在平地试车,观察轮胎是否接地、前轮是否随输入转向、后轮是否保持方向,再测试有坡度的地面。方向不对时先查模型轴向和分组,抓地力异常时查当前组实际引用的 WheelCollider 模板。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${vehicle}/GetGroundType()"
        },
        "expect": {
          "contains": "TrackController"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${vehicle}/GetEngineParam()/isWheelVehicle"
        },
        "expect": {
          "contains": "True"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${vehicle}/GetEngineParam()/TankWheelCollider/WheelCollider/radius"
        },
        "expect": {
          "contains": "(Single)"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${vehicle}/GetEngineParam()/steerableWheels/0/steerData/maxSteerAngle"
        },
        "expect": {
          "contains": "28"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/Wheels/FrontLeft/name"
        },
        "expect": {
          "contains": "FrontLeft"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/Wheels/FrontRight/name"
        },
        "expect": {
          "contains": "FrontRight"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/Wheels/RearLeft/name"
        },
        "expect": {
          "contains": "RearLeft"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/Wheels/RearRight/name"
        },
        "expect": {
          "contains": "RearRight"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document