简介这份资源是面向高校学生与Unity初学者的VR期末团队作业完整方案以HTC Vive为运行设备实现了一款限时射击水果的虚拟现实小游戏。玩家需用弓箭射落从地面升起、挂着不同水果的气球按水果种类计分玩法覆盖各年龄段可直接作为虚拟现实课程大作业或Unity VR入门练手项目。压缩包为zip格式整体约300.11MB内含Unity工程源码、导出的exe可执行文件、设计文档与演示视频源码便于二次修改exe可在HTC设备上直接运行验证设计文档与录屏则帮助理解场景搭建、交互逻辑与计分机制。该资源已在教室HTC设备上实测可正常运行目前已有2720人浏览学习适合需要完整赛题方案、可运行Demo与排错参考的团队参考借鉴。1. 从一份 Unity VR 射击水果作业说起为什么值得动手做如果你正在找一份能跑起来的 Unity VR 期末作业或者想用一套完整源码把「VR 交互 射击判定 打包 exe」这条链路走通那这个方向比想象中更值得投入。它不是一个只能看不能改的演示包而是一个把 XR 交互、物理碰撞、UI 计分、场景管理和 Windows 打包串起来的完整小项目。射击水果这个玩法本身门槛不高但恰好覆盖了 VR 开发里最容易翻车的几个点手柄射线怎么发、水果被击中后怎么碎、分数怎么同步到 UI、打包成 exe 后为什么手柄突然失灵。很多人第一次做 VR 作业卡的不是玩法设计而是环境配置和打包环节。这篇笔记就按「先跑通、再改懂、最后能讲清楚」的顺序把一套可复现的 Unity VR 射击水果方案拆开讲源码结构、关键参数、导出 exe 的注意点都会落到具体操作上。适合正在赶期末作业的学生也适合想快速验证 VR 交互原型的开发者。2. 环境搭起来Unity 版本、XR 插件与 Pico4 设备链路2.1 为什么优先选 Unity 2022 LTS XR Interaction Toolkit做 VR 项目版本选错后面全是玄学。我一般会锁定 Unity 2022.3 LTS原因是这个版本对 XR Interaction Toolkit 的支持最稳OpenXR 插件兼容性也好导出 Windows exe 时不容易出现手柄输入丢失。热词里提到的「unity安装」「unity下载」其实指向同一个问题装哪个版本。不要追最新 Tech 流期末作业求的是能跑、能打包、能演示。核心插件组合如下插件作用安装方式XR Interaction Toolkit提供射线、抓取、传送等交互组件Package Manager 搜索安装OpenXR Plugin统一各 VR 设备的运行时接口Package Manager 搜索安装XR Plugin Management管理不同平台的 XR 加载随 OpenXR 自动带入安装顺序建议先装 XR Plugin Management再装 OpenXR最后装 XR Interaction Toolkit。顺序反了容易出现 Input System 冲突表现是手柄按键全部无响应。2.2 从新建工程到 Pico4 能识别的最小配置新建 3D Core 工程后第一步不是急着拖模型而是把 XR 环境激活。打开 Edit Project Settings XR Plug-in Management勾选 OpenXR。然后在 OpenXR 的 Feature Groups 里确认 Interaction Profile 包含你用的手柄类型。Pico4 开发 Unity 时常见做法是安装 Pico 官方的 XR SDK但如果你只是做 Windows exe 演示用 OpenXR 通用链路也能跑通。# 如果你用命令行做 CI 构建可以用这段检查 XR 是否启用 # 在 Unity 工程根目录执行查看 ProjectSettings 里的 XR 配置 grep -r OpenXR ProjectSettings/ | head -20这段命令的作用是快速确认 OpenXR 是否已经写入工程配置。如果输出为空说明 XR 插件没启用成功需要回到 Editor 里重新勾选。参数上重点看ProjectSettings/XRPackageSettings.asset这个文件它记录了当前激活的 XR 加载器。接下来配置 Input System。XR Interaction Toolkit 的新版本默认依赖 Input System如果工程里还是旧 Input Manager手柄射线会拿不到值。在 Player Settings Active Input Handling 里选 Both 或 Input System Package。选 Both 最省事但打包体积会略大。2.3 场景里必须放的三件套XR Origin、交互管理器、射线一个能跑的最小 VR 场景层级里至少要有这三个对象XR Origin替代旧版 Camera Rig负责把头显和手柄的位置映射到场景里。XR Interaction Manager管理所有交互事件没有它射线打出去也没反应。Locomotion System如果你需要传送移动就挂上它纯站桩射击可以不加。XR Origin 下面会自动生成 Camera Offset、Main Camera、LeftHand Controller、RightHand Controller。检查 Main Camera 的 Tracked Pose Driver 是否绑定到 Center Eye。手柄控制器上要加 XR Controller 组件和 Input Action Manager。很多人到这里发现射线不出现八成是 Input Action Manager 没挂或者 Action Asset 没赋值。提示Pico4 通过串流助手连 Unity Editor 时如果手柄在 Scene 视图里不动先检查 OpenXR 的 Interaction Profile 是否勾选了 Pico 对应的手柄型号。没有官方 Profile 时选 Oculus Touch Controller Profile 通常也能兼容大部分按键。3. 射击水果的核心逻辑射线发射、命中判定与水果碎裂3.1 用 XR Ray Interactor 做射击射线的三个必调参数射击水果的「射击」本质是一条从手柄发出的射线命中水果后触发销毁和计分。XR Interaction Toolkit 自带 XR Ray Interactor但默认配置是抓取用的改成射击需要调三个地方。第一Ray Interactor 的 Line Type 选 Straight Line不要用 Projectile Curve。曲线适合传送直线才像枪口。第二Interaction Layer Mask 只勾选 Fruit 层避免射线打到地面或 UI。第三Max Time 设为 0表示射线常驻不需要按住才显示。// ShootRayController.cs // 挂载在手柄控制器上负责发射射线并处理命中 using UnityEngine; using UnityEngine.XR.Interaction.Toolkit; public class ShootRayController : MonoBehaviour { [SerializeField] private XRRayInteractor rayInteractor; [SerializeField] private InputActionProperty triggerAction; [SerializeField] private GameManager gameManager; private void OnEnable() { triggerAction.action.performed OnTriggerPressed; triggerAction.action.Enable(); } private void OnDisable() { triggerAction.action.performed - OnTriggerPressed; triggerAction.action.Disable(); } private void OnTriggerPressed(UnityEngine.InputSystem.InputAction.CallbackContext ctx) { // 用射线检测获取当前命中的第一个物体 if (rayInteractor.TryGetCurrent3DRaycastHit(out RaycastHit hit)) { FruitTarget fruit hit.collider.GetComponentFruitTarget(); if (fruit ! null) { fruit.OnHit(); gameManager.AddScore(fruit.scoreValue); } } } }这段代码的逻辑是监听扳机按键按下时从 XR Ray Interactor 取当前命中结果如果命中物体带 FruitTarget 组件就调用命中方法并加分。参数上rayInteractor必须在 Inspector 里拖入同一个物体上的 XR Ray Interactor 组件triggerAction绑定到 XR Controller 的 Activate ActiongameManager是场景里的计分管理器。容易翻车的点是TryGetCurrent3DRaycastHit在射线没命中任何东西时返回 false如果不做判空直接取 hit会报空引用。3.2 水果被击中后的碎裂粒子、音效与销毁时机水果碎裂不要直接 Destroy否则音效和粒子还没播完物体就没了。常见做法是命中后先禁用 Collider 和 Renderer播放粒子与音效延迟 0.5 秒再销毁。// FruitTarget.cs using UnityEngine; using System.Collections; public class FruitTarget : MonoBehaviour { public int scoreValue 10; [SerializeField] private GameObject sliceEffect; [SerializeField] private AudioClip hitSound; [SerializeField] private float destroyDelay 0.5f; private bool isHit false; public void OnHit() { if (isHit) return; // 防止一帧内多次触发 isHit true; GetComponentCollider().enabled false; GetComponentMeshRenderer().enabled false; if (sliceEffect ! null) Instantiate(sliceEffect, transform.position, Quaternion.identity); if (hitSound ! null) AudioSource.PlayClipAtPoint(hitSound, transform.position); StartCoroutine(DestroyAfterDelay()); } private IEnumerator DestroyAfterDelay() { yield return new WaitForSeconds(destroyDelay); Destroy(gameObject); } }isHit这个布尔量是血泪经验VR 里手柄抖动可能导致同一帧内射线多次命中不加锁会重复加分。destroyDelay默认 0.5 秒如果粒子时长是 1 秒就改成 1 秒。sliceEffect建议用 Unity 自带的 Particle System 做一个简单的球形扩散不要用太重的特效VR 里掉帧比画面丑更致命。3.3 计分 UI 与游戏循环从 ScriptableObject 到场景重开计分不要每个水果单独找 UI 文本用一个 GameManager 统一管理。分数变化时更新 UI达到目标分数后显示重开按钮。// GameManager.cs using UnityEngine; using TMPro; public class GameManager : MonoBehaviour { public static GameManager Instance; [SerializeField] private TextMeshProUGUI scoreText; [SerializeField] private GameObject restartPanel; [SerializeField] private int targetScore 100; private int currentScore 0; private void Awake() { Instance this; } public void AddScore(int value) { currentScore value; scoreText.text $Score: {currentScore}; if (currentScore targetScore) { restartPanel.SetActive(true); } } public void RestartGame() { UnityEngine.SceneManagement.SceneManager.LoadScene( UnityEngine.SceneManagement.SceneManager.GetActiveScene().buildIndex); } }targetScore设成 100 是给演示留余地水果分值 10 的话打中 10 个就结束。restartPanel是一个 World Space 的 Canvas挂在摄像机前方 2 米处VR 里不要用 Screen Space Overlay否则在头显里看不到。重开用LoadScene最稳不要手动重置每个水果的位置容易漏。4. 导出 exe 与真机演示打包设置、性能取舍与常见故障4.1 Windows exe 打包的五个关键设置导出 exe 是期末作业交付的硬指标。File Build Settings 里选 Windows x86_64然后重点检查这几项设置项推荐值原因Architecturex86_6464 位系统兼容Compression MethodLZ4HC加载快体积可接受Development Build演示时勾选方便看日志Script Debugging演示时勾选出错能定位Graphics APIDirect3D11VR 兼容性最好Graphics API 不要选 AutoAuto 在某些机器上会走 Vulkan导致头显画面撕裂。手动指定 Direct3D11 最稳。如果热词里提到的「vr渲染器切换cpu gpu模式」让你困惑在 Unity 里对应的是 Player Settings Rendering 下的 Graphics API 列表把 D3D11 拖到第一位即可。4.2 打包后手柄失灵的排查顺序打包 exe 后手柄没反应按这个顺序查确认 OpenXR Runtime 是否安装。Windows 上需要装对应的 OpenXR Runtime否则 exe 启动后找不到设备。检查 exe 是否以管理员权限运行。热词里「unity is running with administrator privileges」提示过这个坑某些设备在管理员权限下反而无法读取手柄输入。看 Player.log。路径在C:\Users\用户名\AppData\LocalLow\公司名\产品名\Player.log搜「XR」或「Input」关键字。# 快速查看 Player.log 里的 XR 相关报错 # Windows 下用 PowerShell Get-Content $env:LOCALAPPDATA\..\LocalLow\DefaultCompany\FruitShooter\Player.log | Select-String XR|Input|OpenXR这段命令帮你过滤日志里的 XR 和输入相关行。如果看到「No XR display subsystem found」说明 OpenXR Runtime 没装好如果看到「Input System is not enabled」说明打包时 Active Input Handling 选错了。4.3 性能优化VR 里必须守住的帧率底线VR 项目低于 72 帧就会晕射击水果虽然场景简单但粒子特效和实时阴影是两大杀手。我一般会做三件事关掉实时阴影改用烘焙、粒子最大数量限制在 50 以内、水果模型面数控制在 500 面以下。热词里的「unity游戏优化」在 VR 场景里优先级最高因为帧率直接决定可用性。在 Quality Settings 里把 Shadow Distance 设为 0 或很小值Anti Aliasing 用 2x 或 4x不要开 8x。如果用的是 Pico4 一体机模式还要在 Pico 开发者后台里把 CPU 和 GPU 等级调到最高否则默认会降频。5. 避坑与排查VR 射击水果作业里最容易翻车的五件事5.1 射线打不中水果但手柄明明有震动现象扣扳机手柄有震动反馈但水果不消失分数也不变。原因XR Ray Interactor 的 Interaction Layer Mask 没有勾选 Fruit 层或者水果的 Collider 被禁用。另一种可能是射线被手柄自身的 Collider 挡住射线起点在模型内部。解决把水果统一放到 Fruit 层Ray Interactor 的 Layer Mask 只勾 Fruit。手柄控制器的 Collider 设为 Ignore Raycast或者把射线起点偏移到手柄前方 0.1 米。5.2 打包后 UI 在头显里看不见现象Editor 里计分文本正常导出 exe 后头显里一片空白。原因Canvas 用了 Screen Space OverlayVR 渲染模式下 Overlay 不会显示在头显里。解决Canvas 的 Render Mode 改成 World Space缩放设为 0.01位置放在摄像机前方 2 米、视线下方 0.3 米处。TextMeshPro 的字体材质要选 Mobile 或 SDF不要用普通字体。5.3 水果被击中后重复加分现象打一个水果加了 30 分实际分值只有 10。原因射线在单帧内多次命中同一个 Collider或者水果的 OnHit 被多个脚本调用。解决在 FruitTarget 里加isHit布尔锁如 3.2 节代码所示。同时检查 XR Ray Interactor 的 Raycast Trigger Interaction 是否设为 Collide不要用 Overlap。5.4 导出 exe 时报错「Could not find OpenXR Runtime」现象Build 成功但双击 exe 弹出错误框提示找不到 OpenXR Runtime。原因目标机器没装 OpenXR Runtime或者 Runtime 版本与打包时不一致。解决在目标机器上安装对应头显的 OpenXR Runtime。如果是 Pico装 Pico 的串流助手和 XR Runtime如果是 Quest装 Oculus PC 客户端。演示前一定在目标机器上先跑一遍不要只在开发机上测。5.5 场景切换后手柄追踪丢失现象重开游戏后手柄位置卡住不动头显画面正常。原因LoadScene 后 XR Origin 重新实例化但 Input Action Asset 没有重新绑定。解决把 XR Origin 做成 Prefab重开时不要销毁它只重置水果和分数。或者用 DontDestroyOnLoad 保住 XR Origin场景里只加载游戏逻辑部分。6. 把作业变成能讲清楚的作品源码结构、演示视频与验收技巧一套能拿得出手的 VR 射击水果作业不只是 exe 能跑还要让人看懂你的设计。源码目录建议按功能分文件夹Scripts 放 C# 脚本Prefabs 放水果和特效Scenes 放主场景Materials 放材质Audio 放音效。设计文档不用写太长重点写清楚三个东西交互流程图、计分规则表、打包环境说明。演示视频控制在 2 分钟内开头 10 秒展示头显画面和手柄操作中间 60 秒打水果和计分最后 20 秒展示重开和打包后的 exe 运行画面。验收时老师常问的问题就几个射线怎么发射的、命中怎么判定、分数怎么同步、打包遇到什么问题。你如果能指着 ShootRayController 说清楚TryGetCurrent3DRaycastHit的返回值逻辑指着 FruitTarget 说清楚isHit锁的作用基本就稳了。我自己的习惯是每次打包前把 Player Settings 截图存档演示前 30 分钟在目标机器上完整跑一遍确认手柄、头显、音效都正常。这个习惯帮我省过至少三次现场翻车。希望帮到你。本文还有配套的精品资源点击获取 Unity VR射击水果作业实战：从XR交互到打包exe完整方案
简介这份资源是面向高校学生与Unity初学者的VR期末团队作业完整方案以HTC Vive为运行设备实现了一款限时射击水果的虚拟现实小游戏。玩家需用弓箭射落从地面升起、挂着不同水果的气球按水果种类计分玩法覆盖各年龄段可直接作为虚拟现实课程大作业或Unity VR入门练手项目。压缩包为zip格式整体约300.11MB内含Unity工程源码、导出的exe可执行文件、设计文档与演示视频源码便于二次修改exe可在HTC设备上直接运行验证设计文档与录屏则帮助理解场景搭建、交互逻辑与计分机制。该资源已在教室HTC设备上实测可正常运行目前已有2720人浏览学习适合需要完整赛题方案、可运行Demo与排错参考的团队参考借鉴。1. 从一份 Unity VR 射击水果作业说起为什么值得动手做如果你正在找一份能跑起来的 Unity VR 期末作业或者想用一套完整源码把「VR 交互 射击判定 打包 exe」这条链路走通那这个方向比想象中更值得投入。它不是一个只能看不能改的演示包而是一个把 XR 交互、物理碰撞、UI 计分、场景管理和 Windows 打包串起来的完整小项目。射击水果这个玩法本身门槛不高但恰好覆盖了 VR 开发里最容易翻车的几个点手柄射线怎么发、水果被击中后怎么碎、分数怎么同步到 UI、打包成 exe 后为什么手柄突然失灵。很多人第一次做 VR 作业卡的不是玩法设计而是环境配置和打包环节。这篇笔记就按「先跑通、再改懂、最后能讲清楚」的顺序把一套可复现的 Unity VR 射击水果方案拆开讲源码结构、关键参数、导出 exe 的注意点都会落到具体操作上。适合正在赶期末作业的学生也适合想快速验证 VR 交互原型的开发者。2. 环境搭起来Unity 版本、XR 插件与 Pico4 设备链路2.1 为什么优先选 Unity 2022 LTS XR Interaction Toolkit做 VR 项目版本选错后面全是玄学。我一般会锁定 Unity 2022.3 LTS原因是这个版本对 XR Interaction Toolkit 的支持最稳OpenXR 插件兼容性也好导出 Windows exe 时不容易出现手柄输入丢失。热词里提到的「unity安装」「unity下载」其实指向同一个问题装哪个版本。不要追最新 Tech 流期末作业求的是能跑、能打包、能演示。核心插件组合如下插件作用安装方式XR Interaction Toolkit提供射线、抓取、传送等交互组件Package Manager 搜索安装OpenXR Plugin统一各 VR 设备的运行时接口Package Manager 搜索安装XR Plugin Management管理不同平台的 XR 加载随 OpenXR 自动带入安装顺序建议先装 XR Plugin Management再装 OpenXR最后装 XR Interaction Toolkit。顺序反了容易出现 Input System 冲突表现是手柄按键全部无响应。2.2 从新建工程到 Pico4 能识别的最小配置新建 3D Core 工程后第一步不是急着拖模型而是把 XR 环境激活。打开 Edit Project Settings XR Plug-in Management勾选 OpenXR。然后在 OpenXR 的 Feature Groups 里确认 Interaction Profile 包含你用的手柄类型。Pico4 开发 Unity 时常见做法是安装 Pico 官方的 XR SDK但如果你只是做 Windows exe 演示用 OpenXR 通用链路也能跑通。# 如果你用命令行做 CI 构建可以用这段检查 XR 是否启用 # 在 Unity 工程根目录执行查看 ProjectSettings 里的 XR 配置 grep -r OpenXR ProjectSettings/ | head -20这段命令的作用是快速确认 OpenXR 是否已经写入工程配置。如果输出为空说明 XR 插件没启用成功需要回到 Editor 里重新勾选。参数上重点看ProjectSettings/XRPackageSettings.asset这个文件它记录了当前激活的 XR 加载器。接下来配置 Input System。XR Interaction Toolkit 的新版本默认依赖 Input System如果工程里还是旧 Input Manager手柄射线会拿不到值。在 Player Settings Active Input Handling 里选 Both 或 Input System Package。选 Both 最省事但打包体积会略大。2.3 场景里必须放的三件套XR Origin、交互管理器、射线一个能跑的最小 VR 场景层级里至少要有这三个对象XR Origin替代旧版 Camera Rig负责把头显和手柄的位置映射到场景里。XR Interaction Manager管理所有交互事件没有它射线打出去也没反应。Locomotion System如果你需要传送移动就挂上它纯站桩射击可以不加。XR Origin 下面会自动生成 Camera Offset、Main Camera、LeftHand Controller、RightHand Controller。检查 Main Camera 的 Tracked Pose Driver 是否绑定到 Center Eye。手柄控制器上要加 XR Controller 组件和 Input Action Manager。很多人到这里发现射线不出现八成是 Input Action Manager 没挂或者 Action Asset 没赋值。提示Pico4 通过串流助手连 Unity Editor 时如果手柄在 Scene 视图里不动先检查 OpenXR 的 Interaction Profile 是否勾选了 Pico 对应的手柄型号。没有官方 Profile 时选 Oculus Touch Controller Profile 通常也能兼容大部分按键。3. 射击水果的核心逻辑射线发射、命中判定与水果碎裂3.1 用 XR Ray Interactor 做射击射线的三个必调参数射击水果的「射击」本质是一条从手柄发出的射线命中水果后触发销毁和计分。XR Interaction Toolkit 自带 XR Ray Interactor但默认配置是抓取用的改成射击需要调三个地方。第一Ray Interactor 的 Line Type 选 Straight Line不要用 Projectile Curve。曲线适合传送直线才像枪口。第二Interaction Layer Mask 只勾选 Fruit 层避免射线打到地面或 UI。第三Max Time 设为 0表示射线常驻不需要按住才显示。// ShootRayController.cs // 挂载在手柄控制器上负责发射射线并处理命中 using UnityEngine; using UnityEngine.XR.Interaction.Toolkit; public class ShootRayController : MonoBehaviour { [SerializeField] private XRRayInteractor rayInteractor; [SerializeField] private InputActionProperty triggerAction; [SerializeField] private GameManager gameManager; private void OnEnable() { triggerAction.action.performed OnTriggerPressed; triggerAction.action.Enable(); } private void OnDisable() { triggerAction.action.performed - OnTriggerPressed; triggerAction.action.Disable(); } private void OnTriggerPressed(UnityEngine.InputSystem.InputAction.CallbackContext ctx) { // 用射线检测获取当前命中的第一个物体 if (rayInteractor.TryGetCurrent3DRaycastHit(out RaycastHit hit)) { FruitTarget fruit hit.collider.GetComponentFruitTarget(); if (fruit ! null) { fruit.OnHit(); gameManager.AddScore(fruit.scoreValue); } } } }这段代码的逻辑是监听扳机按键按下时从 XR Ray Interactor 取当前命中结果如果命中物体带 FruitTarget 组件就调用命中方法并加分。参数上rayInteractor必须在 Inspector 里拖入同一个物体上的 XR Ray Interactor 组件triggerAction绑定到 XR Controller 的 Activate ActiongameManager是场景里的计分管理器。容易翻车的点是TryGetCurrent3DRaycastHit在射线没命中任何东西时返回 false如果不做判空直接取 hit会报空引用。3.2 水果被击中后的碎裂粒子、音效与销毁时机水果碎裂不要直接 Destroy否则音效和粒子还没播完物体就没了。常见做法是命中后先禁用 Collider 和 Renderer播放粒子与音效延迟 0.5 秒再销毁。// FruitTarget.cs using UnityEngine; using System.Collections; public class FruitTarget : MonoBehaviour { public int scoreValue 10; [SerializeField] private GameObject sliceEffect; [SerializeField] private AudioClip hitSound; [SerializeField] private float destroyDelay 0.5f; private bool isHit false; public void OnHit() { if (isHit) return; // 防止一帧内多次触发 isHit true; GetComponentCollider().enabled false; GetComponentMeshRenderer().enabled false; if (sliceEffect ! null) Instantiate(sliceEffect, transform.position, Quaternion.identity); if (hitSound ! null) AudioSource.PlayClipAtPoint(hitSound, transform.position); StartCoroutine(DestroyAfterDelay()); } private IEnumerator DestroyAfterDelay() { yield return new WaitForSeconds(destroyDelay); Destroy(gameObject); } }isHit这个布尔量是血泪经验VR 里手柄抖动可能导致同一帧内射线多次命中不加锁会重复加分。destroyDelay默认 0.5 秒如果粒子时长是 1 秒就改成 1 秒。sliceEffect建议用 Unity 自带的 Particle System 做一个简单的球形扩散不要用太重的特效VR 里掉帧比画面丑更致命。3.3 计分 UI 与游戏循环从 ScriptableObject 到场景重开计分不要每个水果单独找 UI 文本用一个 GameManager 统一管理。分数变化时更新 UI达到目标分数后显示重开按钮。// GameManager.cs using UnityEngine; using TMPro; public class GameManager : MonoBehaviour { public static GameManager Instance; [SerializeField] private TextMeshProUGUI scoreText; [SerializeField] private GameObject restartPanel; [SerializeField] private int targetScore 100; private int currentScore 0; private void Awake() { Instance this; } public void AddScore(int value) { currentScore value; scoreText.text $Score: {currentScore}; if (currentScore targetScore) { restartPanel.SetActive(true); } } public void RestartGame() { UnityEngine.SceneManagement.SceneManager.LoadScene( UnityEngine.SceneManagement.SceneManager.GetActiveScene().buildIndex); } }targetScore设成 100 是给演示留余地水果分值 10 的话打中 10 个就结束。restartPanel是一个 World Space 的 Canvas挂在摄像机前方 2 米处VR 里不要用 Screen Space Overlay否则在头显里看不到。重开用LoadScene最稳不要手动重置每个水果的位置容易漏。4. 导出 exe 与真机演示打包设置、性能取舍与常见故障4.1 Windows exe 打包的五个关键设置导出 exe 是期末作业交付的硬指标。File Build Settings 里选 Windows x86_64然后重点检查这几项设置项推荐值原因Architecturex86_6464 位系统兼容Compression MethodLZ4HC加载快体积可接受Development Build演示时勾选方便看日志Script Debugging演示时勾选出错能定位Graphics APIDirect3D11VR 兼容性最好Graphics API 不要选 AutoAuto 在某些机器上会走 Vulkan导致头显画面撕裂。手动指定 Direct3D11 最稳。如果热词里提到的「vr渲染器切换cpu gpu模式」让你困惑在 Unity 里对应的是 Player Settings Rendering 下的 Graphics API 列表把 D3D11 拖到第一位即可。4.2 打包后手柄失灵的排查顺序打包 exe 后手柄没反应按这个顺序查确认 OpenXR Runtime 是否安装。Windows 上需要装对应的 OpenXR Runtime否则 exe 启动后找不到设备。检查 exe 是否以管理员权限运行。热词里「unity is running with administrator privileges」提示过这个坑某些设备在管理员权限下反而无法读取手柄输入。看 Player.log。路径在C:\Users\用户名\AppData\LocalLow\公司名\产品名\Player.log搜「XR」或「Input」关键字。# 快速查看 Player.log 里的 XR 相关报错 # Windows 下用 PowerShell Get-Content $env:LOCALAPPDATA\..\LocalLow\DefaultCompany\FruitShooter\Player.log | Select-String XR|Input|OpenXR这段命令帮你过滤日志里的 XR 和输入相关行。如果看到「No XR display subsystem found」说明 OpenXR Runtime 没装好如果看到「Input System is not enabled」说明打包时 Active Input Handling 选错了。4.3 性能优化VR 里必须守住的帧率底线VR 项目低于 72 帧就会晕射击水果虽然场景简单但粒子特效和实时阴影是两大杀手。我一般会做三件事关掉实时阴影改用烘焙、粒子最大数量限制在 50 以内、水果模型面数控制在 500 面以下。热词里的「unity游戏优化」在 VR 场景里优先级最高因为帧率直接决定可用性。在 Quality Settings 里把 Shadow Distance 设为 0 或很小值Anti Aliasing 用 2x 或 4x不要开 8x。如果用的是 Pico4 一体机模式还要在 Pico 开发者后台里把 CPU 和 GPU 等级调到最高否则默认会降频。5. 避坑与排查VR 射击水果作业里最容易翻车的五件事5.1 射线打不中水果但手柄明明有震动现象扣扳机手柄有震动反馈但水果不消失分数也不变。原因XR Ray Interactor 的 Interaction Layer Mask 没有勾选 Fruit 层或者水果的 Collider 被禁用。另一种可能是射线被手柄自身的 Collider 挡住射线起点在模型内部。解决把水果统一放到 Fruit 层Ray Interactor 的 Layer Mask 只勾 Fruit。手柄控制器的 Collider 设为 Ignore Raycast或者把射线起点偏移到手柄前方 0.1 米。5.2 打包后 UI 在头显里看不见现象Editor 里计分文本正常导出 exe 后头显里一片空白。原因Canvas 用了 Screen Space OverlayVR 渲染模式下 Overlay 不会显示在头显里。解决Canvas 的 Render Mode 改成 World Space缩放设为 0.01位置放在摄像机前方 2 米、视线下方 0.3 米处。TextMeshPro 的字体材质要选 Mobile 或 SDF不要用普通字体。5.3 水果被击中后重复加分现象打一个水果加了 30 分实际分值只有 10。原因射线在单帧内多次命中同一个 Collider或者水果的 OnHit 被多个脚本调用。解决在 FruitTarget 里加isHit布尔锁如 3.2 节代码所示。同时检查 XR Ray Interactor 的 Raycast Trigger Interaction 是否设为 Collide不要用 Overlap。5.4 导出 exe 时报错「Could not find OpenXR Runtime」现象Build 成功但双击 exe 弹出错误框提示找不到 OpenXR Runtime。原因目标机器没装 OpenXR Runtime或者 Runtime 版本与打包时不一致。解决在目标机器上安装对应头显的 OpenXR Runtime。如果是 Pico装 Pico 的串流助手和 XR Runtime如果是 Quest装 Oculus PC 客户端。演示前一定在目标机器上先跑一遍不要只在开发机上测。5.5 场景切换后手柄追踪丢失现象重开游戏后手柄位置卡住不动头显画面正常。原因LoadScene 后 XR Origin 重新实例化但 Input Action Asset 没有重新绑定。解决把 XR Origin 做成 Prefab重开时不要销毁它只重置水果和分数。或者用 DontDestroyOnLoad 保住 XR Origin场景里只加载游戏逻辑部分。6. 把作业变成能讲清楚的作品源码结构、演示视频与验收技巧一套能拿得出手的 VR 射击水果作业不只是 exe 能跑还要让人看懂你的设计。源码目录建议按功能分文件夹Scripts 放 C# 脚本Prefabs 放水果和特效Scenes 放主场景Materials 放材质Audio 放音效。设计文档不用写太长重点写清楚三个东西交互流程图、计分规则表、打包环境说明。演示视频控制在 2 分钟内开头 10 秒展示头显画面和手柄操作中间 60 秒打水果和计分最后 20 秒展示重开和打包后的 exe 运行画面。验收时老师常问的问题就几个射线怎么发射的、命中怎么判定、分数怎么同步、打包遇到什么问题。你如果能指着 ShootRayController 说清楚TryGetCurrent3DRaycastHit的返回值逻辑指着 FruitTarget 说清楚isHit锁的作用基本就稳了。我自己的习惯是每次打包前把 Player Settings 截图存档演示前 30 分钟在目标机器上完整跑一遍确认手柄、头显、音效都正常。这个习惯帮我省过至少三次现场翻车。希望帮到你。本文还有配套的精品资源点击获取