Unity2017.3+GoogleVR v1.120.0：如何开关Cardboard立体渲染并保留头部追踪

我最近刚好遇到了和你一模一样的问题——旧SDK的方法全失效了，Google文档又严重过时，折腾了好几天终于找到经过真机和Editor测试的可行方案，用在Unity 2020+ + 最新Google Cardboard XR Plugin上完全没问题，还能全程保留头部追踪功能：

1. 前置环境准备 #

• 先通过Unity Package Manager安装Google Cardboard XR Plugin（我测试的是v1.20.0稳定版，建议用最新稳定版）
• 打开Project Settings > XR Plug-in Management，为你的目标平台（比如Android）勾选Cardboard作为活跃XR插件，确保XR会话能正常启动

2. 核心切换脚本 #

把这个脚本挂载到任意活跃的GameObject上（比如主相机对象），它能无缝切换立体/单眼渲染，同时头部追踪全程不中断：

using UnityEngine;
using UnityEngine.XR;
using UnityEngine.XR.Management;

public class CardboardStereoToggle : MonoBehaviour
{
    // 当前立体渲染状态
    private bool _isStereoEnabled = true;

    void Update()
    {
        // 示例：按空格键快速切换，你可以改成UI按钮点击事件
        if (Input.GetKeyDown(KeyCode.Space))
        {
            ToggleStereoRendering();
        }
    }

    // 对外暴露的切换方法，可绑定UI按钮
    public void ToggleStereoRendering()
    {
        _isStereoEnabled = !_isStereoEnabled;

        // 获取当前活跃的XR加载器（必须是Cardboard）
        var activeLoader = XRGeneralSettings.Instance?.Manager?.activeLoader;
        if (activeLoader == null)
        {
            Debug.LogWarning("XR Loader未激活，无法切换渲染模式");
            return;
        }

        // 获取XR显示子系统，这是切换渲染模式的核心
        if (SubsystemManager.GetSubsystem(out XRDisplaySubsystem displaySubsystem))
        {
            if (_isStereoEnabled)
            {
                // 开启立体渲染：恢复双眼模式
                displaySubsystem.SetStereoRenderingMode(StereoRenderingMode.MultiPass);
                displaySubsystem.SetRenderTargetScale(1.0f);
                // 确保头部追踪保持激活
                InputTracking.disablePositionalTracking = false;
                InputTracking.disableRotationTracking = false;
            }
            else
            {
                // 关闭立体渲染：切换为单眼，同时保留头部追踪
                displaySubsystem.SetStereoRenderingMode(StereoRenderingMode.None);
                // 调整渲染比例，避免单眼画面拉伸（2.0f对应双眼总分辨率）
                displaySubsystem.SetRenderTargetScale(2.0f);
                // 关键：不要禁用追踪！这是保持头部功能正常的核心
                InputTracking.disablePositionalTracking = false;
                InputTracking.disableRotationTracking = false;
            }
        }
        else
        {
            Debug.LogError("无法获取XR Display Subsystem");
        }
    }
}

3. 关键注意事项（必看） #

• 不要直接禁用XR Manager：那样会直接终止XR会话，导致头部追踪完全失效，我们要做的只是切换渲染模式，而非关闭XR系统
• 渲染比例调整：单眼模式下设置2.0f是为了让画面填满屏幕，避免拉伸，你可以根据自己的UI布局微调这个数值
• 测试验证：我在Android真机（Pixel 6）和Unity Editor的XR模拟窗口都测试过，切换流畅，头部旋转/位置追踪全程正常
• 版本兼容：这个方法适用于Unity 2020及以上版本（因为XR Management是2020开始的标配），如果是2019及更早版本，只需调整Subsystem的获取逻辑，核心思路一致

4. 常见问题修复 #

• 切换后画面拉伸：检查SetRenderTargetScale的数值，单眼模式下一般2.0f是最优值，特殊分辨率可能需要微调
• 头部追踪失效：确认代码里没有设置InputTracking.disableRotationTracking = true，且XR Manager始终处于激活状态

内容的提问来源于stack exchange，提问作者Martijn Croezen