在模组里显示雷达目标
中文 | English
在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。
python Docs/Manual/manual/tools/tutorials.py run lua-api2-radar-screen
点击展开 MCP 操作点击收起 MCP 操作
准备教学样例。${变量} 由配方提供。
{
"variables": {
"script": "${fixture}/RadarScreen.lua",
"prefab": "${fixture}/Tutorial_RadarScreen.prefab",
"vehicleData": "${fixture}/Tutorial_RadarData.asset"
},
"calls": [
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CreateFolder",
"args": [
"${fixtureParent}",
"${folder}"
]
},
"expect": {
"contains": "(String)"
}
}
]
}
1. 配置地面雷达
选中载具的 VehicleTextData,在杂项 → 防空雷达展开 groundAARadarData,启用 hasRadar。回放示例采用 12,000 m 最大探测距离、360° 旋转搜索和 60°/s 转速。定向雷达可关掉旋转搜索,再调方位和俯仰半角。
| 字段 | 含义 |
|---|---|
maxDetectionRange |
最大探测距离,单位米 |
isFullRotation、fullRotationRate |
全向轮转搜索与转速,单位度/秒 |
searchAzimuthHalfAngle、searchElevationHalfAngle |
搜索区各自的半角,默认 45°/30°。 |
minElevationAngle、detectGroundTargets |
俯仰低于 2° 的回波默认按地杂波过滤。允许地面目标时绕过这一项过滤,距离和扫描范围仍然生效。 |
displayRanges |
屏幕可切换的量程,默认 2,500/5,000/10,000/20,000 m。 |
canUsePD、pdMinDetectableSpeed |
脉冲多普勒模式与速度门限,默认门限 30 m/s。 |
hasIFF |
开启时显示并区分友军回波。 |
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CopyAsset",
"args": [
"Packages/com.shanghaiwindy.coreresources/Editor/DocumentationSamples/vehicle-text-data/Tutorial_VehicleTextData.asset",
"${vehicleData}"
]
},
"expect": {
"contains": "(Boolean) True"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleData}/groundAARadarData/hasRadar",
"value": "true"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleData}/groundAARadarData/maxDetectionRange",
"value": "12000"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleData}/groundAARadarData/isFullRotation",
"value": "true"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "asset:${vehicleData}/groundAARadarData/fullRotationRate",
"value": "60"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${vehicleData}/groundAARadarData/hasRadar"
},
"expect": {
"contains": "(Boolean) True"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${vehicleData}/groundAARadarData/maxDetectionRange"
},
"expect": {
"contains": "(Single) 12000"
}
}
]
2. 绑定并更新列表
- 把下方脚本保存为
RadarScreen.lua,导入 SDK 工程。选中载具预制体的子节点,挂上 LuaBehaviorMono,把脚本拖进 Behavior,然后保存并重打包。LuaBehaviorMono 用法 OnVehicleReady取得雷达并订阅锁定变化。示例每 0.2 秒刷新文字。Unity 每帧可能多次调用OnGUI,所以绘制时直接用缓存。- 从
0到GetContactCount(radar) - 1读取最近扫描的回波。GetContact依次返回成功标记、目标、距离、方位、俯仰、高度、径向速度和友军标记。箔条的目标为nil,距离和高度以米计,径向速度以 m/s 计。方位与俯仰使用雷达参考系。北向朝上的屏幕用GetContactWorldAzimuth,外观天线可用GetScanAzimuth取得相对安装座的 −180° 至 180° 偏航。
Behavior()
Property = {}
local RadarScreen = class("RadarScreen")
local GUI = CS.UnityEngine.GUI
local Rect = CS.UnityEngine.Rect
function RadarScreen:OnVehicleReady(vehicle)
local ok, radar = RadarAPI.TryGetRadar(vehicle)
if not ok then
self.script:SetUpdateEnabled(false)
return
end
self.vehicle = vehicle
self.radar = radar
self.lines = {}
self.text = ""
RadarAPI.OnLockChanged(self.script, radar, function(locked, target)
if locked and target ~= nil then
print("[Radar] locked " .. VehicleAPI.GetDisplayName(target))
elseif not locked then
print("[Radar] lock lost")
end
end)
self.script:SetUpdateInterval(0.2)
end
function RadarScreen:OnUpdated()
self.visible = self.radar ~= nil
and VehicleAPI.IsLocalPlayer(self.vehicle)
and RadarAPI.IsActive(self.radar)
if not self.visible then
return
end
local written = 0
for index = 0, RadarAPI.GetContactCount(self.radar) - 1 do
local ok, target, distance, azimuth, elevation, altitude, radialSpeed, isFriendly =
RadarAPI.GetContact(self.radar, index)
if ok then
local name = target ~= nil and VehicleAPI.GetDisplayName(target) or "?"
local bearing = RadarAPI.GetContactWorldAzimuth(self.radar, index)
written = written + 1
self.lines[written] = string.format("%s %s %.1f km %03.0f° %.0f m",
isFriendly and "+" or "!", name, distance / 1000, bearing, altitude)
end
end
for index = written + 1, #self.lines do
self.lines[index] = nil
end
self.text = table.concat(self.lines, "\n")
end
function RadarScreen:OnGUI()
if self.visible then
GUI.Label(Rect(20, 120, 360, 300), self.text)
end
end
return RadarScreen
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "invoke",
"arguments": {
"path": "static:System.IO.File/Copy",
"args": [
"../../Docs/Manual/tutorials/lua-api2-radar-screen/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"
}
]
}
},
"expect": {
"equals": {
"ok": true
}
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${prefab}/LuaBehaviorMono/luaBehavior/name"
},
"expect": {
"contains": "(String) RadarScreen"
}
}
]
3. 在试车场检查探测和锁定
- 驾驶这辆车并开启雷达,让一架飞机进入实际搜索区,检查列表的方位、距离与高度。关掉雷达,列表应隐藏。远程玩家的载具副本不会在本机扫描。
TryLock、Unlock、CycleTarget、SwitchMode只对本地控制的载具操作。TryLock要求从雷达当前可见回波中选目标,仍要等待捕获时间。锁定或丢失后,示例应往 Console 写一条[Radar]日志。
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 radar, aircraft = {}, {}\nlocal count, text, updating, active = 2, nil, true, true\nE.CS = { UnityEngine = { GUI = { Label = function(_, value) text = value end },\n Rect = function(...) return { ... } end } }\nE.VehicleAPI = { IsLocalPlayer = function(v) return v.localPlayer end,\n GetDisplayName = function(_) return \"Example\" end }\nE.RadarAPI = {\n TryGetRadar = function(v) return v.hasRadar, v.hasRadar and radar or nil end,\n OnLockChanged = function(owner, r, cb) assert(owner and r == radar and cb) end,\n IsActive = function(_) return active end,\n GetContactCount = function(_) return count end,\n GetContact = function(r, i)\n assert(r == radar and i >= 0 and i <= 1)\n if i == 0 then return true, aircraft, 2500, 45, 2, 500, 40, true end\n return true, nil, 3100, 50, 2, 600, 35, false\n end,\n GetContactWorldAzimuth = function(_, i) return i == 0 and 270 or 280 end,\n}\n\nlocal B = assert(loadfile('../../Docs/Manual/tutorials/lua-api2-radar-screen/example.lua', 't', E))()\nlocal function instance(t) return setmetatable(t, { __index = B }) end\nlocal script = { SetUpdateEnabled = function(_, enabled) updating = enabled end,\n SetUpdateInterval = function(_, interval) assert(interval == 0.2) end }\nlocal unavailable = instance({ script = script })\nunavailable:OnVehicleReady({})\nunavailable:OnUpdated()\nassert(updating == false and not unavailable.visible)\nlocal sample = instance({ script = script })\nsample:OnVehicleReady({ hasRadar = true, localPlayer = true })\nsample:OnUpdated()\nsample:OnGUI()\nassert(string.find(text, \"Example 2.5 km 270\", 1, true))\nassert(string.find(text, \"? 3.1 km 280\", 1, true))\ncount = 1\nsample:OnUpdated()\nassert(not string.find(sample.text, \"?\", 1, true))\nactive = false\nsample:OnUpdated()\nassert(not sample.visible)\nlocal ok = CS.ShanghaiWindy.Core.API.RadarAPI.TryGetRadar(nil)\nassert(ok == false)\nreturn \"Lua example passed\"\n",
"manual-lua-api2-radar-screen",
"null"
]
},
"expect": {
"contains": "Lua example passed"
}
}
]