Search Results for

    Show / Hide Table of Contents

    配置 Track IK 悬挂臂

    中文 | English

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

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

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

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

    TrackIK 让悬挂臂随负重轮的位移旋转。以下用同一模型 prefab 内的一根悬挂臂和一个负重轮演示。

    1. 准备模型层级

    把悬挂臂拆成独立节点,将转轴放在车体连接处。在 MainBody 下准备 SuspensionArm 和 RoadWheel。在同一模型 prefab 内新建空节点 StandardUCS,将它的上轴和右轴分别对齐到车体的上方和侧方。负重轮应位于悬挂臂转轴前方。本例将轮节点放在局部坐标 (0, -0.25, 1)。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${model}",
            "mode": "create",
            "component": "UnityEngine.Transform",
            "children": [
              "MainBody/SuspensionArm",
              "MainBody/RoadWheel",
              "StandardUCS"
            ]
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      },
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${model}",
            "mode": "update",
            "component": "UnityEngine.Transform",
            "child": "MainBody/RoadWheel",
            "values": {
              "m_LocalPosition": {
                "x": 0,
                "y": -0.25,
                "z": 1
              }
            }
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      }
    ]
    

    2. 配置 TrackIK

    在 SuspensionArm 上添加 TrackIK,将「目标负重轮」设为 RoadWheel,将「参考坐标系」设为 StandardUCS。本例将高度设为 0.1,翻转符号设为 1。

    保持「使用旋转包装节点」开启。运行时会在转轴处创建包装节点,用它的局部 Z+ 对准目标方向,同时保留网格相对于包装节点的初始摆放。关闭时脚本直接旋转悬挂臂,因此模型自身的 Z+ 要沿悬挂臂前向。

    对左右两侧的所有悬挂臂重复配置。以旧版 KV-2 示例为例,MainBody/TrackIK_011 指向左侧第六个负重轮 L6,参考坐标系使用模型根节点下的 StandardUCS。每根臂应按实际位置绑定对应轮子。旧图的 Height 为 0,本页教学值 0.1 用于演示高度偏移。

    悬挂臂的目标轮、参考坐标与包装节点选项

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${model}",
            "mode": "update",
            "component": "ShanghaiWindy.Core.TrackIK",
            "child": "MainBody/SuspensionArm",
            "values": {
              "isFlip": 1,
              "height": 0.1,
              "useTransformWrapper": true
            },
            "references": [
              {
                "property": "target",
                "child": "MainBody/RoadWheel",
                "component": "UnityEngine.Transform"
              },
              {
                "property": "standardUCS",
                "child": "StandardUCS",
                "component": "UnityEngine.Transform"
              }
            ]
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      }
    ]
    

    3. 保存并核对

    在碰撞预制体的 Prefab Mode 保存并退出,重新检查每根臂的两个 Transform 引用。Scene 视图选中悬挂臂时,可用它指向负重轮的连线核对绑定。修改后重新打包,开进测试场观察悬挂转向和高度偏移。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/MainBody/SuspensionArm/TrackIK/target/name"
        },
        "expect": {
          "contains": "RoadWheel"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/MainBody/SuspensionArm/TrackIK/standardUCS/name"
        },
        "expect": {
          "contains": "StandardUCS"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/MainBody/SuspensionArm/TrackIK/height"
        },
        "expect": {
          "contains": "0.1"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/MainBody/SuspensionArm/TrackIK/useTransformWrapper"
        },
        "expect": {
          "contains": "True"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${model}/MainBody/RoadWheel/transform/localPosition/z"
        },
        "expect": {
          "contains": "(Single) 1"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document