用Unity打造宋代四雅数字体验展：场景、交互与粒子特效实战

之前在给一个传统文化展示项目做技术验证时，我一直在想一个问题：像“宋代四雅”这样偏静态、偏意境的文化主题，能不能靠个人开发者用 Unity 做成有看头、能互动、还能对外演示的数字体验展？实际做完一个原型后发现，答案是肯定的，但前提是把项目拆得足够细，交互做得足够轻，把有限的精力集中在几个真正能打动人的环节上。本文就以“宋代四雅”数字体验展为完整案例，梳理从场景规划、交互脚本到粒子特效、UI 搭建的落地路径，并对独立开发过程中最容易踩的坑做一次集中排查。无论你是想做文化类数字展、虚拟展馆，还是历史题材交互作品，这套思路都可以直接复用。

1. 项目背景与核心概念

1.1 “宋代四雅”数字体验展是什么

“宋代四雅”指的是焚香、点茶、挂画、插花四件事。在宋代文人的日常生活中，这四件事不只是实用技能，而是一套完整的审美仪式：焚香求静，点茶观沫，挂画品境，插花得体。做成数字体验展之后，观众不需要触碰真实文物，就能在虚拟空间里近距离观察茶筅击拂时茶汤泛起的泡沫，感受香烟升腾的节奏，或者把一朵花拖进花瓶里完成一次插花构图。

用 Unity 做这类项目，和做游戏有相似之处，但也有明显差异。游戏的核心目标是“好玩”，需要明确的数值、关卡和对抗反馈；而文化体验展的核心目标是“沉浸和理解”，节奏通常更慢，交互更轻，界面风格也更接近展厅而不是 HUD。因此，项目在前期规划时就要刻意减少复杂系统，把有限资源集中在氛围、材质、粒子和交互反馈上。

1.2 为什么选择 Unity 作为开发引擎

Unity 在文化类数字体验项目里有几个天然优势。第一是跨平台能力，一套交互逻辑可以输出到 Windows 大屏、WebGL 网页、Android 平板甚至 Pico 这类 VR 头显，适合不同场馆的部署条件；第二是粒子系统和 Shader 生态成熟，茶烟、水汽、光线晕染这类氛围效果不需要自己写底层渲染引擎；第三是 Asset Store 里有大量现成的模型、材质和插件，独立开发者可以节省大量从零建模的时间；第四是 C# 脚本上手门槛相对低，一个开发者可以同时承担交互逻辑、UI 和简单工具链开发。

当然，Unity 也有需要注意的地方。URP 管线下材质、光照设置与传统内置渲染管线有差异，部分自定义 Shader 需要重写；WebGL 平台的加载体积和内存限制比较严格；如果要做 VR 版本，还需要额外处理 XR 插件与 URP 的兼容问题。这些内容会在后面的章节展开。

1.3 独立开发者如何控制项目范围

独立开发者做文化类数字展，最大的风险是“什么都想做”。四雅主题本身可以扩展成几十个展项，但单人的产能有限，因此建议用“一个核心模块 + 三个轻量模块”的方式来规划。

也就是说，四个展区里挑一个交互最丰富、最能代表主题的模块做深做透，其他三个先做可交互的原型，确保整体流程能跑通。在本文的方案里，点茶是核心模块，后续章节会给出完整代码；焚香、挂画、插花分别对应粒子模拟、图片细节查看和拖拽摆放三种交互范式，代码量可控，非常适合个人开发者逐步迭代。

2. 环境准备与项目规划

2.1 开发环境与版本说明

版本需要根据你的项目实际情况调整，本文示例以 Unity 2022.3 LTS 加 URP 渲染管线为例，重点演示配置思路。使用 LTS 版本的好处是稳定性高，社区资料多，遇到问题更容易找到解决方案。如果你用的是 Unity 6 或更早的 2021 LTS，核心逻辑不变，但部分 API 和包版本需要核对。

建议的环境如下：

创建项目时，在 Unity Hub 里选择 “Universal 3D” 模板，这样会自动生成 URP 相关的管线配置。如果你的项目已经是内置渲染管线，可以后续通过 Package Manager 升级，但需要注意材质替换的问题。

