简介这份资源是面向Unity3D开发者、尤其是流体特效初学者的Obi Fluid插件配套教程与可运行源码包帮助读者掌握基于粒子技术的流体模拟方法解决水、烟雾、火焰等特效在项目中的落地问题。压缩包共6个文件约11KB包含js脚本、json配置、html页面、md说明文档及inscode工程文件等分别用于核心逻辑演示、参数配置、页面展示与项目说明结构轻量便于快速导入Unity工程对照调试。目前已有88人学习下载。内容围绕粒子系统的产生、运动与物理属性展开涵盖重力、粘度、表面张力等真实流体反应并涉及可视化编辑器调参、脚本API自定义控制、项目规划与开发调试、性能优化等实践环节同时提供拓展学习资源与社区交流方向适合从入门到进阶的开发者系统学习流体特效开发。1. 从一次流体模拟翻车说起这套 Obi Fluid 源码到底能干什么去年帮一个做独立游戏的朋友调一个液体关卡他想要那种倒进杯子里会晃、倒出来会拉丝的效果。他一开始用粒子系统硬拼结果帧率掉到 12 帧液体还像一堆沙子。后来换到 Obi Fluid第一次跑起来确实惊艳但紧接着就翻车了——参数乱调液体直接穿模漏了一地。那段时间我把这套插件的源码翻了个遍才搞明白它到底是怎么算的。今天要聊的这份 Obi Fluid 插件教程加可运行源码就是把我踩过的那些坑整理成了一条能直接跑通的路。它适合两类人一是刚接触 Unity 流体模拟、想找个能跑起来的工程照着改的新手二是用过 Obi 但被参数和性能问题卡住、想看看底层实现的老手。源码包里包含完整的 C# 脚本、Shader 和示例场景不是那种只给几个截图和 API 列表的空壳教程。下面我从工程结构开始拆一直讲到怎么调参不翻车。2. 拆开源码包Obi Fluid 的粒子-约束求解结构长什么样2.1 先看目录哪些文件是核心哪些只是演示拿到源码包别急着双击场景先花五分钟把目录过一遍。Obi Fluid 的工程结构大致分四层Obi核心运行时、Obi/Scripts下的求解器与约束、Obi/Shaders里的渲染管线、以及Samples示例场景。核心运行时里最该关注的是ObiSolver.cs、ObiEmitter.cs、ObiParticleRenderer.cs这三个。ObiSolver是每帧驱动整个粒子系统的主循环ObiEmitter负责从发射器网格生成粒子ObiParticleRenderer决定粒子怎么画出来。示例场景里通常有FluidViscosity、FluidEmitters、FluidCollision几个对应不同参数组合。我一般会先打开FluidViscosity场景因为它把粘度参数暴露得最全方便对照观察。提示源码包里如果带.asmdef文件说明作者做了程序集拆分导入时注意别把 Editor 目录和 Runtime 目录混在一起否则打包会报错。2.2 粒子-约束模型为什么它比纯粒子系统稳Obi Fluid 的核心不是简单的粒子堆叠而是基于位置约束的求解器Position Based DynamicsPBD。每个粒子有位置、速度、半径、相位phase几个属性求解器每帧做三件事先根据重力积分预测位置再遍历所有约束把粒子拉回合理范围最后更新速度。约束分几类密度约束保证液体不被压缩粘度约束让相邻粒子速度趋同碰撞约束处理与刚体和地形的交互。这种做法的好处是稳定性高参数调过头也不容易炸代价是每帧要迭代多次约束性能开销集中在ObiSolver的substeps和iterations上。// ObiSolver.cs 里每帧的核心循环简化示意 void Update() { // 1. 积分根据速度和重力预测新位置 for (int i 0; i particles.Count; i) { particles[i].velocity gravity * deltaTime; particles[i].position particles[i].velocity * deltaTime; } // 2. 约束迭代substeps 控制子步数iterations 控制每步迭代次数 for (int s 0; s substeps; s) { for (int it 0; it iterations; it) { ApplyDensityConstraints(); ApplyViscosityConstraints(); ApplyCollisionConstraints(); } } // 3. 速度更新用位置差反推速度避免能量爆炸 for (int i 0; i particles.Count; i) { particles[i].velocity (particles[i].position - particles[i].prevPosition) / deltaTime; } }这段逻辑说明为什么 Obi 的液体不容易“炸”速度不是直接累加的而是每帧从位置变化反推约束迭代会把异常位置拉回来。参数上substeps默认 1调高会让模拟更准但更吃 CPUiterations默认 3粘度高的液体可以加到 5 到 8。我一般先不动这两个等看到液体抖动或穿模再往上加。2.3 发射器与相位粒子怎么生成、怎么分组ObiEmitter负责把网格顶点转成粒子。它有一个resolution参数决定采样密度值越大粒子越多、液体越细腻但性能下降很快。另一个关键概念是phase每个粒子属于一个相位相位相同的粒子才会互相产生密度和粘度约束。这意味着你可以用相位把不同液体隔开比如水和油互不干扰。示例场景里通常用ObiPhase资产来配置改相位值就能控制哪些粒子抱团。// ObiEmitter.cs 里粒子生成的简化流程 void EmitParticles() { // 按 resolution 对发射器网格做体素化采样 var samples Voxelize(mesh, resolution); foreach (var sample in samples) { var particle new ObiParticle(); particle.position sample.position; particle.phase emitterPhase; // 相位决定约束分组 particle.radius particleRadius; solver.AddParticle(particle); } }参数上resolution从 0.5 开始试0.3 以下粒子数会翻倍移动端慎用。particleRadius要和渲染半径匹配否则会出现视觉上液体很粗但物理上粒子很细的错位。相位配置在ObiPhase资产里新建一个相位就多一组独立约束适合做分层液体。3. 跑通第一个场景从导入到出效果的完整操作链3.1 导入与版本对齐Unity 版本和渲染管线别选错源码包导入前先确认 Unity 版本。Obi Fluid 对版本比较敏感常见做法是看package.json或Obi/Editor里的版本标记选一个接近的 LTS 版本。渲染管线方面内置管线最省事URP 需要额外配置 Shader 变体HDRP 支持有限。我一般先用内置管线跑通确认逻辑没问题再切 URP。导入时如果报Obi命名空间找不到多半是程序集定义没生效检查Obi文件夹下有没有.asmdef有的话确保它被正确引用。# 导入后如果编译报错先看控制台第一条错误 # 常见错误Obi 命名空间缺失 - 检查 asmdef 引用 # 常见错误Shader 找不到 - 检查渲染管线设置操作步骤新建 3D 项目导入源码包打开Samples/FluidViscosity场景点运行。如果看到液体从发射器流出并在地面摊开说明基础环境没问题。如果液体不动检查ObiSolver的gravity是否为零或者ObiEmitter的speed是否为零。3.2 参数面板逐项拆解solver、emitter、renderer 各管什么跑通之后别急着改代码先把 Inspector 面板过一遍。ObiSolver上最影响效果的是substeps、iterations、gravity、damping。damping是速度阻尼值越大液体越粘稠但太大就变成胶水。ObiEmitter上重点是speed、resolution、particleRadius、phase。speed控制发射初速度太大液体像喷泉太小流不出来。ObiParticleRenderer管视觉radiusScale要和物理半径匹配renderMode可以选粒子、网格或屏幕空间流体。参数所属组件作用常用范围substepsObiSolver每帧子步数1-3iterationsObiSolver约束迭代次数3-8dampingObiSolver速度阻尼0-0.5resolutionObiEmitter采样密度0.3-1.0particleRadiusObiEmitter物理半径0.05-0.2radiusScaleObiParticleRenderer视觉半径倍率1.0-1.5调参顺序建议先定resolution和particleRadius决定液体粗细再调speed控制流速最后用damping和iterations微调粘稠感。每次只改一个参数改完跑十秒看稳定性。3.3 用代码动态控制发射脚本接口与事件回调示例场景是静态的实际项目里往往需要按需发射。ObiEmitter提供了speed、enabled等属性可以在脚本里直接改。更细的控制可以用ObiSolver的OnParticleAdded和OnParticleRemoved事件做粒子回收或触发音效。using UnityEngine; using Obi; public class FluidController : MonoBehaviour { public ObiEmitter emitter; public ObiSolver solver; void Start() { // 订阅粒子添加事件用于统计或触发逻辑 solver.OnParticleAdded (ObiSolver.Particle particle) { // 每新增一个粒子做点什么 }; } void Update() { // 按住空格加速发射松开恢复 if (Input.GetKey(KeyCode.Space)) { emitter.speed 3.0f; } else { emitter.speed 1.0f; } } }这段代码说明两件事一是emitter.speed可以运行时改适合做交互二是solver的事件回调能拿到粒子引用适合做粒子级别的逻辑。参数上speed的单位是米每秒超过 5 容易穿模需要配合更高的substeps。4. 避坑与排查液体穿模、抖动、性能暴跌的常见原因4.1 液体穿模碰撞体厚度和求解器迭代不够现象液体从容器底部漏出去或者穿过薄壁。原因通常是碰撞体太薄或者iterations太低导致约束没收敛。解决把碰撞体厚度加到粒子半径的两倍以上iterations从 3 提到 5 到 8substeps提到 2。如果还漏检查碰撞体的ObiCollider组件是否勾选了CollideWithParticles。4.2 液体抖动或爆炸damping 和 substeps 没配好现象液体静止时不停抖动或者突然炸开飞散。原因一般是damping太小、substeps太低或者gravity和speed冲突。解决先把damping加到 0.2 到 0.4substeps提到 2观察是否稳定。如果还炸检查粒子半径是否太小导致密度约束过强适当加大particleRadius。4.3 性能暴跌粒子数和渲染模式是主要开销现象帧率从 60 掉到 20 以下。原因通常是resolution太小导致粒子数过万或者renderMode选了屏幕空间流体但没优化。解决先看ObiSolver面板上的粒子计数超过 5000 就要考虑降resolution或减少发射器。渲染模式优先用粒子或网格屏幕空间流体虽然好看但开销大。移动端把substeps压到 1iterations压到 3。4.4 相位配错导致液体互穿现象两种液体混在一起但不融合或者该融合的却互相弹开。原因相位配置错误相同相位的粒子才会产生约束。解决检查ObiPhase资产需要融合的液体用同一个相位需要隔离的用不同相位。改完相位后要重新生成粒子否则旧粒子还带旧相位。4.5 导入后 Shader 报错或液体不可见现象场景跑起来但液体看不见控制台有 Shader 错误。原因渲染管线不匹配或者 Shader 变体没编译。解决内置管线用Obi/Fluid系列 ShaderURP 需要换Obi/URP/FluidHDRP 支持有限。如果 Shader 报错检查Obi/Shaders目录下是否有对应管线的文件没有的话说明源码包只带内置管线版本。5. 进阶技巧用相位分组做分层液体和性能验证相位分组是 Obi Fluid 里最容易被忽略但最实用的功能。举个例子做一杯鸡尾酒底层糖浆、中层果汁、顶层泡沫三种液体密度和粘度不同但又要叠在一起。做法是建三个ObiPhase资产分别配不同的density和viscosity然后给三个发射器分别指定相位。相同相位的粒子才会互相产生密度约束不同相位之间只做碰撞这样就能做出分层效果。参数上底层相位density调高、viscosity调大顶层相位density调低、viscosity调小中间过渡层可以加一个混合相位。验证性能有个笨办法但很管用在ObiSolver上挂一个脚本每帧记录粒子数和帧时间跑三十秒后输出平均值。我一般会对比三组配置默认参数、substeps2、substeps2加iterations6看帧时间涨了多少。如果涨了超过 50%就要考虑降resolution或者减少发射器数量。另一个技巧是用ObiParticleRenderer的renderMode做 A/B 对比粒子模式最快网格模式居中屏幕空间流体最慢但最好看。移动端我通常只用粒子模式桌面端可以上屏幕空间流体。// 性能采样脚本挂在 ObiSolver 上 using UnityEngine; using Obi; public class FluidProfiler : MonoBehaviour { public ObiSolver solver; private float totalTime; private int frames; void Update() { totalTime Time.deltaTime; frames; if (frames 300) { // 约 5 秒 Debug.Log($平均帧时间: {totalTime / frames * 1000:F2} ms, 粒子数: {solver.particleCount}); totalTime 0; frames 0; } } }这段脚本每五秒输出一次平均帧时间和粒子数方便对比不同参数下的性能。参数上solver.particleCount是只读属性直接拿就行。如果粒子数超过 8000 且帧时间超过 16ms基本可以判定需要优化了。从那以后我每次调流体参数都强制走一遍「先定粒子半径和分辨率再调粘度和阻尼最后压性能」的流程不再一上来就乱拉滑块。希望帮到你。本文还有配套的精品资源点击获取