1. 项目整体设计与技术选型思路汉绣这类非遗题材做数字化展示最早我接触到的方案大多是网页端的360度全景图点一下换个角度看两眼就腻了。真正想做“展馆”那种沉浸感——推开大门、顺着回廊走、凑近看展柜里的绣品针脚——网页方案要么加载卡顿要么光照假得离谱。所以这套基于Unity 3D C#的汉绣文化主题虚拟展馆交互漫游系统本质上解决的就是一个问题用实时渲染引擎把线下展馆的空间感、材质感和探索感搬到屏幕上。它面向的读者很广Unity 初学者可以当成一个完整的练手项目非遗数字化方向的从业者可以参考里面内容转化的思路做数字展厅、校史馆、博物馆的同行也能直接套用漫游和交互框架。先说说为什么最终拍板 Unity 而不是别的引擎。跨平台是第一位的同一套工程导出 PC 客户端给展厅大屏用导出 WebGL 挂到服务器让人在线看甚至改一改部署到 VR 一体机上代码几乎不用动。其次是C# 这一层的开发效率托管语言不用手动管内存改一行编译几秒钟就能在编辑器里跑起来调漫游手感这种需要反复试参数的事情迭代越快越省命。第三是 Unity 的资源生态和光照烘焙能力展馆场景大量依赖静态光照和 Lightmap这块 Unity 的 Enlighten 加 Progressive GPU 烘焙器成熟度很高出来的效果比自己在 WebGL 里手搓着色器靠谱太多。1.1 需求边界怎么划避免做成“四不像”我见过不少同类项目翻车都是因为一开始没想清楚要做什么。有人想做成游戏加了任务系统、成就、背包有人想做成建筑漫游结果展品交互又很敷衍。这个项目的定位我建议锁死在三个关键词上漫游、观展、导览。漫游是第一人称自由走观展是靠近展品触发信息面板导览是给不想乱逛的人一条预设路线。除此之外的东西比如多人联机、聊天、点赞在文化展馆场景里属于典型的“投入大、收益低”直接砍掉。把功能拆开看大致是下面这张表里的范围功能模块具体内容优先级第一人称漫游WASD 移动、鼠标转视角、跳跃可选、碰撞阻挡必须展品交互准星射线检测、高亮提示、点击弹出图文/音视频必须导览路线路径点动画、自动移动、可随时退出重要环境氛围背景音、脚步音、展品解说、灯光呼吸重要小地图平面缩略图 玩家位置指示可选存档记录已看展品、导览进度可选提示功能边界一定要在原型阶段就定死。我吃过亏做到一半临时加“双击展品放大看细节”的需求结果发现所有展品的模型精度根本不够放大最后只能全部返工重做高模工期直接翻倍。1.2 工程目录与资源组织规范Unity 项目最怕的就是 Assets 目录乱成一锅粥几百个资源全堆在根目录找一张贴图要翻半天。这个项目的资源量不算大但模型、贴图、音频、预制体、脚本、动画一样不少所以从第一天就得分好目录。我的习惯是按类型加场景双层划分Assets/_Project/Scripts所有 C# 脚本再按Player、Interaction、UI、Manager分子目录。Assets/_Project/Art/Models按展品编号建子文件夹一个展品一个文件夹里面放它的 fbx、材质、贴图。Assets/_Project/Art/Textures公共贴图比如地面、墙面、木纹。Assets/_Project/Art/LightingLightmap 和光照数据这个必须单独放烘焙数据文件很大。Assets/_Project/Prefabs预制体展品、灯具、展柜都做成预制体。Assets/_Project/AudioBGM、音效、解说命名带上bgm_、sfx_、vo_前缀。Assets/_Project/Scenes主场景、加载场景、测试场景。命名上我强制自己用英文加下划线比如Exhibit_HanXiu_01.fbx因为 Unity 对中文路径的支持在某些打包流程里会出玄学问题尤其是导出 WebGL 的时候。中文名只出现在最终显示给用户的 UI 文本里资源层一律英文。2. 汉绣文化内容的三维化处理与建模要点非遗题材和普通游戏场景最大的区别在于展品是内容的核心模型精度和贴图还原度直接决定项目成败。汉绣的绣品本身是平的但它的价值在于丝线的走向、颜色的层次、金线的反光这些细节如果模型和贴图做糊了整个展馆就变成了一个空壳子。所以这一块我花了整个项目大概四成的时间。2.1 从实物到模型的采集与减面流程汉绣展品的采集我当时用了两条路。一条是去实地拍摄高分辨率照片用摄影测量的方式重建适合有立体结构的物件比如绣屏、绣架、立轴。另一条是用3D 结构光相机对小型绣品做近距离扫描它点云密度高能还原出刺绣表面的起伏。不过结构光扫描有个坑遇到深色或者反光的丝线表面容易丢点所以扫描前我会在绣品上喷一层很薄的哑光显影剂扫描完再清掉。拿到高模之后下一步是减面。一个从结构光扫出来的绣品高模动辄几十万面直接丢进 Unity 帧率直接崩。展品我会控制在5000 到 20000 三角面之间具体看它在场景里离观众多远。放在展柜里让人凑近看的给 15000 面以上挂在远处墙上的装饰绣片3000 面就够了。减面用 Blender 的 Decimate 或者 ZBrush 的 Decimation Master减完之后一定要重新展 UV因为自动减面会把原来的 UV 打得乱七八糟。这里有个容易被忽略的点减面之后法线的处理。汉绣的绣面有丝线的蓬松感如果只靠几何体减面后细节全丢看着像塑料片。我的做法是把高模的法线细节烘焙到低模的切线空间法线贴图上这一步是在 Substance Painter 或者 XNormal 里做的。烘焙的时候要注意高模低模的包裹关系包裹距离设太大会把周围的杂线也烘进去太小又有细节烘不到我一般先用自动包裹再手动调Max Rear Distance到模型尺寸的 5% 左右。2.2 汉绣纹样的贴图还原与材质调校汉绣的色彩特点是浓烈、饱满常用大红、深蓝、墨绿打底再用金线勾边行话叫“平金夹绣”。要让它在实时渲染里出效果材质不能简单地给个颜色了事。我在 Unity 里用的是 URP 管线的 Lit 材质重点调三个参数Base Map绣品的底色和图案分辨率至少 2048凑近看的展品给到 4096。Metallic / Smoothness金线的部分单独做一张遮罩贴图金属度拉到 0.8 以上光滑度 0.6 左右这样才能有那种金属丝线的反光。Normal Map从高模烘出来的法线强度不要拉满0.6 到 0.8 之间比较自然拉满会显得像塑料。丝线还有一个特性是各向异性反光也就是顺着丝线方向的反光和垂直方向不一样。Unity 的 Lit 材质不带这个如果你的展品是特写重点可以换成各向异性着色器或者用一张细节法线贴图去模拟丝线的走向。我自己实测下来对于中远景的展品法线模拟完全够用只有那种“贴脸看针脚”的展品才需要上各向异性否则性价比不高。贴图管理上要养成合图的习惯。一个展馆如果几十个展品每个都挂三四张贴图Draw Call 会爆炸。我的做法是把同一区域的展品贴图打进一张2D Array 或者 Atlas材质合并成一个渲染时就能批处理。这里要注意 Atlas 的图集不能太大超过 4096 在部分移动端 GPU 上会出问题。2.3 展馆建筑空间与光照烘焙展馆本身的空间设计我参考了传统中式建筑的“院落—回廊—展厅”结构进门是一个小前厅左右两侧是主题展厅中间一个天井采光。这么做不只是为了好看更因为回廊和隔断能把大场景切成小块天然利于遮挡剔除玩家站在前厅看不到后面展厅的模型引擎就能把它剔除掉性能直接上来了。建筑模型尽量用模块化搭建墙、柱、梁、地砖都做成标准件重复拼装。这样好处有两个一是建模快二是光照烘焙时可以复用光照数据相同的模块只需要烘一次。光照这块我用的是混合光照模式主光源是一盏方向光模拟天光展厅内部靠点光源和射灯。展柜里的射灯是关键它要能照亮展品但不能照亮周围环境所以我把射灯的 Culling Mask 设置成只影响展品所在的 Layer。注意Lightmap 的分辨率不要一刀切全给高。墙面、地面这种大面积的东西给 20 到 40 texel 每单位就够展品和展柜周围给 60 以上。全场景高分辨率烘焙一张 Lightmap 能到几百兆加载慢还占内存。烘焙前还有一步不能省就是设置好每个物体的 Static 标记。只有勾了Contribute GI的静态物体才会参与烘焙动态物体比如玩家、可开合的柜门不能勾否则它们会把光照烘进场景里移动的时候就会留下一块黑影子。这个坑我踩过当时整个展厅地上有一块人形的阴影擦不掉排查了半天才发现是玩家角色被误标记成静态了。3. 交互漫游系统的核心实现内容做完了接下来是让它“能玩”。这一块是整个项目的骨架C# 脚本主要都集中在这里。我的原则是逻辑和表现分离控制器只管移动交互只管检测和触发UI 只管显示中间用事件解耦。这样做的好处是改一处不影响另一处比如把第一人称换成第三人称只需要换控制器交互和 UI 完全不用动。3.1 第一人称角色控制器与漫游手感调参Unity 自带的 CharacterController 组件是做第一人称漫游最省事的方案它自带胶囊碰撞不需要 Rigidbody斜坡和台阶处理也还行。核心脚本我贴一下简化版using UnityEngine; [RequireComponent(typeof(CharacterController))] public class PlayerWalker : MonoBehaviour { public float walkSpeed 3.0f; public float runSpeed 5.5f; public float jumpHeight 1.1f; public float gravity -18f; public Transform cameraRoot; public float mouseSensitivity 2.2f; public float maxPitch 80f; private CharacterController controller; private Vector3 velocity; private float pitch 0f; void Start() { controller GetComponentCharacterController(); Cursor.lockState CursorLockMode.Locked; } void Update() { // 视角 float mx Input.GetAxis(Mouse X) * mouseSensitivity; float my Input.GetAxis(Mouse Y) * mouseSensitivity; transform.Rotate(Vector3.up * mx); pitch Mathf.Clamp(pitch - my, -maxPitch, maxPitch); cameraRoot.localEulerAngles new Vector3(pitch, 0f, 0f); // 移动 float h Input.GetAxis(Horizontal); float v Input.GetAxis(Vertical); Vector3 move (transform.right * h transform.forward * v).normalized; float speed Input.GetKey(KeyCode.LeftShift) ? runSpeed : walkSpeed; if (controller.isGrounded velocity.y 0) velocity.y -2f; velocity.y gravity * Time.deltaTime; controller.Move(move * speed * Time.deltaTime velocity * Time.deltaTime); } }速度参数我反复调过很多次。走路 3.0 米每秒、跑步 5.5 米每秒是展厅场景比较舒服的区间太快了像在跑酷太慢了逛一个展厅要五分钟用户直接没耐心。鼠标灵敏度 2.2 是主流 FPS 手感的中间值如果你想让展馆这种慢节奏场景更稳一点可以降到 1.8。视角俯仰限制在正负 80 度是为了防止玩家把头转到脖子后面去看着很怪。还有一个细节是相机高度和晃动。相机节点挂在角色眼睛高度大概 1.65 米。如果完全不晃走起来像幽灵飘加点轻微的上下起伏会真实很多。但幅度不要大我试过 0.05 米的起伏看久了容易晕最后定在 0.03 米左右配合步伐节奏。晕动症这一块对展馆类项目很重要尤其是要放到大屏或者一体机上给普通观众用做得太刺激会被投诉。3.2 展品交互与信息面板的触发逻辑交互的核心是射线检测。从屏幕中心或者相机位置打一条射线出去碰到展品就高亮并显示提示点击就弹面板。脚本大概长这样using UnityEngine; using UnityEngine.UI; public class ExhibitInteractor : MonoBehaviour { public Camera playerCam; public float interactDistance 3.0f; public LayerMask exhibitLayer; public Text hintText; public ExhibitPanel panel; private Exhibit current; void Update() { Ray ray new Ray(playerCam.transform.position, playerCam.transform.forward); if (Physics.Raycast(ray, out RaycastHit hit, interactDistance, exhibitLayer)) { Exhibit ex hit.collider.GetComponentExhibit(); if (ex ! current) { SetCurrent(ex); } hintText.text 按 E 查看 ex.displayName; if (Input.GetKeyDown(KeyCode.E)) panel.Show(ex.data); } else if (current ! null) { SetCurrent(null); hintText.text ; } } void SetCurrent(Exhibit ex) { if (current ! null) current.SetHighlight(false); current ex; if (current ! null) current.SetHighlight(true); } }这里有几个实用细节。交互距离设 3 米是因为展柜玻璃通常离观众一两米展品在柜子里3 米能覆盖大多数凑近看的场景太远了会误触发太近了要贴脸才能点。LayerMask 一定要单独给展品建一层否则射线会打到墙、地、装饰物上出现隔着墙也能点展品的 bug。高亮效果我用的是描边Outline加一层淡淡的发光比单纯换颜色明显得多。展品的数据我建议用ScriptableObject存一个展品一个资产里面放名称、年代、工艺介绍、图片、音频。这么做的好处是内容编辑和程序完全分离改文案不用碰代码策划或者做内容的人自己就能改。面板弹出的时候要暂停漫游输入否则玩家还在走面板跟着晃体验很差。我一般会把Time.timeScale设成 0 或者直接关掉控制器的输入开关。3.3 导览路线、音效与整体氛围导览功能是给“懒人”准备的。实现上很简单就是一条路径点数组相机或者角色沿着点做插值移动到点停顿几秒播放解说然后继续。我用的是Vector3.Lerp加一个MoveTowards配合朝向的Quaternion.Slerp。要注意转弯处的处理如果直接线性插值转角会生硬加一个贝塞尔曲线平滑一下会好很多。导览过程中玩家随时按键就能退出切回自由漫游这个交互必须留否则用户被困在导览里会很烦躁。音效是氛围感的半条命。我分了四层背景音乐用一段悠远的古琴曲音量压低环境音是展厅的空旷混响循环播放脚步音跟着移动触发解说音在交互或导览时播放。音频的混音用 Unity 的 AudioMixer分组管理用户可以单独调 BGM 和解说的音量。这里有个小技巧展厅空间大直接播放声音会很干给 AudioSource 加一个 Reverb Zone 或者用混响滤镜声音就有了空间的包裹感一下子高级起来。提示解说音频一定要做渐入渐出别咔嚓一声开始又咔嚓一声结束。我习惯在 AudioSource 上做 0.3 秒的淡入淡出听感差别巨大。另外 WAV 格式虽然无损但体积大解说这种长音频建议转成压缩格式短音效保留 WAV。4. 性能优化与打包发布展馆类项目的性能压力主要来自三块大量静态模型、高分辨率贴图、实时光照。前面内容做得越精细这一块越要花心思。优化不是最后才做的事我在建模阶段就已经在考虑面数预算和贴图尺寸了等到打包前再优化返工成本高得吓人。4.1 渲染层面的优化手段批处理是第一步。相同材质的静态物体勾上Static就能自动合批动态物体用 GPU Instancing。展馆里重复的元素特别多比如展柜、地砖、装饰灯这些做成预制体复用配合 Instancing 能把 Draw Call 压到很低。我那个项目最终 Draw Call 稳定在 200 以内靠的就是这个。LOD对大型展品和建筑构件很有用。远处的绣屏用低模走近了自动切高模肉眼几乎看不出切换。LOD 的切换距离要配合相机 FOV 和场景尺度调切得太近会看到明显的模型跳变切得太远又没起到优化作用。遮挡剔除Occlusion Culling是回廊式展馆的杀手锏烘焙一次遮挡数据玩家在哪个房间就只渲染那个房间的东西帧率能翻倍。烘焙遮挡的时候要注意把 Agent 半径和高度设对设太大会把半开的门都当成遮挡物导致该看见的看不见。贴图压缩也不能忽视。PC 端可以用 DXT移动端和一体机优先ASTC同画质下体积小很多。还有 Mipmap 一定要开远处的贴图自动降分辨率能省不少带宽和显存。4.2 资源加载与内存管理场景大了之后一次性加载所有资源会卡顿甚至崩溃。我用的是Addressables做异步加载把展馆分成几个区块玩家走到哪个区块再加载哪个区块的资源离开就卸载。加载的时候给个转圈提示别让画面直接黑掉用户会觉得程序死了。内存这块最容易被忽略的是RenderTexture 和临时对象。UI 里如果用了相机渲染到纹理做小地图记得在不用的时候Release掉。还有一些脚本里new出来的 Vector3 数组高频调用会触发 GC导致周期性卡顿能缓存的就缓存成成员变量。优化项手段预期收益Draw Call静态批处理 GPU Instancing降 50% 以上三角面LOD 遮挡剔除降 40% 以上贴图内存ASTC 压缩 Mipmap降 60% 左右加载卡顿Addressables 分块异步加载消除主线程阻塞GC 卡顿对象池 缓存变量消除周期性掉帧4.3 打包与部署的注意事项PC 客户端打包最省心直接 Build 就行注意把窗口分辨率模式设成可调展厅大屏和笔记本都要能用。WebGL 打包坑最多首先首包体积要控制超过 30 兆加载就很慢了得靠 Addressables 把资源放服务器上按需拉取。其次是浏览器对内存有限制场景不能做太大。部署到 IIS 上的时候要配置 MIME 类型.wasm、.data、.js.gz这些后缀不配好浏览器会拒绝加载页面直接白屏。压缩传输开 Brotli 或者 Gzip加载速度能快好几倍。如果要做 VR 一体机版本比如基于 PICO 这类设备渲染压力比 PC 大得多单眼分辨率高、刷新率要求高所有优化都要更激进。这种情况下展品面数要往下降实时光源能砍就砍全靠烘焙。手柄交互也要重做一套把射线检测换成手柄射线。5. 常见问题与排查技巧实录做得多了就会发现展馆项目的问题翻来覆去就那么几类我把自己踩过的坑整理成一张速查表遇到问题先对号入座。现象可能原因排查与解决漫游时画面抖动移动逻辑写在 Update 里没乘 deltaTime所有位移乘Time.deltaTime角色穿墙或卡进模型碰撞体是 Mesh Collider 且没勾 Convex换成胶囊/盒碰撞体或勾 Convex隔着墙能点到展品射线没限制 LayerMask建展品专用 Layer设置 LayerMask展品高亮不消失高亮状态没在离开时复位切换到 null 时关闭描边地面有一块擦不掉的黑影动态物体被标记成 Static 参与烘焙取消勾选 Contribute GI烘焙后展柜玻璃发黑透明材质参与 GI 计算异常玻璃材质关闭 GI改用反射探针WebGL 加载白屏服务器 MIME 类型未配置配置 wasm/data 的 MIME帧率周期性掉一下GC 频繁回收临时对象对象池、缓存变量、避免频繁 new光照切换时闪烁混合光照模式参数不当调 Shadowmask 或改用 Baked Indirect5.1 漫游手感与碰撞的老大难问题抖动和穿模是最常见的两个投诉。抖动十有八九是没乘 deltaTime帧率一波动位移就跟帧率挂钩了看着就是一顿一顿的。穿模则多和碰撞体有关Unity 的 CharacterController 对 Mesh Collider 的支持不好遇到复杂的建筑模型最好用简化的 Box 或者 Capsule 碰撞体包裹别指望直接拿建筑网格当碰撞。台阶处理也是坑高度超过 0.3 米的台子CharacterController 的Step Offset要相应调大否则上不去。斜坡的话Slope Limit默认 45 度中式展馆的坡道一般不超过 20 度够用。5.2 交互逻辑的隐性 bug交互失效往往不是射线的问题而是生命周期顺序的问题。比如展品预制体在Start里注册到管理器但管理器在Awake里就已经初始化完了时序对不上就漏注册。这类问题我一般用事件中心统一分发或者用OnEnable/OnDisable成对注册注销比在 Start 里硬塞稳妥。另一个常见问题是 UI 面板和 3D 交互抢夺点击鼠标点在 UI 上时射线还在往场景里打导致点面板的同时又触发了展品。解决办法是用EventSystem.current.IsPointerOverGameObject()判断一下鼠标在 UI 上就跳过场景交互。5.3 光照烘焙的疑难杂症烘焙这块的坑最玄学。除了前面说的动态物体误标静态还有一个常见的是Lightmap 接缝处有黑线这是因为相邻模型的 UV 没对齐或者光照图分辨率不够解决办法是把相邻模块的 UV 合并烘焙或者提高那一片的 Lightmap 密度。玻璃材质发黑是因为透明物体参与 GI 计算时光线穿过它会产生错误的遮挡给玻璃关掉Cast Shadows或者不参与 GI 就能解决。还有光照数据文件太大的问题可以把光照图压缩格式改成 LDR精度够用体积小一半。提示每次改完光照参数都要重新烘焙别偷懒用实时光凑合。实时光在展厅这种多光源环境下噪点很多必须配合降噪性能和效果都不如烘焙。烘焙时间可以选在晚上跑白天继续调逻辑。最后分享一个我个人的习惯就是给自己留一个“问题记录本”每解决一个 bug 就记一笔现象、原因和解决办法。做到后面你会发现同一个坑换个场景还会再来一次有本子直接翻能省大把时间。汉绣虚拟展馆这类项目技术上没有特别深的黑科技拼的就是细节和耐心把内容做扎实、把手感调舒服、把性能压到位用户逛一圈下来觉得“像那么回事”这项目就算成了。