2.2 项目目录结构

独立开发很容易把资源全部堆在 Assets 根目录，前期还好，后期维护非常痛苦。建议一开始就按功能分目录，参考结构如下：

Assets/ Scenes/ // 所有场景 MainMenu.unity IncenseScene.unity TeaScene.unity PaintingScene.unity FlowerScene.unity Scripts/ // C# 脚本 Core/ // 场景管理、状态管理 Interaction/ // 各展区交互脚本 UI/ // UI 控制器 Art/ // 美术资源 Models/ // 茶盏、茶筅、香炉、花瓶等 Materials/ // 材质 Textures/ // 贴图 Particles/ // 粒子系统预设 Prefabs/ // 预制体 UI/ Fonts/ // 中文字体资源 Sprites/ // UI 图片 AddressableAssets/ // Addressables 分组（如果使用）

场景目录按展区拆分，每个展区一个独立场景，好处是加载时间可控、单个场景复杂度可控。如果展馆很大，也可以采用“一个场景 + 分区切换”的方式，但独立开发前期建议以场景为单位开发，逻辑更清晰。

2.3 场景与体验流程设计

数字体验展的流程设计和游戏关卡类似，建议按照“入场引导 → 四雅体验 → 结束回顾”三个阶段来设计。

入场引导需要一个简单的开始界面，介绍四雅概念，并提供四个展区入口。四个展区之间存在顺序关系，传统上按“焚香 → 点茶 → 挂画 → 插花”的雅集流程来走，也可以允许观众自由选择。结束回顾可以做成一个“集章”形式的界面，观众完成每个展区的互动后获得一枚印章，这样既增加了目标感，也能让流程完整闭环。

3. 关键技术模块拆解

3.1 场景管理与异步加载

四雅展区使用多个场景，需要一套统一的场景切换逻辑。直接使用SceneManager.LoadScene虽然简单，但在场景较大时会出现短暂卡顿。更稳妥的方式是用异步加载，并配合加载进度 UI 提升体验。

using System.Collections; using UnityEngine; using UnityEngine.SceneManagement; using UnityEngine.UI; public class ExhibitionSceneManager : MonoBehaviour { [Header("加载面板")] public GameObject loadingPanel; public Slider loadingSlider; public void SwitchScene(string sceneName) { StartCoroutine(LoadSceneAsync(sceneName)); } private IEnumerator LoadSceneAsync(string sceneName) { if (loadingPanel != null) { loadingPanel.SetActive(true); } AsyncOperation operation = SceneManager.LoadSceneAsync(sceneName); operation.allowSceneActivation = false; while (operation.progress < 0.9f) { if (loadingSlider != null) { loadingSlider.value = operation.progress; } yield return null; } if (loadingSlider != null) { loadingSlider.value = 1f; } operation.allowSceneActivation = true; } }

这里有一个关键点：allowSceneActivation = false表示加载到 90% 后先暂停，等我们把进度条显示到 100% 再真正切换场景。如果不设置这个字段，场景可能在进度条还没显示完时就切换了，视觉上会显得突兀。这个脚本可以放在任何常驻物体上，比如开始场景里一个不销毁的 GameManager。

3.2 点茶交互：输入、动画与粒子联动

点茶是宋代茶艺中“击拂”茶汤的过程，核心动作是用茶筅在茶盏中快速搅动，让茶汤产生细腻的沫饽。在 Unity 里实现这个交互，需要三个部分配合：

第一部分是输入检测，判断玩家是否按住鼠标左键或触摸屏幕；第二部分是茶筅的圆周运动，让茶筅围绕茶盏中心做旋转；第三部分是粒子系统，根据搅动速度动态调整茶汤粒子的数量和颜色。

茶筅绕茶盏中心做圆周运动，使用三角函数即可实现。Mathf.Cos和Mathf.Sin分别计算 X 轴和 Z 轴方向的偏移，乘以半径就得到一个圆形轨迹。为了让运动平滑，圆心位置取茶盏的 Transform，这样茶盞移动时茶筅也能自动跟随。

