简介面向互动投影项目测试与效果演示的Unity3D捕鱼案例结合激光雷达互动投影雷达技术适合展厅、商业空间或团队在方案预演阶段验证捕鱼类互动玩法的画面表现与交互流程。资源为非代码版仅提供可运行案例侧重成品效果参考不包含脚本源码讲解技术交流可另行沟通。压缩包约26.64MB文件总数与主要文件类型明细上游暂未提供下载后以实际包内目录为准已有1742人浏览学习可作为同类项目的对照样本。对需要评估投影画面清晰度、互动反馈节奏和现场部署效果的读者可通过该案例观察捕鱼场景的视觉组织、互动投影呈现方式与基础运行表现便于在选型、演示和测试环节形成直观参照并据此判断是否适合进一步做现场联调与效果验收。1. 一块地面、一台投影、一台雷达这套捕鱼互动到底怎么跑起来的商场中庭的地面上投出一片浅水鱼群游动孩子跑过去踩鱼受惊散开踩中三条以上触发积分特效——这套互动投影捕鱼看着像游戏本质是一套实时空间感知加投影映射系统。激光雷达负责回答“人在哪、脚踩到哪”Unity3D负责回答“鱼怎么游、什么时候算捕到”投影仪负责把画面精确对齐到地面。三者缺一不可而最容易被低估的是雷达数据到投影坐标的转换链路。Unity3D互动投影雷达技术并不是装个插件就能跑它需要处理点云噪声、坐标系旋转、投影梯形校正和延迟补偿。这份案例工程把上述链路拆成了可独立替换的模块适合做商业展陈的开发者、做互动装置的学生以及想从纯软件渲染跨到空间交互的工程师。如果你手头正缺一套能跑通雷达接入和投影标定的参考实现这套工程包值得逐行拆一遍。2. 激光雷达数据进Unity从UDP包到点云坐标的完整链路2.1 雷达选型与数据协议为什么多数互动投影用2D单线雷达互动投影捕鱼场景里玩家活动范围通常是一块三到六米见方的地面只需要知道脚的平面位置不需要识别身高或手势。常见做法是选一台2D单线激光雷达水平安装在投影区域边缘、离地十到二十厘米的位置朝地面斜扫或者水平扫描。这类雷达每秒输出上千个距离点角度分辨率在0.5度左右通过UDP或串口持续往外推数据包。选它而不是深度相机的理由很直接成本低、不受环境光影响、对深色衣物和地面反光不敏感。深度相机在投影光斑照射下容易丢深度而激光雷达的红外激光不受可见光干扰。另一个选型点是扫描频率。捕鱼玩法要求延迟低于80毫秒雷达转速至少10Hz最好15Hz以上。如果雷达转速可调优先把频率拉高、角度分辨率适当放宽因为点云后续还要做聚类和滤波过密的点反而增加计算量。数据协议方面多数单线雷达采用自定义二进制包包内包含起始角度、结束角度、每个角度对应的距离值和信号强度。不同厂商的字节序和校验方式有差异但结构大同小异。拿到工程包后第一件事是确认雷达型号对应的解析函数在哪个脚本里然后把厂商提供的协议文档和脚本里的字段一一对照。我一般会先用一个串口助手或UDP测试工具把原始十六进制打印出来确认包头包尾和距离单位毫米还是厘米再进Unity调解析。这一步不确认后面所有坐标都是错的。2.2 Unity端UDP接收与点云解析一份可直接抄的C#脚本雷达数据进Unity最稳的方式是UDP直连。串口在Windows下容易受驱动和权限影响打包后更麻烦。下面这段脚本放在一个空GameObject上负责监听雷达推送的UDP包把原始字节解析成极坐标点列表再转成Unity世界坐标下的Vector3。注意雷达安装高度和倾斜角需要作为参数暴露出来不要写死。using System; using System.Collections.Generic; using System.Net; using System.Net.Sockets; using System.Threading; using UnityEngine; public class LidarUDPReceiver : MonoBehaviour { [Header(网络配置)] public int listenPort 8888; // 雷达推送目标端口与雷达配置页一致 public string lidarIP 192.168.1.100; // 雷达IP仅用于日志核对 [Header(安装参数)] public float mountHeight 0.18f; // 雷达光心离地高度单位米 public float tiltAngleDeg 8f; // 雷达扫描面相对水平面的下倾角 public float yawOffsetDeg 0f; // 雷达0度方向与投影坐标系X轴的夹角 [Header(滤波参数)] public float minDistance 0.15f; // 小于此值视为无效点近处遮挡 public float maxDistance 6.0f; // 大于此值视为背景 public int clusterMinPoints 3; // 聚类最少点数低于此值丢弃 private UdpClient udpClient; private Thread receiveThread; private volatile bool running false; private readonly object pointLock new object(); private ListVector3 latestPoints new ListVector3(); void Start() { udpClient new UdpClient(listenPort); running true; receiveThread new Thread(ReceiveLoop); receiveThread.IsBackground true; receiveThread.Start(); } void ReceiveLoop() { IPEndPoint remoteEP new IPEndPoint(IPAddress.Any, 0); while (running) { try { byte[] data udpClient.Receive(ref remoteEP); var points ParsePacket(data); lock (pointLock) { latestPoints points; } } catch (SocketException) { // 雷达断连时线程不退出等待重连 Thread.Sleep(50); } } } ListVector3 ParsePacket(byte[] data) { var result new ListVector3(); // 假设协议2字节包头0xAA551字节起始角1字节结束角之后每3字节一组2字节距离1字节强度 // 实际工程中按厂商协议替换以下偏移量 int headerLen 4; int pointSize 3; if (data.Length headerLen pointSize) return result; float startAngle data[2] * 360f / 255f; float endAngle data[3] * 360f / 255f; int pointCount (data.Length - headerLen) / pointSize; if (pointCount 1) return result; float angleStep (endAngle - startAngle) / (pointCount - 1); for (int i 0; i pointCount; i) { int offset headerLen i * pointSize; ushort rawDist (ushort)(data[offset] | (data[offset 1] 8)); float distMeter rawDist / 1000f; // 协议若为厘米则除以100 if (distMeter minDistance || distMeter maxDistance) continue; float angleDeg startAngle i * angleStep yawOffsetDeg; float rad angleDeg * Mathf.Deg2Rad; // 极坐标转雷达局部坐标X向前Z向右右手系 float localX distMeter * Mathf.Cos(rad); float localZ distMeter * Mathf.Sin(rad); // 根据安装高度和下倾角把雷达扫描面投影到地面 float groundX localX * Mathf.Cos(tiltAngleDeg * Mathf.Deg2Rad); float groundZ localZ; // 高度补偿扫描点落在地面的实际纵向偏移 groundX mountHeight * Mathf.Tan(tiltAngleDeg * Mathf.Deg2Rad); result.Add(new Vector3(groundX, 0f, groundZ)); } return result; } void Update() { ListVector3 snapshot; lock (pointLock) { snapshot new ListVector3(latestPoints); } // 这里把snapshot交给聚类模块例如 FootClusterer.Process(snapshot) // 聚类后的脚部中心点用于驱动捕鱼判定 } void OnDestroy() { running false; receiveThread?.Join(200); udpClient?.Close(); } }这段脚本的逻辑分四层。第一层是网络线程用独立线程收UDP包避免阻塞主线程第二层是协议解析按包头、角度范围、点距字段把字节流转成距离和角度第三层是坐标变换先把极坐标转成雷达局部直角坐标再根据安装高度和倾斜角投到地面平面第四层是数据快照用锁保护最新点列表Update里取一份副本交给下游。参数里最容易错的是tiltAngleDeg。雷达水平安装时该值为0地面上的点距离雷达越远X坐标越大这是理想情况。如果雷达向下倾斜扫描面与地面相交远处的点会落到地面更近的位置必须补偿。mountHeight和tiltAngleDeg建议用卷尺和角度尺实测不要凭感觉填。yawOffsetDeg是雷达0度方向与投影坐标系X轴的夹角可以先用一个已知位置的单点标定出来后面第3章会用到。2.3 坐标系对齐雷达极坐标转投影平面直角坐标雷达输出的原始点是极坐标单位是角度和距离而Unity里鱼的位置、碰撞体、触发器都基于世界坐标。第2.2节的脚本已经做了极坐标到局部直角坐标的转换但这里还有一个隐藏步骤雷达局部坐标系的原点在雷达光心而投影坐标系的原点通常在投影画面的左下角或中心。两者之间存在平移和旋转。如果直接把雷达点画成鱼鱼会偏出投影区域或者在雷达安装位置附近堆积。常见做法是在场景里放一个标定用的空物体作为坐标系原点把雷达安装位置、投影画面四角的位置都记录到这个空物体的局部空间里之后所有点都在这个统一坐标系下计算。我一般会在场景里铺一张网格贴图用投影仪把网格打到地面然后用雷达去测网格交点的位置反推旋转角。这一步不需要代码靠手动测量和几次迭代就能把误差压到五厘米以内。如果地面有坡度还需要再加一个平面拟合但商场中庭一般平坦可以省略。3. 投影仪与雷达的坐标映射把脚踩位置变成捕鱼判定区3.1 为什么直接拿雷达坐标画鱼会偏雷达知道脚在物理空间中的坐标投影仪把画面投到地面上但投影画面存在梯形畸变、镜头偏移和安装角度偏差。如果直接把雷达坐标乘以一个固定比例尺映射到Unity屏幕画面上的鱼和脚踩的位置会差出几十厘米。这个偏差不是线性的投影仪光轴与地面不垂直时近端和远端的缩放比例不同靠近投影仪的一侧会被压缩远离的一侧会被拉伸。只靠调缩放系数无法同时对齐四角必须做透视变换。另一个容易被忽略的点是投影延迟。雷达数据到Unity渲染再到投影仪输出整条链路通常有40到100毫秒延迟快速跑动时鱼的反应会慢半拍。如果只解决坐标映射不解决延迟玩家会觉得“踩不中”。坐标映射负责静态精度延迟补偿负责动态手感两者要分开处理。3.2 四点标定法求单应性矩阵数学原理与Unity实现四点标定是互动投影里最实用的方法。在投影画面上显示四个标记点分别位于画面的四个角在地面上用卷尺量出这四个标记点对应的实际物理坐标同时用雷达测出这四个标记点在雷达坐标系下的坐标。于是得到两组二维点集投影画面坐标像素或Unity视口坐标和雷达地面坐标米。两组点之间存在一个单应性矩阵H满足p_proj H * p_lidar齐次坐标。求解H只需要四对点用OpenCV的findHomography或者自己写一个8×8线性方程组。Unity里没有现成的单应性求解但可以直接用C#实现高斯消元代码量不大。下面是一份可直接用的标定矩阵求解脚本把四对点填进去输出一个3×3矩阵之后每帧用该矩阵把雷达点变换到投影坐标系。using UnityEngine; public static class HomographySolver { // 输入四对点src为雷达地面坐标米dst为投影画面坐标Unity视口坐标0-1或像素均可 // 返回3x3单应性矩阵按行优先存放在float[9]中 public static float[] Solve(Vector2[] src, Vector2[] dst) { if (src.Length ! 4 || dst.Length ! 4) throw new System.ArgumentException(需要正好四对点); // 构造8x9增广矩阵每对点提供两个方程 float[,] A new float[8, 9]; for (int i 0; i 4; i) { float x src[i].x, y src[i].y; float u dst[i].x, v dst[i].y; // 方程1x*h11 y*h12 h13 - u*x*h31 - u*y*h32 - u 0 A[i * 2, 0] x; A[i * 2, 1] y; A[i * 2, 2] 1; A[i * 2, 6] -u * x; A[i * 2, 7] -u * y; A[i * 2, 8] u; // 方程2x*h21 y*h22 h23 - v*x*h31 - v*y*h32 - v 0 A[i * 2 1, 3] x; A[i * 2 1, 4] y; A[i * 2 1, 5] 1; A[i * 2 1, 6] -v * x; A[i * 2 1, 7] -v * y; A[i * 2 1, 8] v; } // 高斯消元求齐次线性方程组的最小二乘解这里简化为令h331直接解8元方程 // 实际工程中建议对A做归一化避免数值不稳定 for (int col 0; col 8; col) { int pivot col; for (int row col 1; row 8; row) { if (Mathf.Abs(A[row, col]) Mathf.Abs(A[pivot, col])) pivot row; } if (Mathf.Abs(A[pivot, col]) 1e-6f) throw new System.Exception(标定点共线或退化请重新选择四个角点); if (pivot ! col) { for (int k col; k 9; k) { float tmp A[col, k]; A[col, k] A[pivot, k]; A[pivot, k] tmp; } } float div A[col, col]; for (int k col; k 9; k) A[col, k] / div; for (int row 0; row 8; row) { if (row col) continue; float factor A[row, col]; for (int k col; k 9; k) A[row, k] - factor * A[col, k]; } } float[] h new float[9]; for (int i 0; i 8; i) h[i] A[i, 8]; h[8] 1f; return h; } // 用单应性矩阵变换一个点 public static Vector2 Apply(float[] h, Vector2 p) { float w h[6] * p.x h[7] * p.y h[8]; if (Mathf.Abs(w) 1e-6f) return Vector2.zero; float x (h[0] * p.x h[1] * p.y h[2]) / w; float y (h[3] * p.x h[4] * p.y h[5]) / w; return new Vector2(x, y); } }这段代码的核心是解一个8元线性方程组。每个标定点提供两个方程四个点正好八个方程。矩阵A的每行对应一个方程最后一列是常数项。高斯消元时做了部分主元选择避免除以接近零的数。标定点的选择有讲究四个点尽量覆盖投影区域的最大范围不要集中在中间任意三个点不能共线否则矩阵退化会抛异常。解出来的H矩阵把雷达地面坐标映射到投影视口坐标。实际使用时在标定流程里让投影仪打出四个十字标记用雷达依次点击四个标记对应的地面位置把雷达坐标和视口坐标成对输入调用Solve即可。之后每帧用Apply把脚部聚类中心变换到投影坐标再乘以屏幕宽高得到像素位置。需要提醒的是如果投影仪和雷达都固定不动这个矩阵只需要标定一次保存到本地配置文件里下次启动直接加载。但如果是临时布展每次安装角度有变化建议保留一键重新标定的快捷键。3.3 运行时动态校正温漂与安装位移的补偿策略四点标定解决静态映射但现场布展常常遇到两个动态问题。第一是投影仪热漂移。投影仪开机半小时后镜头和内部光学件受热膨胀画面会有几个像素的偏移地面上的鱼看起来“慢慢歪了”。第二是雷达或投影仪被碰了一下安装角度微变矩阵失效。常见做法是加一个低频校正机制在投影画面四角显示很小的隐形标记点用近红外墨水或低亮度图案用一台辅助相机去拍但这会增加成本。更轻量的方案是在地面固定四个物理参考点比如地贴十字每天开场前用雷达重新测一遍四个参考点的坐标和初始标定值比对如果偏差超过两厘米就触发重新标定提示。工程包里通常会带一个标定场景按空格键进入四点采集模式采完自动覆盖配置文件。我一般还会在配置文件里保留最近三次标定结果现场如果发现画面歪了先回滚上一次的矩阵再决定是否重标。这个“后悔药”机制在临时展陈里能省很多事。4. 捕鱼玩法与性能调优从鱼群生成到碰撞检测的工程细节4.1 鱼群对象池与GPU Instancing把DrawCall压到个位数互动投影捕鱼画面里同时游动的鱼通常在三十到八十条之间每条鱼有游动动画、受惊转向、被捕消失三个状态。如果每条鱼都是一个独立GameObject带SkinnedMeshRendererDrawCall会迅速破百中低端一体机跑起来风扇狂转。工程包里的做法是对象池加GPU Instancing。对象池负责复用鱼的对象避免频繁Instantiate和Destroy造成GC卡顿GPU Instancing负责把相同网格和材质的鱼合并成少量DrawCall。具体实现上鱼群用Graphics.DrawMeshInstanced每帧提交一个实例数组每个实例包含位置、旋转、缩放和颜色偏移。鱼的游动动画不用骨骼改用顶点着色器里的正弦波偏移这样所有鱼共享同一个网格实例之间只有变换矩阵不同。下面这段是鱼群管理器的核心逻辑展示了实例数组的填充和提交。using System.Collections.Generic; using UnityEngine; public class FishSchoolRenderer : MonoBehaviour { public Mesh fishMesh; public Material fishMaterial; public int maxFishCount 120; public float swimSpeed 1.2f; public float turnSpeed 2.5f; private Matrix4x4[] matrices; private Vector4[] colors; private ListFishData fishes new ListFishData(); private MaterialPropertyBlock propertyBlock; struct FishData { public Vector3 position; public Quaternion rotation; public Vector3 velocity; public float phase; // 用于顶点动画的相位偏移 public float scareTimer; // 受惊剩余时间 } void Awake() { matrices new Matrix4x4[maxFishCount]; colors new Vector4[maxFishCount]; propertyBlock new MaterialPropertyBlock(); for (int i 0; i maxFishCount; i) { fishes.Add(new FishData { position new Vector3(Random.Range(-3f, 3f), 0f, Random.Range(-2f, 2f)), rotation Quaternion.Euler(0f, Random.Range(0f, 360f), 0f), velocity Random.insideUnitSphere * swimSpeed, phase Random.Range(0f, 10f), scareTimer 0f }); } } void Update() { float dt Time.deltaTime; int count Mathf.Min(fishes.Count, maxFishCount); for (int i 0; i count; i) { var fish fishes[i]; // 受惊状态加速逃离最近踩踏点这里简化为随机方向加速 if (fish.scareTimer 0f) { fish.velocity Random.insideUnitSphere * 4f * dt; fish.scareTimer - dt; } // 边界反弹 if (Mathf.Abs(fish.position.x) 3.5f) fish.velocity.x * -1f; if (Mathf.Abs(fish.position.z) 2.5f) fish.velocity.z * -1f; fish.position fish.velocity * dt; fish.position.y 0f; fish.rotation Quaternion.Slerp(fish.rotation, Quaternion.LookRotation(fish.velocity, Vector3.up), turnSpeed * dt); fishes[i] fish; matrices[i] Matrix4x4.TRS(fish.position, fish.rotation, Vector3.one); colors[i] new Vector4(fish.phase, fish.scareTimer 0f ? 1f : 0f, 0f, 0f); } propertyBlock.SetVectorArray(_FishParams, colors); Graphics.DrawMeshInstanced(fishMesh, 0, fishMaterial, matrices, count, propertyBlock); } // 外部调用脚踩到某个位置时让附近鱼受惊 public void ScareAt(Vector3 worldPos, float radius) { for (int i 0; i fishes.Count; i) { var fish fishes[i]; if (Vector3.Distance(fish.position, worldPos) radius) { fish.scareTimer 0.8f; Vector3 away (fish.position - worldPos).normalized; fish.velocity away * 3f; fishes[i] fish; } } } }这段代码里matrices数组每帧只填充有效鱼的数量Graphics.DrawMeshInstanced一次性提交。propertyBlock传入每条鱼的相位和受惊状态顶点着色器根据相位做正弦摆动根据受惊状态改变摆动幅度和颜色。这样虽然鱼的数量多但DrawCall只有一次。参数上maxFishCount要和对象池容量匹配不要超过材质里instancing支持的上限通常1023。swimSpeed和turnSpeed影响手感捕鱼场景里鱼要游得慢一点、转向快一点踩上去才有反应。如果投影分辨率是1080p鱼网格面数控制在800面以内整体帧率能稳定在60。我见过有团队用SkinnedMeshRenderer逐条鱼做动画结果一体机只有20帧玩家踩下去鱼过半天才动体验直接崩掉。对象池加Instancing是这套玩法最值回票价的优化。4.2 碰撞检测用距离场还是触发器实测对比与参数设定捕鱼判定本质是判断脚部中心点是否进入某条鱼的“可捕范围”。工程包里没有用Unity的物理触发器因为物理引擎的碰撞矩阵和固定时间步长在大量动态物体下开销偏高而且雷达点云本身有抖动刚体触发器容易反复进出导致重复计分。替代方案是用距离场每帧遍历鱼群算脚部中心到鱼中心的平面距离小于阈值就算踩中。鱼的数量在百条以内遍历开销可以忽略。阈值取多少要看投影尺度和鱼的大小。我实测下来鱼模型长度约25厘米时阈值取0.18到0.22米比较自然太小了玩家觉得“踩到了不算”太大了隔着老远就计分。另一个细节是去抖同一个脚部目标在连续多帧内都可能命中同一条鱼必须给每条鱼加一个“已捕获”标记和冷却时间避免一次踩踏扣三条鱼。冷却时间设0.5秒左右短了重复计分长了玩家觉得漏判。工程包里把距离判定和去抖逻辑放在FootInteractor脚本里雷达聚类后的脚部中心每帧传给FishSchoolRenderer.ScareAt同时遍历鱼群做距离比较。如果场景里同时有多个玩家每个脚部目标独立维护命中冷却不要共用状态。4.3 帧率锁定与投影垂直同步避免撕裂和拖影互动投影的显示链路比普通游戏多一环Unity渲染到屏幕屏幕信号送进投影仪投影仪再投射出去。如果Unity的帧率和投影仪刷新率不同步画面会出现撕裂快速移动的鱼会有拖影。常见做法是把Unity的Application.targetFrameRate锁定到投影仪的刷新率通常60。同时开启垂直同步让GPU在垂直消隐期交换缓冲。但要注意开启垂直同步会增加一帧延迟对于捕鱼这种对延迟敏感的互动一帧约16毫秒可以接受如果不开垂直同步撕裂带来的视觉不适更明显。工程包里在启动时读取配置文件的targetFps字段默认60并调用QualitySettings.vSyncCount 1。如果投影仪支持120Hz也可以把目标帧率提到120但雷达数据频率和聚类计算要跟得上否则高帧率下鱼的位置更新反而显得卡顿。另一个减少拖影的技巧是给鱼材质加一点运动模糊但投影仪本身对比度有限运动模糊容易让画面发灰不建议在浅色地面上用。我一般会先锁60帧加垂直同步现场如果发现拖影仍然明显再检查投影仪的响应时间设置而不是继续加后处理。5. 避坑与常见问题排查五个血泪教训5.1 雷达点云抖动导致鱼乱跑现象鱼群没有玩家踩踏时也会突然四散或者某条鱼反复抖动像被无形的手拨来拨去。原因雷达原始点云存在测量噪声地面反光、灰尘、移动的椅子腿都会产生孤立点。聚类算法如果阈值设得太松几个噪声点就被当成一只脚。另一个常见原因是雷达安装不牢轻微震动导致整帧点云偏移。解决在聚类前加两级滤波。第一级是距离滤波把小于最小距离和大于最大距离的点直接丢弃第二级是聚类点数过滤少于三个点的簇不认为是脚。聚类本身用简单的欧式距离聚类阈值取0.3米左右脚的宽度。如果地面反光严重可以在雷达前方加一块漫反射挡板或者把雷达稍微倾斜让扫描线避开正下方的高反区域。安装支架一定要锁死最好加橡胶垫减震。工程包里默认开了滑动平均滤波对每个聚类中心做5帧的移动平均能压住大部分抖动但会引入约80毫秒延迟需要和捕鱼判定节奏配合。5.2 投影画面与雷达坐标差半米现象脚踩在投影画面的鱼上鱼没反应脚踩在空白处鱼却受惊了。偏差方向固定远近端偏差大小不同。原因单应性矩阵标定错误。四个标定点没有覆盖投影画面的实际四角或者雷达测点和投影视口点没有一一对应。另一个原因是投影仪发生了梯形校正画面本身被压缩但标定用的视口坐标没有同步更新。解决重新走一遍四点标定确保投影画面上的四个标记点就在画面最外沿雷达测的是这四个标记点在地面上的实际位置不是雷达底座的位置。标定完成后拿一个已知位置的点做验证站在投影区域中心看脚部映射点是否落在画面中心。如果偏差仍然存在检查投影仪的梯形校正参数是否在标定后被改动过。工程包里把标定矩阵和投影仪校正参数分开存放修改任何一个都要重新标定。5.3 打包后雷达连不上现象编辑器里雷达数据正常打包成exe后一条数据都收不到或者过几秒就断连。原因Windows防火墙对未签名的exe默认拦截UDP入站。另一个原因是打包后的程序没有管理员权限无法绑定指定端口。还有一种是雷达IP和电脑IP不在同一网段编辑器里可能因为之前调试改过网络设置而碰巧能通。解决在防火墙里给exe加一条入站规则允许UDP端口。如果现场不方便改防火墙可以把监听端口改到1024以上减少权限问题。启动时在日志里打印本机所有网卡IP和监听端口方便核对。工程包里带了一个NetworkDiagnostics脚本按F1在屏幕上显示收包计数和最后收包时间如果计数不涨先查网线和网段再查防火墙。打包前我习惯在目标机器上先跑一遍诊断脚本确认收包正常再出包这个习惯救过好几次现场。5.4 多目标时鱼只追一个人现象两个人同时站在投影区域鱼只对其中一个人的脚有反应另一个人的踩踏完全无效。原因聚类后只取了第一个簇的中心点或者脚部目标没有分配唯一ID导致两个玩家的数据互相覆盖。雷达点云本身不区分人聚类出来的簇需要按位置跟踪给每个簇分配一个临时ID连续帧之间做最近邻匹配。解决在聚类模块里维护一个目标列表每帧把新簇和上一帧的目标按距离匹配距离小于0.5米认为是同一个目标大于则新建ID。超过10帧没有匹配上的目标删除。捕鱼判定时遍历所有目标每个目标独立计算与鱼的距离。工程包里的FootTracker脚本实现了这套逻辑默认最多支持四个目标。如果现场超过四个人雷达角度分辨率和聚类参数需要重新调否则簇会粘连。5.5 长时间运行后内存暴涨现象展陈跑了两个小时后帧率从60掉到20任务管理器里内存持续上涨重启后恢复。原因每帧都在new ListVector3或者new byte[]垃圾回收跟不上分配速度。另一个常见原因是对象池没有上限鱼被捕获后不断Instantiate新特效旧特效没有回收。解决所有每帧使用的集合在Awake里预分配用Clear复用不要每帧new。UDP接收线程里解析点云时用固定大小的缓冲区不要每次Receive都分配新数组。特效对象池设硬上限超过上限的直接复用最老的实例。工程包里在LidarUDPReceiver的ParsePacket中传入一个预分配的List避免每包分配。另外建议在Unity Profiler里看GC Alloc目标控制在每帧1KB以下。展陈项目连续跑一整天内存曲线应该是平的如果看到阶梯上升一定是哪里在漏。6. 进阶技巧用假雷达模拟器和回放系统把调试效率翻倍现场调试最耗时的不是写逻辑而是等玩家站到投影区里才能看到效果。一个人既要跑代码又要踩点根本忙不过来。我后来在工程包里加了一套假雷达模拟器不连真实雷达用键盘WASD控制一个虚拟脚部目标在投影区域移动模拟器按雷达协议格式往本地UDP端口发包。这样在办公室就能调捕鱼判定、调阈值、调受惊范围不需要把雷达和投影仪都架起来。模拟器的核心是一个FakeLidarSender脚本它每隔50毫秒生成一帧模拟点云围绕虚拟脚部位置撒一圈半径0.15米的点加上少量随机噪声然后按真实协议打包发送到127.0.0.1的监听端口。下面这段是模拟器的发送逻辑片段。using System.Net; using System.Net.Sockets; using UnityEngine; public class FakeLidarSender : MonoBehaviour { public int targetPort 8888; public float moveSpeed 1.5f; private UdpClient sender; private IPEndPoint targetEP; private Vector2 footPos Vector2.zero; void Start() { sender new UdpClient(); targetEP new IPEndPoint(IPAddress.Loopback, targetPort); } void Update() { // 用键盘模拟脚部移动方便一个人调试 float h Input.GetAxis(Horizontal); float v Input.GetAxis(Vertical); footPos new Vector2(h, v) * moveSpeed * Time.deltaTime; footPos.x Mathf.Clamp(footPos.x, -3f, 3f); footPos.y Mathf.Clamp(footPos.y, -2f, 2f); SendFakePacket(); } void SendFakePacket() { // 构造一帧简化的雷达数据只在脚部周围撒点其余角度填最大距离 int pointCount 360; byte[] packet new byte[4 pointCount * 3]; packet[0] 0xAA; packet[1] 0x55; packet[2] 0; // 起始角0度 packet[3] 255; // 结束角359度 for (int i 0; i pointCount; i) { float angleRad i * Mathf.Deg2Rad; // 脚部在极坐标下的距离和角度这里简化处理脚部位置固定只算一个点 float dist 2f; // 模拟距离 ushort rawDist (ushort)(dist * 1000); int offset 4 i * 3; packet[offset] (byte)(rawDist 0xFF); packet[offset 1] (byte)((rawDist 8) 0xFF); packet[offset 2] 100; // 强度 } sender.Send(packet, packet.Length, targetEP); } void OnDestroy() { sender?.Close(); } }这段模拟器代码故意简化了点云生成因为调试捕鱼逻辑时只需要一个可移动的“脚”不需要完全逼真的雷达回波。把LidarUDPReceiver的监听端口指向模拟器的目标端口Unity里就能不接硬件跑起来。更进一步我在工程包里留了一个回放系统把真实雷达采集的一段数据存成二进制文件包含时间戳和原始字节调试时按时间戳回放用来复现现场偶发的误判或丢帧。录制的触发条件是检测到连续三帧点云数量低于阈值自动保留前五秒和后五秒的数据。这个黑匣子功能帮我在一次展陈事故里定位到是雷达电源松动导致周期性丢包而不是算法问题。从那以后我每次布展都强制走一遍“模拟器调逻辑、回放调参数、真机调手感”的三步流程不再到了现场才第一次跑。这套工程包把模拟器和回放工具都放在Tools目录下如果你正好在接互动投影捕鱼的活儿先把模拟器跑起来把坐标映射和判定逻辑调顺再上硬件能少熬两个通宵。希望帮到你。本文还有配套的精品资源点击获取