Search Results for

    Show / Hide Table of Contents

    敌机接近告警

    中文 | English

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

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

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

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

    这段载具 Lua 行为在本地玩家附近发现敌机时显示一次日志,可附带 FMOD 告警音。先完成 Lua Hello World,以便知道在哪里导入并绑定脚本。

    1. 导入并填写参数

    1. 在 Unity 项目的资源目录创建 AirThreatWarning.lua,复制下方完整脚本。选中载具的 VehicleTextData,在杂项 → 载具 Lua 行为新增一项并绑定脚本,点击同步属性。通过预制体绑定时,可用 LuaBehaviorMono,将组件放在所属载具的层级内。
    2. 将 warnDistance 保持在 3000 m。把可用的 FMOD 事件 GUID 填到 soundGuid,第一轮可留空以便只查日志。
    3. 保存,重打包并试驾这辆车。脚本复用 OnVehicleReady 中建立的查询,每 0.5 秒检查一次。
    查询字段 本例取值与用途
    Kind VehicleKind.Flight,只收飞机。其它筛选包括 Any、Ground、Army。
    Relation VehicleRelation.Enemy,以调用 Run(vehicle) 的载具所属队伍为准。也可选择 Any 或 Friendly。
    MaxDistance warnDistance,单位为米。设为 0 时该属性不限制距离。
    MaxCount 1,配合距离排序仅保留最近的一架。未设置时查询默认容量为 32。
    SortByDistance true,将最近目标放在第一个。
    Behavior()
    Property = {
        warnDistance = { type = "number", value = 3000 },
        soundGuid = { type = "string", value = "" },
    }
    
    local AirThreatWarning = class("AirThreatWarning")
    
    function AirThreatWarning:OnVehicleReady(vehicle)
        self.vehicle = vehicle
        self.query = VehicleAPI.CreateQuery()
        self.query.Kind = VehicleKind.Flight
        self.query.Relation = VehicleRelation.Enemy
        self.query.MaxDistance = self.warnDistance
        self.query.MaxCount = 1
        self.query.SortByDistance = true
        self.warned = false
        self.script:SetUpdateInterval(0.5)
    end
    
    function AirThreatWarning:OnUpdated()
        if self.query == nil or not VehicleAPI.IsLocalPlayer(self.vehicle) then
            return
        end
        local count = self.query:Run(self.vehicle)
        if count == 0 then
            self.warned = false
            return
        end
        if self.warned then
            return
        end
        local nearest = self.query:Get(0)
        if nearest == nil then
            return
        end
        self.warned = true
        print(string.format("[AirWarning] %s at %.0f m",
            VehicleAPI.GetDisplayName(nearest), self.query:GetDistance(0)))
        if self.soundGuid ~= "" then
            SoundAPI.PlayOneShot(self.soundGuid, self.transform.position)
        end
    end
    
    return AirThreatWarning
    
    点击展开 MCP 操作点击收起 MCP 操作
    [
      {
        "tool": "invoke",
        "arguments": {
          "path": "static:System.IO.File/Copy",
          "args": [
            "../../Docs/Manual/tutorials/lua-api2-air-warning/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": [],
            "references": [
              {
                "property": "luaBehavior",
                "asset": "${script}",
                "type": "ShanghaiWindy.Core.Lua.LuaBehaviorScript"
              }
            ],
            "values": {
              "instanceLuaProperty": {
                "numberProperties": [
                  {
                    "variableName": "warnDistance",
                    "value": 3000
                  }
                ],
                "stringProperties": [
                  {
                    "variableName": "soundGuid",
                    "value": ""
                  }
                ]
              }
            }
          }
        },
        "expect": {
          "equals": {
            "ok": true
          }
        }
      },
      {
        "tool": "inspect",
        "arguments": {
          "path": "asset:${prefab}/LuaBehaviorMono/luaBehavior/name"
        },
        "expect": {
          "contains": "(String) AirThreatWarning"
        }
      }
    ]
    

    2. 确认触发与重新触发

    1. 在试车场用本地玩家驾驶载具,让一架可见敌机进入警戒距离。在日志查 [AirWarning],应显示最近目标的名称和当前距离。Lua 用 Get(0) 与 GetDistance(0) 访问这一条结果。
    2. 目标留在范围内时保持单次告警。目标离开或不可见、查询回到零条以后,应能再次触发。填了声音 GUID 时确认飞进范围会在载具位置播放声音。
    3. 检查本地玩家、敌友与可见性。联机查询会经过队伍可见性筛选,不保证隐藏目标出现。地图或模式脚本可用 RunAt(position, team) 以一个位置和队伍为参考。

    旧脚本曾定时遍历所有刚体再在 Lua 筛选飞机。这个例子复用已有查询,筛选及排序在游戏内部执行。MCP 回放模拟目标进入、停留和离开。实际声音与联机可见性在游戏中验证。

    点击展开 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 count, played, checks, localPlayer = 0, 0, 0, true\nlocal aircraft = {}\nlocal query = {\n    Run = function() checks = checks + 1; return count end,\n    Get = function(_, i) assert(i == 0); return aircraft end,\n    GetDistance = function(_, i) assert(i == 0); return 500 end,\n}\nE.VehicleKind = { Flight = 2 }\nE.VehicleRelation = { Enemy = 1 }\nE.VehicleAPI = {\n    CreateQuery = function() return query end,\n    IsLocalPlayer = function() return localPlayer end,\n    GetDisplayName = function(v) assert(v == aircraft); return \"Sample\" end,\n}\nE.SoundAPI = { PlayOneShot = function(guid, _) assert(guid == \"sample\"); played = played + 1 end }\n\nlocal B = assert(loadfile('../../Docs/Manual/tutorials/lua-api2-air-warning/example.lua', 't', E))()\nlocal function instance(t) return setmetatable(t, { __index = B }) end\nlocal script = { SetUpdateInterval = function(_, x) assert(x == 0.5) end }\nlocal sample = instance({ script = script, warnDistance = 3000, soundGuid = \"sample\", transform = {} })\nsample:OnUpdated()\nsample:OnVehicleReady({})\nassert(query.Kind == 2 and query.Relation == 1 and query.MaxCount == 1 and query.MaxDistance == 3000)\nsample:OnUpdated()\ncount = 1\nsample:OnUpdated()\nsample:OnUpdated()\nassert(played == 1)\ncount = 0\nsample:OnUpdated()\ncount = 1\nsample:OnUpdated()\nassert(played == 2)\nlocalPlayer = false\nsample:OnUpdated()\nassert(checks == 5)\nlocal api = CS.ShanghaiWindy.Core.API\nlocal real = api.VehicleAPI.CreateQuery()\nreal.Kind = api.VehicleKind.Flight\nreal.Relation = api.VehicleRelation.Enemy\nreal.MaxCount = 1\nassert(real.Run(real, nil) == 0 and real.Count == 0)\nreturn \"Lua example passed\"\n",
            "manual-lua-api2-air-warning",
            "null"
          ]
        },
        "expect": {
          "contains": "Lua example passed"
        }
      }
    ]
    
    In this article
    Back to top Panzer War Document