粒子系统方面，用ParticleSystem.EmissionModule.rateOverTime控制单位时间产生的粒子数。按住鼠标时把速率调高，松开时归零，茶汤就会呈现“静止时平静、击拂时翻涌”的效果。更细腻的做法是让粒子颜色从深茶色逐渐过渡到乳白色，模拟茶汤逐渐起泡变白的过程。

3.3 焚香模块：PerlinNoise 模拟香烟扰动

焚香模块的核心是香烟效果。直接在场景里放一个匀速上升的粒子系统，效果会非常假，因为真实香烟会受到室内气流影响，呈现缓慢摆动的轨迹。这里推荐用 Unity 内置的Mathf.PerlinNoise生成连续的风力扰动，让粒子在上升过程中左右轻微飘动。

using UnityEngine; public class IncenseSmokeController : MonoBehaviour { public ParticleSystem smokeParticle; [Tooltip("风力扰动强度")] public float windStrength = 0.03f; [Tooltip("扰动变化速度")] public float windSpeed = 0.2f; private ParticleSystem.VelocityOverLifetimeModule velocityModule; void Start() { if (smokeParticle != null) { velocityModule = smokeParticle.velocityOverLifetime; } } void Update() { if (smokeParticle == null) return; // 用 PerlinNoise 生成平滑的连续扰动 float windX = (Mathf.PerlinNoise(Time.time * windSpeed, 0f) - 0.5f) * windStrength; float windZ = (Mathf.PerlinNoise(0f, Time.time * windSpeed) - 0.5f) * windStrength; velocityModule.x = new ParticleSystem.MinMaxCurve(windX); velocityModule.z = new ParticleSystem.MinMaxCurve(windZ); } }

为什么不用Random.Range直接给风力赋值？因为随机数每次取值之间的差异是跳跃的，香烟轨迹看起来会不停抖动，不够自然。PerlinNoise生成的是连续变化的噪声值，配合时间因子，可以让风力扰动保持平滑，视觉上更接近真实气流。

粒子系统本身也需要配置：粒子的 Start Lifetime 建议在 3 到 5 秒之间，Start Speed 设置在 0.2 左右，使用默认的软粒子材质，颜色设为浅灰色而不是纯白。纯白在暗背景下容易曝光过度，浅灰配合半透明效果更柔和。

3.4 挂画模块：画面细节查看与缩放

挂画展区不需要太复杂的交互，重点是让观众能看清画作的细节。常见的实现方式有两种：一种是在 3D 场景里放置画框模型，玩家靠近后触发特写镜头；另一种是切换到 2D UI 展示高清画面，支持缩放和拖拽查看局部。

独立开发建议优先使用“3D 场景展示 + UI 细节弹层”的组合。场景里的画框可以模拟展厅悬挂效果，提供空间感；点击画作后，弹出 UI 面板显示高清图，支持滚轮缩放和右键拖拽，方便看笔触和落款。

缩放和拖拽的核心是控制RectTransform的 localScale 和 anchoredPosition。缩放要限制最小值和最大值，避免图片被缩小到看不见或者放大到失真；拖拽的位移速度需要根据当前缩放值调整，否则放大后拖拽会过于灵敏。

3.5 插花模块：拖拽摆放与区域判定

插花模块最自然的交互是“选择花枝 → 拖拽到花瓶 → 摆放成功”。在 Unity UI 中实现拖拽，可以用IBeginDragHandler、IDragHandler、IEndDragHandler三个接口。拖拽过程中通过eventData.delta实时更新 UI 元素的位置；松开时判断是否落在花瓶区域，成功则吸附到花瓶位置，失败则回到原位。

区域判定可以使用RectTransformUtility.RectangleContainsScreenPoint，这个方法可以判断屏幕坐标点是否落在指定 RectTransform 范围内。需要注意的是，Canvas 的 Render Mode 会影响坐标换算，使用 ScreenSpace Overlay 时worldCamera传 null 即可，使用 Camera 模式时需要传入 Canvas 关联的摄像机。

4. 完整实战：点茶交互模块

4.1 场景搭建

在 Unity 里新建一个空场景，命名为TeaScene，按以下步骤搭建基础场景。

第一，创建地面。新建一个 Plane，缩放调整为合适大小，赋予深色木纹材质，模拟展厅里的茶案。

第二，创建茶盏。用 Blender 简单建模一个盏形物体，或者从 Asset Store 找一个合适的茶碗模型。为了防止交互时穿模，茶盏口沿需要加一个 Collider，后面茶筅的位置控制会用到茶盏中心点。

第三，创建茶筅。茶筅是点茶的关键道具，可以建模成一根竹柄加上底部竹丝的造型。这里不需要高精度模型，重点是玩家能从视觉上分清“茶筅”和“茶盏”，所以轮廓清晰比细节丰富更重要。

第四，创建茶汤粒子系统。在茶盏中心位置创建一个空物体，挂上 ParticleSystem，作为茶汤粒子发射器。粒子使用圆形纹理，大小调小一些，颜色先设为深茶色。

第五，搭建 UI。在 Canvas 下添加一个 Slider 作为点茶进度条，再添加一个完成提示面板（默认隐藏），用来提示“点茶完成”。

4.2 编写点茶交互脚本

在Assets/Scripts/Interaction目录下创建脚本TeaWhiskingController.cs，完整代码如下：

using UnityEngine; using UnityEngine.UI; public class TeaWhiskingController : MonoBehaviour { [Header("交互对象")] public Transform teaWhisk; // 茶筅 public Transform teaBowlCenter; // 茶盏中心 [Header("粒子系统")] public ParticleSystem teaParticle; [Header("进度 UI")] public Slider progressSlider; public GameObject completePanel; [Header("参数")] public float whiskRadius = 0.12f; // 茶筅旋转半径 public float whiskSpeed = 2.5f; // 茶筅旋转速度 public float progressSpeed = 6f; // 点茶进度增长速度 private float currentProgress = 0f; private bool isWhisking = false; private bool isComplete = false; void Start() { if (progressSlider != null) { progressSlider.value = 0f; } if (completePanel != null) { completePanel.SetActive(false); } } void Update() { if (isComplete) return; // PC 上按住鼠标左键，移动端会自动匹配触摸输入 isWhisking = Input.GetMouseButton(0); // 茶筅绕茶盏中心做圆周运动 if (teaWhisk != null && teaBowlCenter != null && isWhisking) { float angle = Time.time * whiskSpeed; Vector3 offset = new Vector3( Mathf.Cos(angle) * whiskRadius, 0f, Mathf.Sin(angle) * whiskRadius ); teaWhisk.position = teaBowlCenter.position + offset; } UpdateProgress(); UpdateParticle(); } private void UpdateProgress() { if (!isWhisking || progressSlider == null) return; currentProgress += progressSpeed * Time.deltaTime; currentProgress = Mathf.Clamp(currentProgress, 0f, 100f); progressSlider.value = currentProgress; if (currentProgress >= 100f) { isComplete = true; if (completePanel != null) { completePanel.SetActive(true); } Debug.Log("点茶完成：茶汤已泛起细腻沫饽"); } } private void UpdateParticle() { if (teaParticle == null) return; ParticleSystem.MainModule main = teaParticle.main; ParticleSystem.EmissionModule emission = teaParticle.emission; // 击拂时粒子变多，静止时粒子停止 emission.rateOverTime = isWhisking ? 200f : 0f; // 进度越高，茶汤颜色越接近乳白色 float progress01 = Mathf.Clamp01(progressSlider.value / 100f); main.startColor = Color.Lerp( new Color(0.45f, 0.32f, 0.15f, 1f), // 深茶色 new Color(0.95f, 0.92f, 0.85f, 1f), // 乳白色 progress01 ); } }

4.3 配置脚本参数

创建好脚本后，回到场景完成以下绑定：

在 Hierarchy 中创建一个空物体，命名为TeaInteractionManager，挂上TeaWhiskingController脚本。把茶筅物体拖到Tea Whisk字段，把茶盏中心点（或茶盏 Transform）拖到Tea Bowl Center字段，把茶汤粒子系统拖到Tea Particle字段，再把 UI 里的 Slider 和完成面板分别拖到对应字段。

Whisk Radius参数要根据茶盏的实际大小调整。如果茶筅旋转时跑到了茶盏外面，说明半径太大；如果旋转范围明显小于盏口，说明半径太小。最稳妥的做法是在 Scene 视图里播放，直接观察茶筅是否贴着盏内壁运动。

Progress Speed决定点茶完成需要的时间。本文示例设成 6 表示每秒涨 6%，大约 17 秒完成一次点茶。这个时长可以根据展览的节奏调整：观众随意体验时可以快一些，正式展览想要仪式感可以调到 3 到 4。

4.4 运行与验证

把TeaScene加入 Build Settings，点击 Play 进入运行状态。按住鼠标左键，茶筅应该绕茶盏中心旋转，茶汤粒子开始产生并且颜色逐渐变浅。松开鼠标，粒子停止产生。进度条满后，完成面板弹出，日志输出“点茶完成”。

这里还需要做一个细节验证：粒子系统的颜色过渡是否平滑。如果颜色跳变明显，可以在UpdateParticle里加一个插值速度，例如main.startColor = Color.Lerp(main.startColor.color, target, Time.deltaTime * 2f);，让颜色跟随进度缓慢过渡而不是瞬间变化，视觉上更自然。

4.5 结果说明

从这个模块里可以提炼出一个可复用的规律：任何文化类交互都可以拆成“输入检测 → 状态计算 → 表现反馈”三层。茶筅旋转是表现，进度推进是状态计算，按住鼠标是输入。后续做焚香时，把“击拂”换成“点燃”，把“进度”换成“香炉亮度”，结构上是一致的。这种分层思路是独立开发控制代码复杂度的关键。

5. 常见问题与排查思路

数字体验展项目里，很多问题不是逻辑写错，而是环境配置或资源处理不当。下面按出现频率整理一份排查清单。

5.1 粒子不显示

粒子系统不显示，最常见的原因是 Emission 的 rateOverTime 为 0。我们的脚本在松开鼠标时会把速率设为 0，如果开始测试时以为“粒子应该在场景中始终可见”，就会看到空荡荡的粒子物体。排查时先在 Inspector 里手动把 rate 调大，确认粒子能显示，再检查脚本是否把速率清掉了。

另一个常见原因是粒子材质问题。URP 下如果使用的 Shader 还是内置管线的Legacy Shaders/Particles/Alpha Blended，粒子会显示为不可见或半透明异常。解决方法是把粒子材质替换为Universal Render Pipeline/Particles/Unlit或Lit系列 Shader。

5.2 UI 点击穿透问题

插花模块和挂画模块都可能遇到一个现象：点击 UI 按钮时，背后的 3D 物体也收到了点击事件。这是因为场景里同时使用了 UI EventSystem 和 3D Raycast，两者没有做屏蔽。

解决思路是给 UI 根节点增加CanvasGroup，把 Blocks Raycasts 打开，确保 UI 在显示时拦截所有点击事件；或者通过EventSystem.current.IsPointerOverGameObject()判断鼠标是否在 UI 上，如果是就不再触发后续的 3D 交互逻辑。

5.3 打包到 Pico 等 XR 设备后出现渲染异常

如果项目后续要输出到 Pico 4 这类 VR 头显，URP 和 XR 插件的版本兼容性是重点。部分 Unity 与 Pico XR Plugin 的组合下，可能遇到 RenderPassIndex 相关的索引越界异常，或者场景渲染黑屏、单眼画面异常。

这一类问题没有统一的魔法修复，建议按三步排查：第一步，确认 Unity 版本与 Pico 官方推荐的 XR Plugin 版本匹配，优先使用官方文档中列举的版本组合；第二步，检查 URP 的渲染设置，在 XR 项目里优先使用 Single Pass Instanced 模式，避免 Multi Pass 带来的兼容问题；第三步，升级 URP 到项目允许的最新稳定版，并重新生成相关材质。如果问题仍然存在，可以暂时把这段渲染固定到 PC 平台，优先保证主流程可演示。

6. 最佳实践与工程建议

6.1 文化内容的技术表达要克制

文化类数字展最容易犯的错误，是为了“炫技”破坏意境。宋代的审美讲究留白和含蓄，数字体验里也应该遵循这个原则：粒子数量不要堆满屏幕，颜色饱和度不要过高，镜头运动速度要慢，转场不要用花哨的特效。

具体来说，焚香场景的灯光建议用暖色调点光源，模拟香炉微光；点茶场景的粒子控制在低调范围内，避免变成“喷泉”；挂画场景的画面周围保留适当暗角，让视觉聚焦在画面上。项目有没有“文化感”，很多时候不取决于功能多少，而在于节奏和氛围是否克制。

6.2 资源加载与内存管理

如果四个展区全部打包到一个场景，启动加载会很慢；如果每个展区一个场景且没有做资源优化，场景切换时的峰值内存容易触顶。建议在一个场景内使用 Addressables 管理大体积资源，把画作贴图、3D 模型、音频按展区分组加载，场景切换时释放不再使用的组。

使用 Addressables 时，Addressables.Release和ResourceManager的引用计数容易踩坑。核心原则是谁加载谁释放：加载完成时记住返回的AsyncOperationHandle，在确定场景不再需要该资源时调用Addressables.Release(handle)。另外，UI 常用的 Sprite 可以打成 Sprite Atlas，减少 Draw Call 和加载开销。

6.3 渲染与性能优化

文化展项目虽然画面偏静态，但粒子系统和 Shader 仍然有消耗。做 PC 版本时，中端配置应保证 60 帧；做 WebGL 版本时，目标可以适当降到 30 到 50 帧，并严格控制场景里的实时灯光数量。

建议开启 URP 的 SRP Batcher，把场景里大量重复材质合并批次；静态物体勾选 Static 并烘焙光照，避免实时阴影开销；粒子系统使用较小的贴图和较短的粒子生命周期，减少过度绘制；如果场景里有多个画框，可以用单张 Texture Atlas 减少不同贴图之间的切换。

6.4 多平台输入与分辨率适配

四个展区的交互都需要支持鼠标和触屏，建议在新项目里直接使用 Input System 包，用同一套代码映射鼠标、触摸和 VR 手势。如果继续使用旧 Input Manager，至少保证所有Input.GetMouseButton相关的逻辑在触摸屏上也能正常触发。

分辨率适配方面，电脑端和 WebGL 的宽高比可能完全不同。UI 的 Canvas Scaler 建议使用 “Scale With Screen Size” 模式，参考分辨率设为 1920×1080，匹配宽高比。挂画和插花模块的坐标计算要基于 Canvas 尺寸而不是屏幕像素，避免不同设备上错位。

6.5 版权与授权注意事项

文化类数字展涉及大量古代画作、文物照片和音乐素材。如果使用了博物馆公开的高清资源，要确认授权协议是允许商业展示还是仅限个人学习。独立开发者在项目正式对外发布前，建议把每个素材的授权来源记录在文档里，形成素材清单。涉及真实文物的三维扫描数据，通常不能直接用于商业项目，稳妥的做法是自己建模或者使用明确开放授权的资源。

7. 总结与后续学习方向

这个项目从零开始，最终能形成一条完整的展示链路：入口场景选择展区，异步加载点茶场景，按住鼠标完成击拂交互，粒子表现茶汤变化，最后通过进度和完成面板给观众正向反馈。焚香、挂画、插花三个模块在同样的框架下扩展即可。

后续想继续深入，可以优先学习三个方向：一是 URP 的 Shader Graph，用来自制水墨渲染和纸张质感，这是文化类项目的加分项；二是 XR 交互设计，把现有的 PC 交互迁移到 Pico 这类设备上，需要考虑手柄射线、注视交互和防眩晕设计；三是 Addressables 的资源分组策略，在场景数量增加后保证加载效率和内存稳定。

建议先跑通点茶这一个模块，把交互手感调顺，再逐步扩展其他展区。文化类数字体验的开发节奏和游戏不一样，它更强调每一步都稳一点，慢一点。四雅展项目的每一次交互优化，其实都是在向那种旧时的生活方式靠近一点。