简介这份资源是面向Unity3D开发者、尤其是流体特效初学者的Obi Fluid插件配套教程与可运行源码包帮助读者掌握基于粒子技术的流体模拟方法解决水、烟雾、火焰等特效在项目中的落地问题。压缩包共6个文件约11KB包含js脚本、json配置、html页面、md说明文档及inscode工程文件等分别承担逻辑控制、参数配置、文档说明与工程组织等用途结构轻量便于快速导入与调试。目前已有88人学习下载。内容围绕粒子产生与运动、物理属性、重力与粘度、表面张力等真实流体行为展开同时覆盖可视化编辑器调参、脚本API自定义控制、项目规划与开发调试、性能优化等实践环节并附拓展学习资源与社区交流指引。读者可据此从入门逐步过渡到精通获得一套可运行、可扩展的流体特效学习路线与代码参考。1. Obi Fluid 插件教程从零跑通可运行源码先搞懂它到底解决什么问题如果你做过 Unity 里的液体效果大概率经历过这样的场景用粒子系统硬凑水流结果穿模、抖动、性能爆炸用 Shader 做假液体静态看还行一旦有物体搅动就露馅。Obi Fluid 就是冲着这类需求来的——它是一套基于粒子物理的流体模拟插件能在 Unity 里实时算出液体的流动、飞溅、黏附和容器碰撞。标题里说的「可运行源码」指的是拿到插件后能直接跑起来的示例工程和核心脚本不是让你从零手写求解器。这篇文章面向两类人一是刚接触 Obi Fluid、想快速看到液体在场景里动起来的新手二是已经用过但被参数和性能坑过、想搞清楚底层逻辑的老手。我会按「先跑通、再调参、最后避坑」的顺序把可运行源码的获取、导入、场景搭建和关键参数一次讲透让你少走我当年踩过的弯路。2. Obi Fluid 可运行源码的获取与工程导入从下载到第一个液体场景2.1 源码包的结构与版本匹配Obi Fluid 的可运行源码通常以 Unity Package 或压缩包形式分发解压后你会看到几个核心目录Obi文件夹放的是运行时脚本和 ShaderSamples或Examples里是官方示例场景Editor目录负责 Inspector 扩展。很多人拿到源码第一件事就是双击导入结果报一堆编译错误根本原因是 Unity 版本和 Obi 版本没对上。Obi 对 Unity 版本比较敏感尤其是 2020 之前的版本和 2021 之后的 LTSAPI 差异会导致Solver相关脚本编译失败。我的习惯是先看源码包里的README或package.json确认它标注的 Unity 最低版本然后新建一个空工程不要往已有项目里直接塞避免和现有插件冲突。导入时还有一个细节Obi 依赖 Burst 和 Mathematics 包。如果你用的是 Unity 2021 以上Package Manager 里默认可能没装 Burst需要手动添加。导入后如果 Console 报Burst compilation failed八成是 Burst 版本太低升级到和 Obi 要求一致的版本即可。这一步不搞定后面所有示例场景都跑不起来。2.2 导入步骤与第一个可运行场景假设你已经拿到源码包下面是我常用的导入流程按顺序执行基本不会翻车# 1. 新建 Unity 工程版本选 Obi 源码标注的 LTS 版本 # 2. 关闭 Unity把 Obi 文件夹整体拷贝到 Assets 目录下 # 3. 重新打开 Unity等待编译完成 # 4. 打开 Package Manager安装 Burst 和 Mathematics # 5. 在 Project 窗口找到 Samples 下的 Fluid 示例场景双击打开代码块里没有写具体命令行因为 Unity 工程操作主要在编辑器里完成。关键点是第 2 步拷贝而不是导入 Package这样源码文件会以普通资源形式存在方便你直接改脚本调试。第 4 步的 Burst 和 Mathematics 是 Obi 的硬依赖缺一个都会导致 Solver 无法初始化。打开示例场景后你会看到一个装着液体的容器和几个碰撞体。点击 Play液体应该会受重力下落并在容器内晃动。如果液体直接穿底或者纹丝不动先检查场景里的Obi Solver组件是否正常挂载再看Obi Fluid Renderer的材质有没有丢。常见情况是 Shader 没编译成功液体渲染成粉色这时候去Obi/Resources下重新指定一下材质即可。2.3 核心组件与参数初调一个最小的 Obi Fluid 场景需要三个组件Obi Solver、Obi Emitter和Obi Fluid Renderer。Solver 是求解器负责所有粒子的物理计算Emitter 是发射器定义液体从哪来、发多少Renderer 负责把粒子渲染成液体表面。新手最容易忽略的是 Solver 的Substeps参数它决定每帧迭代几次值太低液体像果冻值太高性能直接崩。我一般从 3 开始试观察液体流动是否顺滑再决定加还是减。Emitter 里的Speed和Amount控制发射速度和粒子数量。Speed 太大液体会像水枪一样喷出去太小则流不出来。Amount 直接关联粒子总数Obi 的粒子是真实物理粒子数量一上去 CPU 和 GPU 都吃不消。建议先在 500 到 1000 之间调看到效果后再优化。Renderer 的Smoothness和Thickness影响视觉和物理无关可以最后调。3. Obi Fluid 参数调优粒子、碰撞与渲染的实战配置3.1 粒子分辨率与性能的平衡Obi Fluid 的液体由粒子组成粒子越多细节越丰富但计算量呈线性增长。Resolution参数在 Emitter 或 Fluid Blueprint 里设置它决定单位体积内的粒子数。我做过一个对比同样一个水杯场景Resolution 设为 0.5 时粒子数约 800帧率稳定 60设为 1.0 时粒子数飙到 3000 多帧率掉到 25 以下。所以第一步永远是确定你的目标平台PC 端可以适当高一点移动端必须压到 0.3 到 0.5。除了 ResolutionParticle Radius也影响观感和性能。半径越大粒子间斥力计算越容易但液体看起来越粗糙。半径太小粒子会互相穿透出现「漏液」现象。我的经验是让半径和 Resolution 联动Resolution 高时半径可以小Resolution 低时半径要相应加大保证粒子间有足够的接触面积。// 在 ObiEmitter 脚本中动态调整粒子参数 using UnityEngine; using Obi; public class FluidTuner : MonoBehaviour { public ObiEmitter emitter; public float targetResolution 0.6f; public float targetRadius 0.08f; void Start() { // 设置发射器的粒子分辨率 emitter.resolution targetResolution; // 设置粒子半径影响碰撞和渲染 emitter.particleRadius targetRadius; // 根据分辨率反推最大粒子数防止溢出 emitter.maxParticles Mathf.CeilToInt(1f / (targetResolution * targetResolution)); } }这段代码演示了如何在运行时调整 Emitter 的分辨率和半径。resolution越小粒子越密particleRadius要和分辨率匹配否则会出现粒子重叠或间隙过大。maxParticles是安全上限防止粒子无限增长撑爆内存。实际项目中我会把这个脚本挂在一个空物体上方便在 Inspector 里实时拖拽调试。3.2 碰撞体设置与容器交互Obi Fluid 和普通物理碰撞不一样它需要专门的Obi Collider组件而不是 Unity 自带的 BoxCollider。很多人把容器做成普通 Collider结果液体直接穿过去这就是没搞懂 Obi 的碰撞体系。正确做法是给容器物体添加Obi Collider并在 Solver 的Collision Materials里配置摩擦力和弹性。摩擦力太小液体会在容器里乱滑太大则像胶水一样粘住不动。另一个关键是碰撞体的厚度。Obi 的粒子有半径如果容器壁太薄粒子在高速运动时会穿透。我一般把容器壁的碰撞厚度设成粒子半径的 1.5 到 2 倍这样即使粒子速度较快也能被挡住。如果场景里有快速移动的物体搅动液体还要开启 Solver 的Continuous Collision Detection代价是性能会下降但能避免穿模。3.3 渲染材质与视觉优化Obi Fluid Renderer 负责把粒子渲染成连续的液体表面。它内部用的是屏幕空间流体渲染通过深度和厚度信息重建表面。Smoothness控制表面平滑程度值越高液体越像果冻值低则能看到粒子感。Thickness影响液体的浓稠观感和水、油、蜂蜜的视觉差异主要靠这个参数。材质方面Obi 自带几个 Shader比如ObiFluidShader和ObiFluidShaderTransparent。透明 Shader 适合水不透明适合黏稠液体。如果液体渲染出来是纯色块没有光泽检查一下 Shader 的Metallic和Smoothness是否被设成了默认值。我通常会把Metallic调到 0.1 左右Smoothness调到 0.8这样水看起来有反射感但不至于像金属。提示渲染参数不影响物理计算调参时可以先关掉 Renderer 只看粒子确认物理正确后再开渲染避免视觉干扰判断。4. Obi Fluid 避坑指南穿模、抖动、性能暴跌的排查清单4.1 液体穿模粒子直接穿过容器壁现象液体在容器里晃动时部分粒子从底部或侧面漏出去像容器破了个洞。原因最常见的是容器没有挂Obi Collider或者碰撞体厚度小于粒子半径。另一个原因是 Solver 的Substeps太低粒子在单帧内移动距离过大直接跳过了碰撞检测。解决先确认容器有Obi Collider且厚度足够然后把Substeps从 3 提到 5 或 6观察穿模是否减少如果还有开启Continuous Collision Detection。注意 Substeps 提高会显著增加 CPU 开销移动端要谨慎。4.2 液体抖动静止时粒子不停颤动现象液体已经稳定在容器底部但粒子还在轻微抖动看起来像在沸腾。原因粒子间的斥力参数Rest Density和Stiffness不匹配。Rest Density 是目标密度Stiffness 是抵抗压缩的强度。Stiffness 太高粒子会反复弹开太低则液体像散沙。解决把Stiffness降到 50 到 100 之间试同时确保Rest Density和粒子半径匹配。如果抖动依然明显检查 Solver 的Damping参数适当增加阻尼能让液体更快静止。4.3 性能暴跌帧率从 60 掉到 20现象场景里液体一多帧率断崖式下跌Profiler 里 Obi 的 CPU 占用飙升。原因粒子总数过多或者 Solver 的Substeps和Iterations设得太高。Obi 的物理计算是 CPU 密集型的粒子数超过 2000 后每增加 500 粒子帧率可能掉 10 帧以上。解决先降 Resolution把粒子数压到 1500 以内然后检查是否有多个 Solver 同时运行多个 Solver 会各自独立计算能合并就合并最后考虑开启 GPU 加速如果版本支持把部分计算转移到显卡。4.4 渲染异常液体显示为粉色或纯黑现象Play 之后液体是粉色方块或者完全看不见。原因Shader 编译失败或材质丢失。Unity 在 Shader 报错时会用粉色代替纯黑则可能是 Renderer 的材质被清空。解决去Obi/Resources目录下找到对应的 Shader 文件重新拖到 Renderer 的材质槽里。如果 Shader 本身报错检查 Unity 版本是否和 Obi 要求的渲染管线匹配Built-in 和 URP 用的 Shader 不一样拿错了就会编译失败。4.5 发射器不工作液体一直不出来现象场景里有 Emitter但 Play 之后一滴液体都没有。原因Emitter 的Speed为 0或者Amount设得太小或者发射方向反了。还有一种情况是 Emitter 没有绑定到 Solver粒子生成了但没被求解器接管。解决先看 Emitter 的Speed是不是 0调到 1 以上然后确认Amount大于 0再检查 Emitter 的Direction是否指向容器内部。最后看 Solver 的Emitters列表里有没有这个 Emitter没有就手动加进去。5. 进阶技巧用脚本控制 Obi Fluid 实现动态液面与交互5.1 动态调整发射速率模拟液面上升实际项目中经常需要液面随时间上升比如水池注水。与其手动改参数不如用脚本根据时间或外部事件动态调整 Emitter 的发射速率。下面这个脚本演示了如何用Mathf.Lerp平滑改变发射量避免液面突然跳变。using UnityEngine; using Obi; public class WaterLevelController : MonoBehaviour { public ObiEmitter emitter; public float fillDuration 5f; // 注满所需时间 private float elapsed 0f; private float initialSpeed; void Start() { // 记录初始速度作为插值起点 initialSpeed emitter.speed; // 初始时关闭发射等待注水开始 emitter.speed 0f; } void Update() { if (elapsed fillDuration) { elapsed Time.deltaTime; // 用平滑曲线控制发射速度避免线性增长带来的突变 float t Mathf.SmoothStep(0f, 1f, elapsed / fillDuration); emitter.speed Mathf.Lerp(0f, initialSpeed, t); } else { // 注满后停止发射让液体自然稳定 emitter.speed 0f; } } }这段代码的核心是Mathf.SmoothStep它让发射速度在开始和结束时变化平缓中间快模拟真实注水的手感。fillDuration控制总时长initialSpeed是发射器原本的速度值作为插值上限。实际使用时把这个脚本挂在 Emitter 上运行后液面会平滑上升不会出现粒子突然喷涌的情况。5.2 用碰撞事件触发液体飞溅Obi 提供了粒子碰撞回调可以检测液体和特定物体的接触用来触发音效或飞溅效果。下面是一个监听粒子碰撞并打印信息的示例。using UnityEngine; using Obi; public class SplashDetector : MonoBehaviour { public ObiSolver solver; public float splashThreshold 2f; // 速度阈值超过才认为是飞溅 void OnEnable() { // 订阅求解器的粒子碰撞事件 solver.OnCollision Solver_OnCollision; } void OnDisable() { solver.OnCollision - Solver_OnCollision; } private void Solver_OnCollision(ObiSolver solver, ObiSolver.ObiCollisionEventArgs e) { foreach (var contact in e.contacts) { // 获取接触点的相对速度 float impactSpeed contact.normalVelocity; if (impactSpeed splashThreshold) { // 这里可以触发音效或粒子特效 Debug.Log($飞溅发生冲击速度{impactSpeed}); } } } }OnCollision是 Obi Solver 提供的事件e.contacts里包含所有接触点信息。normalVelocity是沿法线方向的相对速度值越大冲击越猛。splashThreshold根据你的场景调水花小就设 1.5剧烈飞溅设 3 以上。这个机制可以用来做音效触发、特效生成甚至游戏逻辑里的「液体溅到敌人身上造成伤害」。5.3 参数速查表与调试习惯调了这么多参数我习惯把常用值整理成一张表方便快速定位。下面是我在 PC 端做水效果时的一组参考值移动端需要把粒子数和 Substeps 减半。参数推荐范围作用调高影响Resolution0.4 - 0.8粒子密度细节多性能降Particle Radius0.05 - 0.1粒子大小碰撞稳表面糙Substeps3 - 6每帧迭代次数稳定CPU 高Stiffness50 - 150抗压缩强度液体硬易抖Damping0.1 - 0.5速度阻尼静止快流动慢Smoothness0.6 - 0.9渲染平滑度果冻感强这张表不是万能公式但能帮你快速排除明显不合理的值。我自己的习惯是每次只改一个参数改完立刻 Play 看效果确认没问题再动下一个。同时开 Profiler 盯着 CPU 和 GCObi 的粒子计算会产生不少临时对象如果 GC 频繁触发就要考虑用对象池或者降低粒子数。最后说一个血泪教训Obi Fluid 的源码虽然可运行但不要一上来就改核心求解器脚本。我当年为了「优化」性能直接改了ObiSolver里的迭代逻辑结果液体行为完全失控花了整整两天才回滚。正确的做法是先在外层用脚本控制参数确认瓶颈在哪再决定要不要动底层。希望帮到你。本文还有配套的精品资源点击获取