简介这份资源是一份面向VR/AR初学者与独立开发者的脚本案例文档围绕「创建虚拟展览体验」这一典型项目给出从项目初始化、场景搭建、交互功能开发到UI音效设计、发布部署及后期维护的完整流程框架帮助读者快速理清沉浸式展览应用的开发脉络。资源包内共1个doc文件约21KB以文字脚本形式分模块梳理各阶段要点便于对照查阅与二次扩展。目前已有801人学习下载适合作为入门参考或项目启动前的思路清单。读者可从中获得开发环境配置、3D模型导入与优化、头部追踪与手势识别等交互逻辑编写、性能与兼容性测试等关键环节的实践指引并了解3D建模、纹理编辑、音频处理等配套工具的衔接方式为构建具有交互性与沉浸感的虚拟展览体验提供可落地的起步方案。1. 虚拟展览不是把模型拖进场景就完事很多人第一次做 VR/AR 虚拟展览脑子里想的都是“把展品模型拖进引擎加个相机打包就完事”。真上手才发现观众戴上头显后第一句话往往是“怎么这么晕”“我该往哪走”“这个展品怎么点不动”。虚拟展览体验的核心从来不是模型精度而是空间引导、交互反馈和性能预算这三件事的平衡。这个方向适合已经会基础引擎操作、想从“能跑”跨到“能看”的开发者也适合做数字展厅、线上博物馆、教学演示的团队。下面我按一个可复现的最小展览场景把脚本结构、参数设置和踩过的坑讲清楚你照着搭一遍基本能拿到一个能站人、能看展、能交互的 VR/AR 展览原型。2. 先定展览骨架场景分区与交互脚本怎么拆2.1 为什么虚拟展览要先做“动线”再做模型虚拟展览和普通 3D 场景最大的区别是观众是带着“看展”预期进来的不是来自由探索的。没有动线人会在原地转圈或者直接穿墙走到展品背后。常见做法是把展览空间拆成三个区入口引导区、主展区、互动体验区。入口区放一个地面箭头或光带主展区按展品数量排成环形或直线互动区留出至少 2 米乘 2 米的空地给手势或手柄操作。脚本层面动线不是靠导航网格自动寻路而是靠触发器和视觉引导。我一般会在入口放一个ExhibitionManager脚本负责记录观众当前位置、当前展品索引和交互状态。这个脚本不直接控制移动只做状态分发移动还是交给头显或手柄的传送机制。这样拆的好处是后面换展品、改布局不用动移动逻辑。2.2 用脚本管理展品状态一个最小可用的 ExhibitionManager下面这段是 Unity C# 脚本挂在场景根节点上。它做三件事注册展品、切换当前展品、广播交互事件。代码里用ListExhibitItem存展品每个展品是一个带碰撞体的 GameObject挂ExhibitItem组件。using System.Collections.Generic; using UnityEngine; using UnityEngine.Events; public class ExhibitionManager : MonoBehaviour { [Header(展品列表按动线顺序拖入)] public ListExhibitItem exhibits new ListExhibitItem(); [Header(当前展品索引只读)] public int currentIndex 0; // 展品切换时广播UI 和音频监听这个事件 public UnityEventExhibitItem onExhibitChanged; void Start() { // 初始化时把所有展品设为未选中只激活第一个 for (int i 0; i exhibits.Count; i) { exhibits[i].SetActiveState(i 0); } if (exhibits.Count 0) { onExhibitChanged.Invoke(exhibits[0]); } } // 由触发器或手柄射线调用切换到指定索引 public void SwitchTo(int index) { if (index 0 || index exhibits.Count) return; exhibits[currentIndex].SetActiveState(false); currentIndex index; exhibits[currentIndex].SetActiveState(true); onExhibitChanged.Invoke(exhibits[currentIndex]); } // 下一个展品环形切换 public void Next() { int next (currentIndex 1) % exhibits.Count; SwitchTo(next); } }逻辑说明Start里把所有展品设为未选中只激活第一个避免一开始所有展品的高亮和音效同时触发。SwitchTo先关旧再开新保证同一时间只有一个展品处于激活状态。onExhibitChanged用 UnityEvent 而不是直接引用 UI是为了让 UI、音频、手柄震动各自监听互不耦合。参数说明exhibits列表的顺序就是动线顺序拖入时按入口到出口排。currentIndex只读不要在 Inspector 里手动改否则会和内部状态不一致。如果展品数量超过 20 个建议把List换成数组加索引减少 GC 压力。2.3 展品交互脚本射线、手柄和手势怎么统一VR/AR 展览的交互入口通常有三个手柄射线、手势捏合、视线停留。如果每个展品单独写一套后期改交互方式会疯掉。我一般做一个ExhibitItem组件只负责“被选中”和“被激活”两个状态具体用什么输入由InteractionAdapter决定。using UnityEngine; public class ExhibitItem : MonoBehaviour { [Header(展品名称用于 UI 显示)] public string exhibitName; [Header(选中时的高亮对象)] public GameObject highlightObject; [Header(激活时播放的音频)] public AudioSource audioSource; private bool isActive false; // 由 ExhibitionManager 调用设置激活状态 public void SetActiveState(bool active) { isActive active; if (highlightObject ! null) highlightObject.SetActive(active); if (audioSource ! null) { if (active) audioSource.Play(); else audioSource.Stop(); } } // 由交互适配器调用表示这个展品被点中了 public void OnSelect() { // 这里不直接切换而是通知 Manager FindObjectOfTypeExhibitionManager().SwitchTo( FindObjectOfTypeExhibitionManager().exhibits.IndexOf(this) ); } }逻辑说明SetActiveState只控制高亮和音频不控制显隐因为展品模型本身要一直可见只是高亮不同。OnSelect里用FindObjectOfType是为了减少引用配置实际项目里建议在Start里缓存 Manager 引用。参数说明highlightObject一般是一个比展品稍大的半透明包围盒或地面光圈不要用描边后处理VR 里描边容易引起眩晕。audioSource的spatialBlend设为 1让声音有方向感观众转头时能听出展品位置。3. 把展览跑起来相机、传送和性能参数怎么设3.1 VR 相机 rig 的三种配置和适用场景VR 展览的相机 rig 直接决定观众怎么移动。常见三种站桩式、传送式、平滑移动式。站桩式适合展品集中在一个小房间观众原地转头就能看全传送式适合大空间用射线指地面松手瞬移平滑移动式最容易晕除非是做漫游视频否则不建议在展览里用。我一般用传送式加一个“返回入口”按钮。传送脚本的核心是TeleportArea加TeleportPointerUnity XR Interaction Toolkit 里已经封装好了。你只需要在场景里铺TeleportationArea碰撞体把地面和展台周围都覆盖上观众指哪传哪。参数设置上传送射线的最大距离设 10 米超过 10 米观众会失去空间感。传送后的淡入淡出时间设 0.15 秒太短会闪太长会拖。相机近裁面设 0.05 米远裁面设 100 米展览场景一般不会超过这个范围。3.2 性能预算为什么你的展览在头显里掉帧虚拟展览最常见的翻车是在编辑器里跑 90 帧打包到头显里掉到 45 帧。原因通常是三个展品模型面数太高、实时光太多、后处理太重。面数控制上单个展品模型建议不超过 5 万三角面整个场景不超过 50 万。如果展品是扫描件先用 Blender 做减面保留轮廓和纹理细节靠法线贴图补。实时光方面展览场景最多一盏方向光加两盏点光其余用烘焙光照贴图。后处理里抗锯齿用 MSAA 4x不要用 FXAAFXAA 在 VR 里会糊。 bloom 和景深直接关掉这两个在 VR 里既费性能又容易晕。下面是一个性能检查脚本挂在相机上每 2 秒打印一次帧率和三角面数方便你在头显里实时看。using UnityEngine; public class PerformanceMonitor : MonoBehaviour { public float updateInterval 2.0f; private float accum 0; private int frames 0; private float timeLeft; void Start() { timeLeft updateInterval; } void Update() { timeLeft - Time.deltaTime; accum Time.timeScale / Time.deltaTime; frames; if (timeLeft 0.0f) { float fps accum / frames; int tris 0; foreach (MeshFilter mf in FindObjectsOfTypeMeshFilter()) { if (mf.sharedMesh ! null) tris mf.sharedMesh.triangles.Length / 3; } Debug.Log($FPS: {fps:F1}, Triangles: {tris}); timeLeft updateInterval; accum 0.0f; frames 0; } } }逻辑说明accum累加每帧的Time.timeScale / Time.deltaTime除以帧数得到平均 FPS。三角面数遍历所有MeshFilter把每个网格的三角形数加起来。这个脚本只在开发期用发布前删掉或禁用因为FindObjectsOfType每 2 秒跑一次本身有开销。参数说明updateInterval设 2 秒太短会刷屏太长看不到波动。如果场景里有大量动态生成的对象建议改成只统计相机视锥体内的MeshFilter减少遍历量。3.3 AR 模式下的平面检测与展品放置如果展览要兼顾 AR比如手机扫桌面放一个展品平面检测的参数要单独调。AR Foundation 里ARRaycastManager的射线检测频率默认是每帧建议改成每 3 帧一次省电。平面检测的planeDetectionMode设Horizontal就够垂直平面在展览里很少用。展品放置时不要直接放在检测到的平面原点而是放在射线命中点往法线方向偏移 0.01 米的位置避免模型和平面穿插。放置后的展品要加一个ARAnchor否则观众移动手机时展品会漂。4. 避坑与排查虚拟展览里最容易翻车的五件事4.1 观众一进场景就穿模掉到地板下面现象戴上头显后画面直接黑掉或者看到地板底面人一直在往下掉。原因相机 rig 的碰撞体没加或者传送目标点在地面以下。XR Interaction Toolkit 的XRRig默认没有刚体如果场景地面没有Collider相机就会一直下落。解决给XRRig加一个CharacterController高度设 1.6 米半径 0.3 米。地面和展台都加BoxCollider或MeshCollider。传送目标点用TeleportationArea而不是手动设坐标避免算错高度。4.2 展品高亮在头显里看起来像“鬼影”现象选中展品时高亮包围盒在左右眼位置不一致看起来有重影。原因高亮对象用了透明材质且没有开ZWriteVR 的双目渲染下透明排序会出问题。解决高亮材质换成不透明材质加Rim Light效果或者用ZWrite On的透明材质。如果一定要用透明把Render Queue设为Geometry1并且不要用Soft Particles。4.3 手柄射线点不中展品现象手柄射线明明指到了展品但按扳机没反应。原因展品的碰撞体太小或者射线检测的LayerMask没包含展品层。还有一种情况是展品被高亮对象挡住了高亮对象也有碰撞体。解决展品碰撞体至少比模型大 10%高亮对象取消Collider或设为Trigger。射线检测的LayerMask里加上Exhibit层并且把RaycastManager的maxDistance设到 15 米。4.4 展览打包后音频全变成单声道现象在编辑器里声音有方向打包到头显里所有声音都从正前方来。原因音频文件的Load Type设成了Decompress On Load且Spatial Blend被强制设成 0。VR 平台对音频通道数有限制超过 16 个音源会强制混音。解决音频文件Load Type改成StreamingSpatial Blend设 1。同时播放的音源不超过 8 个超出的用AudioMixer做优先级裁剪。4.5 传送后画面闪烁或黑屏一帧现象每次传送画面会闪一下黑或者有一帧看到场景外部。原因传送时相机位置瞬间变化但渲染没跟上或者淡入淡出面板的Canvas渲染模式设成了Screen Space - Overlay在 VR 里不显示。解决淡入淡出面板的Canvas改成World Space挂在相机前方 0.5 米处。传送前先淡出到黑等 0.1 秒再移动相机然后再淡入。不要用Screen Space - CameraVR 里会抖动。5. 进阶技巧用脚本批量生成展品布局和验证展览完整性5.1 按动线自动排布展品的脚本手动摆展品容易摆歪尤其是环形布局。下面这个脚本按数量和半径自动排布展品朝向圆心。using UnityEngine; [ExecuteInEditMode] public class CircularLayout : MonoBehaviour { [Header(要排布的展品按顺序拖入)] public Transform[] exhibits; [Header(环形半径单位米)] public float radius 5.0f; [Header(起始角度0 度在正前方)] public float startAngle 0f; void Update() { if (exhibits null || exhibits.Length 0) return; float angleStep 360f / exhibits.Length; for (int i 0; i exhibits.Length; i) { float angle startAngle i * angleStep; float rad angle * Mathf.Deg2Rad; Vector3 pos new Vector3( Mathf.Sin(rad) * radius, 0, Mathf.Cos(rad) * radius ); exhibits[i].position transform.position pos; // 朝向圆心 exhibits[i].LookAt(transform.position); } } }逻辑说明angleStep把 360 度均分给每个展品。Mathf.Sin和Mathf.Cos算圆周坐标LookAt让展品正面朝向圆心。ExecuteInEditMode让脚本在编辑器里也运行方便实时调半径。参数说明radius根据展品数量和大小调一般 3 到 8 米。startAngle设 0 时第一个展品在正前方设 90 时在右侧。如果展品数量是奇数建议startAngle设 0让第一个展品正对入口。5.2 展览完整性检查发布前跑一遍这个脚本发布前最怕漏掉引用或碰撞体。下面这个检查脚本遍历所有ExhibitItem检查名称、高亮对象、音频源和碰撞体是否齐全缺什么在 Console 里报出来。using UnityEngine; public class ExhibitionValidator : MonoBehaviour { [ContextMenu(验证展览完整性)] public void Validate() { ExhibitItem[] items FindObjectsOfTypeExhibitItem(); int errorCount 0; foreach (var item in items) { if (string.IsNullOrEmpty(item.exhibitName)) { Debug.LogError(${item.name} 缺少展品名称, item); errorCount; } if (item.highlightObject null) { Debug.LogError(${item.name} 缺少高亮对象, item); errorCount; } if (item.audioSource null) { Debug.LogWarning(${item.name} 没有音频源将静音, item); } if (item.GetComponentCollider() null) { Debug.LogError(${item.name} 缺少碰撞体无法交互, item); errorCount; } } Debug.Log($验证完成共 {items.Length} 个展品{errorCount} 个错误); } }逻辑说明ContextMenu让这个方法在 Inspector 右键菜单里能直接调用不用进播放模式。遍历所有ExhibitItem逐项检查必填字段。错误用Debug.LogError警告用Debug.LogWarning方便在 Console 里按级别过滤。参数说明这个脚本不需要运行时参数挂在场景根节点即可。如果展品数量超过 100 个建议把FindObjectsOfType换成FindObjectsByType并指定FindObjectsSortMode.None减少排序开销。5.3 一个我常犯的错忘了关掉编辑器的“自动保存”最后说一个血泪经验。做虚拟展览时我习惯在编辑器里直接拖展品位置然后按播放测试。有几次编辑器崩溃场景文件损坏半天的工作没了。后来我养成了一个习惯在Project Settings里把Auto Save关掉改成每 15 分钟手动CtrlS并且用 Git 做本地版本管理。虚拟展览场景文件通常很大Git 的LFS要提前配好否则仓库会爆。这个习惯看起来和脚本无关但能让你少一次后悔药。希望帮到你。本文还有配套的精品资源点击获取