Search Results for

    Show / Hide Table of Contents

    引擎转速与起落架

    中文 | English

    在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。

    python Docs/Manual/manual/tools/tutorials.py run lua-api2-engine-gear
    
    点击展开 MCP 操作点击收起 MCP 操作

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

    {
      "variables": {
        "script": "${fixture}/EngineAndGear.lua",
        "prefab": "${fixture}/Tutorial_EngineAndGear.prefab"
      },
      "calls": [
        {
          "tool": "invoke",
          "arguments": {
            "path": "static:UnityEditor.AssetDatabase/CreateFolder",
            "args": [
              "${fixtureParent}",
              "${folder}"
            ]
          },
          "expect": {
            "contains": "(String)"
          }
        }
      ]
    }
    

    把脚本挂到载具,按需绑定 fan、smoke 或 gearLights。飞机先读取起落架初始状态,再用 FlightAPI.OnGearChanged 更新灯光。事件订阅传入 self.script,并关闭飞机分支的逐帧更新。

    地面分支从 TankAPI.GetEngineState 读取成功标记、转速、转速百分比、挡位、速度和倒车状态。转速百分比范围为 0 到 100,每分钟转数乘 6 得到每秒角度。速度单位为 km/h,履带车和轮式车倒车时为负值。履带车一挡为 1、倒挡为 0;没有变速箱的轮式车转速为 0、挡位为 1;船只返回转速和速度,挡位恒为 1、倒车状态恒为 false;固定载具转速和速度为 0、挡位为 1。示例额外按 0.1 缩放风扇转速,并在转速百分比超过 80 时显示烟雾。

    起落架状态和接地检测各有接口。FlightAPI.IsOnGround 会检查实际接触。起落架放下时,它还可能对每个轮子做一次重叠检测,轮子附近有地面或建筑也可能返回 true。需要频繁做视觉更新时,适当降低这个物理查询的调用频率。

    Behavior()
    Property = {
        fan = { type = "object", value = nil },
        smoke = { type = "object", value = nil },
        gearLights = { type = "object", value = nil },
    }
    
    local EngineAndGear = class("EngineAndGear")
    
    function EngineAndGear:OnVehicleReady(vehicle)
        self.vehicle = vehicle
        if VehicleAPI.IsFlightVehicle(vehicle) then
            if self.gearLights ~= nil then
                self.gearLights:SetActive(FlightAPI.IsGearDown(vehicle))
                FlightAPI.OnGearChanged(self.script, vehicle, function(isDown)
                    self.gearLights:SetActive(isDown)
                end)
            end
            self.vehicle = nil
            self.script:SetUpdateEnabled(false)
            return
        end
        self.script:SetUpdateEnabled(self.fan ~= nil or self.smoke ~= nil)
    end
    
    function EngineAndGear:OnUpdated(dt)
        if self.vehicle == nil then
            return
        end
        local ok, rpm, rpmPercent = TankAPI.GetEngineState(self.vehicle)
        if not ok then
            return
        end
        if self.fan ~= nil then
            self.fan.transform:Rotate(0, 0, rpm * 6 * dt * 0.1)
        end
        if self.smoke ~= nil then
            self.smoke:SetActive(rpmPercent > 80)
        end
    end
    
    return EngineAndGear
    
    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/Copy",
          "args": [
            "../../Docs/Manual/tutorials/lua-api2-engine-gear/example.lua",
            "${script}"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:UnityEditor.AssetDatabase/ImportAsset",
          "args": [
            "${script}",
            "ForceSynchronousImport"
          ]
        },
        "expect": {
          "contains": "OK:"
        }
      },
      {
        "tool": "prefab_edit",
        "arguments": {
          "json": {
            "path": "${prefab}",
            "mode": "create",
            "component": "ShanghaiWindy.Core.Lua.LuaBehaviorMono",
            "children": [
              "Fan",
              "Smoke",
              "GearLights"
            ],
            "references": [
              {
                "property": "luaBehavior",
                "asset": "${script}",
                "type": "ShanghaiWindy.Core.Lua.LuaBehaviorScript"
              },
              {
                "property": "instanceLuaProperty.objectProperties.Array.data[0].value",
                "child": "Fan",
                "component": "UnityEngine.GameObject"
              },
              {
                "property": "instanceLuaProperty.objectProperties.Array.data[1].value",
                "child": "Smoke",
                "component": "UnityEngine.GameObject"
              },
              {
                "property": "instanceLuaProperty.objectProperties.Array.data[2].value",
                "child": "GearLights",
                "component": "UnityEngine.GameObject"
              }
            ],
            "values": {
              "instanceLuaProperty": {
                "objectProperties": [
                  {
                    "variableName": "fan"
                  },
                  {
                    "variableName": "smoke"
                  },
                  {
                    "variableName": "gearLights"
                  }
                ]
              }
            }
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${prefab}/LuaBehaviorMono/luaBehavior/name"
        },
        "expect": {
          "contains": "(String) EngineAndGear"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${prefab}/LuaBehaviorMono/instanceLuaProperty/objectProperties/0/value/name"
        },
        "expect": {
          "contains": "(String) Fan"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${prefab}/LuaBehaviorMono/instanceLuaProperty/objectProperties/1/value/name"
        },
        "expect": {
          "contains": "(String) Smoke"
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${prefab}/LuaBehaviorMono/instanceLuaProperty/objectProperties/2/value/name"
        },
        "expect": {
          "contains": "(String) GearLights"
        }
      }
    ]
    

    回放用可控的转速和起落架状态检查脚本分支。在真实载具上检查风扇、烟雾和灯光。

    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:ShanghaiWindy.Core.AssetBundleManager/LuaEnv/DoString",
          "args": [
            "local E = setmetatable({ Behavior = function() end, class = function() return {} end, print = function() end }, { __index = _G })\nlocal gearCallback, angle, smoke, light\nlocal update\nE.VehicleAPI = { IsFlightVehicle = function(v) return v.aircraft end }\nE.FlightAPI = {\n    IsGearDown = function() return true end,\n    OnGearChanged = function(owner, vehicle, cb) gearCallback = cb end\n}\nE.TankAPI = { GetEngineState = function() return true, 360, 82, 1, 10, false end }\n\nlocal B = assert(loadfile('../../Docs/Manual/tutorials/lua-api2-engine-gear/example.lua', 't', E))()\nlocal function instance(t) return setmetatable(t, { __index = B }) end\nlocal script = { SetUpdateEnabled = function(_, value) update = value end }\nlocal lights = { SetActive = function(_, value) light = value end }\nlocal fan = { transform = { Rotate = function(_, x, y, z) angle = z end } }\nlocal exhaust = { SetActive = function(_, value) smoke = value end }\nlocal aircraft = instance({ gearLights = lights, script = script })\naircraft:OnVehicleReady({ aircraft = true })\nassert(light == true and update == false)\ngearCallback(false)\nassert(light == false)\naircraft:OnUpdated(1)\nassert(angle == nil)\nlocal tank = instance({ fan = fan, smoke = exhaust, script = script })\ntank:OnUpdated(1)\nassert(angle == nil)\ntank:OnVehicleReady({})\nassert(update == true)\ntank:OnUpdated(0.5)\nassert(math.abs(angle - 108) < 0.001 and smoke == true)\nlocal ok = CS.ShanghaiWindy.Core.API.TankAPI.GetEngineState(nil)\nassert(ok == false)\nreturn \"Lua example passed\"\n",
            "manual-lua-api2-engine-gear",
            "null"
          ]
        },
        "expect": {
          "contains": "Lua example passed"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document