簡(jiǎn)介這是一份面向虛擬現(xiàn)實(shí)與增強(qiáng)現(xiàn)實(shí)開發(fā)初學(xué)者的虛擬展覽創(chuàng)建腳本案例系統(tǒng)覆蓋從項(xiàng)目初始化、場(chǎng)景搭建、交互功能開發(fā)到界面與音效設(shè)計(jì)、發(fā)布部署和后期維護(hù)的完整流程適合畢業(yè)設(shè)計(jì)、項(xiàng)目預(yù)研或產(chǎn)品原型驗(yàn)證。資源以單個(gè)文檔壓縮封裝包體僅21千字節(jié)內(nèi)容精煉但階段劃分清晰。文檔按六個(gè)模塊循序漸進(jìn)先配置主流開發(fā)引擎與必要軟件開發(fā)工具包再導(dǎo)入三維模型并布置燈光材質(zhì)隨后編寫頭部追蹤、手勢(shì)識(shí)別等交互邏輯并補(bǔ)充菜單、導(dǎo)航等界面設(shè)計(jì)及音效加入方法。每個(gè)模塊均寫明目的、步驟和注意事項(xiàng)便于直接對(duì)照?qǐng)?zhí)行。文檔還提出建模、貼圖、音頻處理等擴(kuò)展工具建議以及延遲加載、細(xì)節(jié)層次技術(shù)、多平臺(tái)兼容性驗(yàn)證等優(yōu)化思路幫助開發(fā)者規(guī)避常見問題高效構(gòu)建沉浸式虛擬展覽項(xiàng)目。目前已有802人學(xué)習(xí)下載適合需要開發(fā)清單或流程參考的讀者。1. 這個(gè)項(xiàng)目解決什么問題把虛擬展覽從需求文檔變成可上機(jī)演示的腳本框架策展方拿著一張展品清單找到你要求在兩周內(nèi)把一個(gè)線下展覽同步搬到 VR 空間里。這類活兒的難點(diǎn)從來不是「場(chǎng)景漂不漂亮」而是「交互能不能撐住現(xiàn)場(chǎng)體驗(yàn)」以及「這趟流程可不可復(fù)現(xiàn)」。這份 VR/AR 開發(fā)腳本案例就是按 Unity/Unreal 的常規(guī)開發(fā)鏈路把「初始化 → 場(chǎng)景搭建 → 交互功能 → UI/音效 → 發(fā)布部署 → 后期維護(hù)」拆成一份可執(zhí)行腳本該裝哪些 VR/AR 軟件與插件、交互腳本怎么寫、性能怎么兜底每一步都能直接對(duì)照落地。適合要做原型驗(yàn)證的開發(fā)者也適合帶新人走通第一遍 VR 項(xiàng)目全流程。它是流程框架不是某個(gè)商業(yè)項(xiàng)目的源碼所以二次開發(fā)空間足夠大——你可以把它當(dāng)成虛擬展覽項(xiàng)目的「第一版骨架」再根據(jù)自己的場(chǎng)地、展品和交互需求去長(zhǎng)肉。2. 初始化與工程結(jié)構(gòu)Unity 項(xiàng)目參數(shù)、文件夾分工和 SDK 裝配2.1 項(xiàng)目文件夾與 Unity 工程創(chuàng)建腳本要求先建一個(gè)項(xiàng)目文件夾這一步別隨手起名。我一般按「項(xiàng)目簡(jiǎn)稱 目標(biāo)平臺(tái)」組織例如VirtualExhibit_PCVR或VirtualExhibit_Quest好處是后續(xù)構(gòu)建產(chǎn)物、日志和文檔歸檔時(shí)不會(huì)在一堆NewProject(3)里迷失。文件夾層級(jí)建議直接對(duì)齊 Unity 工程的 Assets 目錄省得后面移動(dòng)資源導(dǎo)致引用丟失VirtualExhibit/ ├─ Assets/ │ ├─ Scenes/ // 主展廳、開場(chǎng)、加載場(chǎng)景 │ ├─ Models/ // FBX/OBJ 展品、展廳墻體、展臺(tái) │ ├─ Scripts/ // 交互、UI、音效控制腳本 │ ├─ Prefabs/ // 展品預(yù)制體、射線交互器、UI 面板 │ ├─ Materials/ // 展品材質(zhì)、展廳地面與墻面材質(zhì) │ ├─ Audio/ // BGM、環(huán)境音、交互提示音 │ └─ Resources/ // 動(dòng)態(tài)加載的展品數(shù)據(jù)或配置 ├─ Packages/ └─ ProjectSettings/創(chuàng)建 Unity 工程時(shí)選 3D 模板即可URP 還是內(nèi)置管線看目標(biāo)設(shè)備。一體化頭顯建議直接選 URPUniversal Render Pipeline移動(dòng)端 GPU 壓力小后處理效果也夠用PC VR 想省事用內(nèi)置管線也行但后期加霧效、體積光會(huì)吃力。這個(gè)選擇在工程創(chuàng)建階段就要定因?yàn)楣芫€切換涉及材質(zhì)重映射半路換管線容易翻車。2.2 項(xiàng)目參數(shù)設(shè)置分辨率、幀率與渲染質(zhì)量腳本里提到的分辨率、幀率設(shè)置在 Unity 中有兩層一層是 Player Settings 里的默認(rèn)設(shè)置另一層是運(yùn)行時(shí)通過代碼強(qiáng)制覆蓋。虛擬展覽這種場(chǎng)景展品多、材質(zhì)復(fù)雜經(jīng)常出現(xiàn)「編輯器里流暢打包后掉幀」的情況所以運(yùn)行時(shí)的幀率控制比編輯器里的勾選項(xiàng)更重要。using UnityEngine; public class ProjectBootstrapper : MonoBehaviour { [Header(性能目標(biāo))] [SerializeField] private int targetFrameRate 60; [SerializeField] private int vsyncCount 1; private void Awake() { // 強(qiáng)制鎖定幀率避免部分設(shè)備默認(rèn)跑 30fps Application.targetFrameRate targetFrameRate; QualitySettings.vSyncCount vsyncCount; // 固定渲染分辨率策略像素密度模式適配不同頭顯 // 例如 1.0 表示按設(shè)備原生分辨率渲染1.25 則超采樣 XRSettings.eyeTextureResolutionScale 1.0f; } }這段腳本放在場(chǎng)景第一個(gè)加載的對(duì)象上Awake 階段就把運(yùn)行參數(shù)釘死。targetFrameRate建議一體機(jī)設(shè) 60PC VR 可視性能設(shè) 72 或 90eyeTextureResolutionScale是 VR 里最影響觀感的參數(shù)之一調(diào)太高會(huì)掉幀調(diào)太低字體會(huì)糊。虛擬展覽里有大量文字說明牌這個(gè)值我一般不低于 1.0。畫質(zhì)等級(jí)和陰影距離這類我習(xí)慣在 Start 里用QualitySettings再覆蓋一遍特別是發(fā)布到不同設(shè)備時(shí)確保低端設(shè)備自動(dòng)降級(jí)——但注意不要讓陰影距離低于 20 米否則展品沒有接觸陰影視覺上會(huì)「飄」在展臺(tái)上。2.3 SDK 與插件裝配XR Plug-in 與交互框架腳本提到的 SDK 和插件裝配在 Unity 2019 之后統(tǒng)一走 XR Plug-in Management。安裝流程Window → Package Manager → 搜索 XR Plug-in Management安裝后到 Project Settings → XR Plug-in Management 里勾選目標(biāo) SDK 的 Provider。PC VR 一般勾 OpenXR一體機(jī)勾對(duì)應(yīng)廠商的 Provider。這里有一個(gè)常見誤區(qū)裝了 OpenXR 不代表交互功能自動(dòng)能用還需要把交互邏輯層接到 OpenXR 的 Input Feature 上。交互框架我推薦優(yōu)先用 XR Interaction ToolkitXRI。它是 Package Manager 里直接搜到的官方交互工具包提供射線交互器、抓取邏輯、傳送機(jī)制比手寫射線懸停判斷省力得多。腳本里的「頭部追蹤、手勢(shì)識(shí)別」需求在 XRI 里對(duì)應(yīng) Tracked Device 的一個(gè)個(gè) Action Map頭部追蹤基本不用寫代碼手柄扳機(jī)映射到交互事件就行。手勢(shì)識(shí)別也分兩層簡(jiǎn)單的捏合、指向用 XRI 內(nèi)置的 Select/Grip 動(dòng)作復(fù)雜的 5 指手勢(shì)才需要額外接入手部追蹤 SDK。做虛擬展覽捏合抓取和射線點(diǎn)擊已經(jīng)覆蓋九成交互場(chǎng)景手勢(shì)識(shí)別可以先不做。提示如果只是做 PC VR 快速演示不裝廠商 SDK只用 OpenXR XRI 鼠標(biāo)模擬也能跑通但發(fā)布會(huì)前一定要換到目標(biāo)設(shè)備的 Provider 做真機(jī)驗(yàn)證。3. 場(chǎng)景搭建與交互核心從導(dǎo)入 FBX 到 C# 腳本拾取展品3.1 場(chǎng)景布置展品模型導(dǎo)入與預(yù)制體虛擬展覽的場(chǎng)景搭建本質(zhì)是「展品 展臺(tái) 空間動(dòng)線」三件事。腳本要求導(dǎo)入 3D 模型并調(diào)整位置大小方向?qū)嶋H操作中我建議給每件展品做一層標(biāo)準(zhǔn)化處理模型統(tǒng)一放Models目錄單位統(tǒng)一為米中心點(diǎn)放在展品幾何中心朝向上保證正面朝向 Z 軸正方向。FBX 導(dǎo)入時(shí)Unity 的 Scale Factor 默認(rèn)可能把 1 米的模型變成 0.01導(dǎo)致展品小到看不見——這是虛擬展覽里最常見的「模型消失」原因。每件展品拖進(jìn)場(chǎng)景后先做一個(gè)預(yù)制體展品模型作為子物體父物體掛 Box Collider另外掛一個(gè)展品數(shù)據(jù)腳本記錄名稱、年代、簡(jiǎn)介、語(yǔ)音解說文件名。這樣后期展廳布展只需要拖預(yù)制體不用每次重新配碰撞體。展臺(tái)用簡(jiǎn)單的立方體改材質(zhì)就行不要給展臺(tái)加太復(fù)雜的碰撞體否則 VR 里人稍微靠近就會(huì)抖動(dòng)。3.2 核心交互邏輯射線拾取與展品信息查看交互功能是虛擬展覽的核心。用 XRI 的話攝像機(jī)上掛XRRayInteractor展品預(yù)制體上掛XRGrabInteractable可以快速獲得「抓起來看」的基礎(chǔ)能力。但展覽場(chǎng)景里常見的需求不是抓而是「對(duì)準(zhǔn)展品 → 顯示信息 → 播放語(yǔ)音」這層業(yè)務(wù)邏輯需要自己寫。下面的腳本就是按住扳機(jī)鍵對(duì)準(zhǔn)展品彈出信息面板的完整實(shí)現(xiàn)using UnityEngine; using UnityEngine.UI; using TMPro; public class ExhibitInfoRaycaster : MonoBehaviour { [Header(射線配置)] [SerializeField] private Transform rayOrigin; // 射線發(fā)射點(diǎn)右手控制器 [SerializeField] private float rayDistance 10f; [SerializeField] private LayerMask exhibitLayer; // 只檢測(cè)展品層避免 UI 擋住射線 [Header(UI 組件)] [SerializeField] private GameObject infoPanel; // 展品信息面板 [SerializeField] private TextMeshProUGUI titleText; [SerializeField] private TextMeshProUGUI descText; [SerializeField] private Button closeButton; private ExhibitItem currentTarget; private void Awake() { closeButton.onClick.AddListener(HideInfoPanel); } private void Update() { // 從控制器向前發(fā)射射線檢測(cè)展品 Ray ray new Ray(rayOrigin.position, rayOrigin.forward); if (Physics.Raycast(ray, out RaycastHit hit, rayDistance, exhibitLayer)) { ExhibitItem item hit.collider.GetComponentExhibitItem(); if (item ! null item ! currentTarget) { currentTarget item; ShowInfoPanel(item); } } else if (currentTarget ! null !IsRayStillHitting()) { // 射線移開展品時(shí)自動(dòng)隱藏避免面板殘留 HideInfoPanel(); currentTarget null; } } private void ShowInfoPanel(ExhibitItem item) { titleText.text item.exhibitName; descText.text item.description; infoPanel.SetActive(true); } private void HideInfoPanel() { infoPanel.SetActive(false); currentTarget null; } private bool IsRayStillHitting() { Ray ray new Ray(rayOrigin.position, rayOrigin.forward); return Physics.Raycast(ray, out RaycastHit hit, rayDistance, exhibitLayer); } }說明一下關(guān)鍵參數(shù)rayOrigin是射線起點(diǎn)PC VR 場(chǎng)景放在右手控制器的模型根部一體機(jī)放在手柄模型對(duì)應(yīng)位置exhibitLayer需要你在 Unity Layer 里單獨(dú)建一層「Exhibit」防止射線打中地板、墻體和 UI 面板導(dǎo)致誤觸發(fā)。Update里我每幀發(fā)兩次射線一次用于展示信息一次用于判斷射線是否移開性能開銷略大但對(duì)展品數(shù)量 50 件以內(nèi)的場(chǎng)景完全夠用——如果展品上千件就把 Raycast 改成僅在扳機(jī)按下時(shí)執(zhí)行。3.3 頭部追蹤與瀏覽動(dòng)線補(bǔ)全腳本里的「頭部追蹤」在展覽場(chǎng)景中通常指用戶在展廳里轉(zhuǎn)頭看展品系統(tǒng)能判斷用戶在關(guān)注哪件展品并觸發(fā)對(duì)應(yīng)的音效或燈光。這個(gè)用Camera的前向方向和展品位置夾角就能實(shí)現(xiàn)夾角小于 20° 且距離小于 5 米時(shí)判定為「正在注視」。public class HeadGazeDetector : MonoBehaviour { [SerializeField] private Transform headCamera; [SerializeField] private LayerMask exhibitLayer; [SerializeField] private float gazeAngleThreshold 20f; [SerializeField] private float gazeRange 5f; private void Update() { Collider[] exhibits Physics.OverlapSphere(headCamera.position, gazeRange, exhibitLayer); foreach (Collider collider in exhibits) { Vector3 directionToExhibit collider.transform.position - headCamera.position; float angle Vector3.Angle(headCamera.forward, directionToExhibit); if (angle gazeAngleThreshold) { // 觸發(fā)展品注視事件播放語(yǔ)音或高亮燈光 collider.GetComponentExhibitItem()?.OnHeadGazeEnter(); } } } }這個(gè)腳本適合解鎖「走近某件展品自動(dòng)播放語(yǔ)音」的需求。gazeAngleThreshold和gazeRange是體驗(yàn)手感的關(guān)鍵角度太大會(huì)誤觸發(fā)太小則用戶要湊很近才生效。我一般調(diào)成 20° 和 3~4 米語(yǔ)音延遲 0.5 秒播放避免用戶路過時(shí)突然出聲嚇一跳。注意OnHeadGazeEnter里要做一次「已觸發(fā)」標(biāo)記用戶離開后再進(jìn)入時(shí)才重新播放這個(gè)狀態(tài)字段放在ExhibitItem腳本里管理。4. UI 與音效設(shè)計(jì)讓虛擬展覽不只是「看得見」還「聽得見」4.1 UI 界面組織Canvas 放在哪里才不眩暈虛擬展覽的 UI 和普通 App UI 有個(gè)本質(zhì)區(qū)別普通 UI 貼在屏幕上VR UI 必須放在世界空間里否則用戶轉(zhuǎn)頭時(shí)菜單跟著飄馬上會(huì)暈。腳本提到的菜單和導(dǎo)航我用兩層 UI 解決一層是固定在左手腕的「隨身菜單」一層是展品旁邊的「信息牌」。隨身菜單的做法創(chuàng)建一個(gè) World Space 類型的 Canvas放在左手控制器模型前方 0.3 米處跟隨控制器移動(dòng)但不跟隨旋轉(zhuǎn)——這樣用戶左手抬起就能看到菜單低頭時(shí)菜單不會(huì)擋住視線。信息牌則掛在展品預(yù)制體上初始 SetActive(false)射線對(duì)準(zhǔn)時(shí)激活。字體大小注意VR 中 UI 文字高度低于 0.02 米基本就看不清了信息牌的字號(hào)至少設(shè)到 0.03~0.04 米這是體驗(yàn)的底層保障。UI 的事件響應(yīng)不要用 Canvas 默認(rèn)的 Graphic Raycaster 鼠標(biāo)事件在 VR 里不靠譜。統(tǒng)一用XRUIInputModuleXRI 自帶把控制器射線轉(zhuǎn)成 UI 懸停和點(diǎn)擊事件或者干脆像我 3.2 節(jié)那樣用物理射線檢測(cè)觸發(fā) UI 顯示按鈕點(diǎn)擊用 OnClick 事件。兩種方式按需選記住原則UI 響應(yīng)鏈路越短越不容易出現(xiàn)點(diǎn)擊沒反應(yīng)的尷尬。4.2 音效設(shè)計(jì)空間音頻與音量分層虛擬展覽的音效有三個(gè)層次背景音樂、環(huán)境音效、交互提示音。背景音樂用平面 AudioSource掛在主攝像機(jī)上2D 播放環(huán)境音展廳人聲、空調(diào)聲用 3D AudioSource 放在展廳四角展品解說語(yǔ)音則放在展品模型上用戶走進(jìn)才觸發(fā)。關(guān)鍵一個(gè)坑Unity 默認(rèn) AudioSource 的 Spatial Blend 是 0純 2D你以為掛了 3D 音效喇叭實(shí)際用戶走近走遠(yuǎn)音量毫無變化。所以每個(gè)展品的 AudioSource 必須把 Spatial Blend 拉到 1并設(shè)置Min Distance和Max Distanceprivate void SetupAudio(AudioSource source, AudioClip clip, float minDistance, float maxDistance) { source.clip clip; source.spatialBlend 1f; // 02D 音效13D 空間音效 source.minDistance minDistance; // 1米內(nèi)音量恒定 source.maxDistance maxDistance; // 超過8米音量衰減到0 source.rolloffMode AudioRolloffMode.Logarithmic; source.playOnAwake false; }minDistance我一般設(shè) 1~1.5 米用戶站在展品正前方聽語(yǔ)音最清晰maxDistance設(shè) 6~8 米走出這個(gè)范圍語(yǔ)音應(yīng)該被環(huán)境音蓋過。注意如果多個(gè)展品同時(shí)觸發(fā)語(yǔ)音展廳會(huì)變成菜市場(chǎng)需要在全局做一個(gè)「語(yǔ)音單例」同一時(shí)間只允許一個(gè)展品播放解說新的觸發(fā)會(huì)自動(dòng)暫停舊的。4.3 事件驅(qū)動(dòng)UI、音效與交互腳本解耦展會(huì)項(xiàng)目的需求變化非?？旖裉旒右粋€(gè)臨時(shí)展品明天改語(yǔ)音文案。如果把 UI 顯示和音效播放都硬寫在交互腳本里每次改動(dòng)都要翻代碼。我習(xí)慣用 C# 事件或 UnityEvent 做解耦public class ExhibitItem : MonoBehaviour { [SerializeField] private string exhibitName; [TextArea] [SerializeField] private string description; public UnityEventExhibitItem OnHeadGazeEnter; public UnityEventExhibitItem OnRaycastSelected; public void Select() { OnRaycastSelected?.Invoke(this); } public void HeadGazeEnter() { OnHeadGazeEnter?.Invoke(this); } }在編輯器的 Inspector 里把 UI 信息面板的顯示邏輯掛到OnRaycastSelected事件上把語(yǔ)音播放掛到OnHeadGazeEnter事件上展品腳本自身完全不關(guān)心 UI 和音效細(xì)節(jié)。新增展品時(shí)復(fù)制預(yù)制體、改文本、拖事件不用改一行代碼。這是虛擬展覽項(xiàng)目后期維護(hù)速度的關(guān)鍵——展品數(shù)據(jù)在變交互邏輯穩(wěn)定不變事件驅(qū)動(dòng)恰好承接這個(gè)節(jié)奏。5. 避坑記錄虛擬展覽從開發(fā)到上機(jī)的 5 個(gè)高頻問題5.1 幀率不穩(wěn)設(shè)置填了 60fps 還是掉幀現(xiàn)象Unity 編輯器里跑到 120fps 毫無壓力打包到一體機(jī)后頻繁掉到 40fps 左右畫面明顯卡頓轉(zhuǎn)頭時(shí)畫面撕裂。原因一體機(jī) GPU 性能有限幀率上不去的真正瓶頸在渲染管線和 Draw Call。只把Application.targetFrameRate設(shè)為 60 沒用渲染開銷不支持就等于空設(shè)。解決先開啟 Profiler 看 GPU 耗時(shí)最常見的問題有三個(gè)——場(chǎng)景燈光用了多個(gè)實(shí)時(shí)實(shí)時(shí)光源、展品材質(zhì)沒用 Atlasing合批、模型面數(shù)超標(biāo)。展品數(shù)量多時(shí)把光源數(shù)量壓到 1 個(gè)方向光其余用烘焙光照貼圖同材質(zhì)展品圖片合并到一張 Atlas 貼圖上模型在建模階段做 LOD距離遠(yuǎn)了自動(dòng)切換低精度模型。這幾步做完一體機(jī)幀率一般能回到 60。5.2 模型穿模與尺寸玄學(xué)現(xiàn)象導(dǎo)入的展品模型在 Scene 視圖里只有芝麻大或者比展廳還大運(yùn)行時(shí)用戶可以穿墻、穿展臺(tái)身體模型卡進(jìn)門里。原因FBX 模型的單位設(shè)置不一致。Maya 默認(rèn)單位是厘米Unity 用米導(dǎo)入時(shí) Scale Factor 沒換算導(dǎo)致尺寸差 100 倍碰撞體只掛在展品模型上沒掛在展臺(tái)等大件結(jié)構(gòu)上。解決FBX 導(dǎo)入設(shè)置里確認(rèn) File Scale 正確后統(tǒng)一點(diǎn)擊 Apply所有大件場(chǎng)景物件墻、展臺(tái)、地板至少掛一個(gè)簡(jiǎn)化碰撞體不建議直接用原始模型 Mesh Collider用立方體碰撞體拼接更省性能。用戶穿模問題在做展廳空間設(shè)計(jì)時(shí)就要預(yù)留動(dòng)線寬度VR 用戶比坐著玩游戲的人活動(dòng)范圍大得多過道寬度至少 1.2 米。5.3 交互腳本拿到空引用運(yùn)行時(shí)直接斷邏輯現(xiàn)象按扳機(jī)對(duì)準(zhǔn)展品信息面板沒彈出來Console 報(bào)NullReferenceException: ExhibitInfoRaycaster.currentTarget或者射線完全沒反應(yīng)。原因Inspector 里的引用字段沒拖正確。最常見的是exhibitLayer沒在 Layer 里創(chuàng)建Physics.Raycast的 LayerMask 結(jié)果為 0射線永遠(yuǎn)打不中任何東西還有rayOrigin忘了拖到手柄模型上導(dǎo)致射線從世界原點(diǎn)發(fā)射。解決寫交互腳本前先在 Project Settings 里把 Layer 建好命名與腳本序列化字段完全一致引用字段盡量用[HideInInspector]私有化只保留必要的配置項(xiàng)。養(yǎng)成一個(gè)習(xí)慣——腳本掛上去第一件事把所有SerializeField字段在 Inspector 里檢查一遍再進(jìn) Play Mode。這類問題 Debug 起來很快但排查時(shí)間往往比寫代碼還長(zhǎng)。5.4 空間音效失效走近展品聽不出聲音變化現(xiàn)象展品解說雖然會(huì)播放但用戶走到展廳另一頭還能聽得一清二楚或者站在展品面前音量也不變大毫無方向感。原因AudioSource 的spatialBlend默認(rèn)為 0標(biāo)識(shí)為 2D 音效或者Clip是先加載后賦值編輯器里看不到運(yùn)行時(shí)賦值成功但參數(shù)全用默認(rèn)值。解決按 4.2 節(jié)的設(shè)置把spatialBlend拉滿并確認(rèn)AudioListener掛在了主攝像機(jī) Rig 上而不是普通子節(jié)點(diǎn)。還要注意展品預(yù)制體里的 AudioSource 的Play On Awake必須關(guān)掉否則場(chǎng)景一加載所有解說同時(shí)觸發(fā)又變成一個(gè)音效事故。5.5 發(fā)布到目標(biāo)設(shè)備后交互行為與編輯器不一致現(xiàn)象PC 端正常的手柄抓取打包到一體機(jī)后按鍵失靈或者一體機(jī)上能跑的版本接 PC VR 設(shè)備設(shè)備時(shí)追蹤方向顛倒。原因不同設(shè)備平臺(tái)的輸入映射不同。XRI 的綁定配置文件Input Action Assets默認(rèn)按 OpenXR 標(biāo)準(zhǔn)走但一體機(jī)廠商的 SDK 對(duì)扳機(jī)鍵、抓取鍵的映射有差異。發(fā)布到新平臺(tái)前沒重新檢查綁定。解決發(fā)布前做一次「輸入映射核對(duì)」專項(xiàng)驗(yàn)證重點(diǎn)驗(yàn)證四件事扳機(jī)射線、抓取交互、菜單開關(guān)、傳送移動(dòng)。準(zhǔn)備工作做在前在 XRI 的 Input Action 編輯器中按目標(biāo)平臺(tái)的設(shè)備導(dǎo)入預(yù)設(shè)綁定模板每個(gè)平臺(tái)打一個(gè)測(cè)試包覆蓋進(jìn)入場(chǎng)景、打開菜單、拾取展品、退出四個(gè)動(dòng)作的完整操作鏈路?？缙脚_(tái)項(xiàng)目我常年備著一個(gè)清單發(fā)布前逐項(xiàng)勾完再提交能擋掉八成現(xiàn)場(chǎng) bug。6. 發(fā)布部署與二次開發(fā)從構(gòu)建應(yīng)用到擴(kuò)展成可配置的虛擬展廳6.1 構(gòu)建流程與性能末檢構(gòu)建前先做三件事切到 Release 配置、確認(rèn) Player Settings 里的包名和版本號(hào)、關(guān)閉編輯器中的開發(fā)模式勾選。VR 項(xiàng)目還要額外確認(rèn)XRSettings在目標(biāo)設(shè)備上啟用了對(duì)應(yīng) Provider。構(gòu)建時(shí)打開 Build Report 看一眼包體大小如果超過預(yù)期優(yōu)先排查 Resources 目錄里是否混進(jìn)了沒用的貼圖和音頻。構(gòu)建完成后別急著發(fā)版先在真機(jī)上完整走一遍「進(jìn)入展廳 → 看展品 → 播語(yǔ)音 → 打開菜單」的流程手機(jī)端 VR 和 PC VR 各測(cè)一次。6.2 二次開發(fā)方向把展品列表變成數(shù)據(jù)驅(qū)動(dòng)腳本框架最有價(jià)值的改造點(diǎn)是把展品從「場(chǎng)景里的預(yù)制體」變成「配置表驅(qū)動(dòng)」。我在第二次迭代時(shí)做的是寫一個(gè) JSON 展品配置清單運(yùn)行時(shí)動(dòng)態(tài)生成展品信息牌場(chǎng)景里只保留展臺(tái)和初始展品位置。{ exhibits: [ { id: EX-001, name: 青花瓷瓶, modelPath: Models/CeramicVase, description: 元代青花瓷高約 30 厘米釉色溫潤(rùn)。, audioPath: Audio/EX-001_voice, highlightColor: #2E5F8A } ] }改造步驟很簡(jiǎn)單把ExhibitItem的數(shù)據(jù)字段改成從 JSON 讀取模型路徑用Resources.Load動(dòng)態(tài)加載場(chǎng)景布置時(shí)只放一個(gè)空的「展品錨點(diǎn)」運(yùn)行時(shí)按配置實(shí)例化。這樣一來策展方要換展品只需要改 JSON 和放模型資源完全不用碰場(chǎng)景文件。這套做法也方便后期接入遠(yuǎn)程內(nèi)容更新——把 JSON 放在服務(wù)器上應(yīng)用啟動(dòng)時(shí)拉取一次展覽內(nèi)容每天換都可以。踩過的教訓(xùn)是動(dòng)態(tài)加載模型的尋徑邏輯第一次寫時(shí)我直接用完整路徑拼接小寫沒對(duì)上報(bào)錯(cuò)后來統(tǒng)一約定模型路徑全部小寫、空格用下劃線從那以后每次加展品都強(qiáng)制走一遍「JSON 校驗(yàn) → 加載路徑檢查 → 真機(jī)驗(yàn)證」三個(gè)環(huán)節(jié)。這份腳本給我最大的價(jià)值不是代碼本身而是逼我在動(dòng)手之前就把整個(gè)虛擬展覽的開發(fā)流理想清楚了——資源怎么組織、交互怎么解耦、性能怎么兜底每一步都有章法。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取