Unity中HelloCardboard相机无法移动及XR初始化失败问题求助

问题描述 #

我是Unity VR编程新手，首个项目遵循Google Cardboard快速指南完成开发，已修复若干错误并成功编译运行至设备。但核心问题如下：

• 相机无法通过手机陀螺仪或手指控制移动，也未显示Cardboard所需的双视图
• 在Unity编辑器运行时，使用Alt+Click也无法移动相机
• 主相机出现警告：The referenced script (Unknown) on this Behaviour is missing!
• 错误日志（中文翻译）：

XR初始化失败。
UnityEngine.Debug:LogError (object)
VrModeController/d__10:MoveNext () (位于 Assets/Samples/Google Cardboard XR Plugin for Unity/1.21.0/Hello Cardboard/Scripts/VrModeController.cs:148)
UnityEngine.SetupCoroutine:InvokeMoveNext (System.Collections.IEnumerator,intptr)

分步修复方案 #

1. 清理丢失的脚本引用 #

• 选中场景中的主相机，在Inspector面板找到标有Missing (Unknown Script)的失效组件，直接删除
• 替换为官方预制体：从Assets/Samples/Google Cardboard XR Plugin for Unity/1.21.0/Hello Cardboard/Prefabs路径拖拽CardboardMain预制体到场景，删除原主相机。该预制体已配置好双视图、陀螺仪控制所需的全部组件

2. 重置XR插件配置 #

• 打开Edit > Project Settings > XR Plug-in Management
• 针对当前开发平台（Android/iOS），确保Cardboard已被勾选为Active XR Plug-in
• 若之前修改过配置，点击面板右上角的Reset All，重新勾选Cardboard后重启Unity

3. 验证VrModeController脚本完整性 #

• 找到场景中的VrModeController对象（通常在CardboardMain预制体下），检查Inspector面板的脚本引用是否正常
• 若脚本丢失，从Assets/Samples/Google Cardboard XR Plugin for Unity/1.21.0/Hello Cardboard/Scripts/路径拖拽VrModeController.cs到组件栏，重新绑定

4. 编辑器调试配置 #

• 打开Window > XR > XR Simulator，启用Cardboard模拟器，替代Alt+Click的手动控制方式，直接在编辑器预览陀螺仪效果
• 检查输入设置：打开Edit > Project Settings > Input Manager，确认Mouse Look轴的绑定未被修改，确保编辑器内相机控制正常

5. 设备端权限检查 #

• 编译到手机后，前往应用设置开启运动传感器权限（Android：应用权限→运动传感器；iOS：设置→隐私与安全性→运动与方向访问）
• 确保APK包未遗漏插件资源：不要手动删除Samples目录下的核心脚本、预制体或配置文件

内容的提问来源于stack exchange，提问作者Lucas Andres Escudero