Hololens 2 Unity项目：MRTK3结合Vuforia Model Target配置求助

一、前置环境确认 #

• 统一Unity版本：推荐使用2022.3 LTS（需同时兼容MRTK3和Vuforia最新稳定版）
• 安装必备包：
  • 通过Unity Package Manager安装Microsoft Mixed Reality Toolkit Foundation及所有依赖包
  • 安装Vuforia Engine包，在Project Settings > Vuforia Configuration中绑定并激活你的Vuforia License Key
  • 安装Windows XR Plugin和Mixed Reality OpenXR Plugin，确保HoloLens 2的XR支持正常

二、项目基础配置 #

1. 打开Project Settings > XR Plug-in Management，勾选OpenXR，在OpenXR Settings里启用Microsoft HoloLens交互配置文件
2. 进入Project Settings > Player > Publishing Settings > Capabilities，勾选以下权限：
   • InternetClient
   • WebCam
   • SpatialPerception
3. 调整Player核心参数：
   • 目标平台切换为Universal Windows Platform，架构选择ARM64
   • 在Other Settings中，将Scripting Backend设置为IL2CPP

三、MRTK3 XR Rig与Vuforia相机整合 #

禁止手动替换MRTK XR Rig的相机组件，按以下步骤配置：

• 删除场景默认的Main Camera
• 从MRTK3预制体库中拖入MRTK XR Rig到场景
• 选中MRTK XR Rig > Camera Offset > Main Camera，添加Vuforia Behaviour组件
• 在Vuforia Behaviour组件中，设置Camera Device Mode为World，确保Use Custom Camera未勾选
• 打开Project Settings > Vuforia Configuration，在Digital Eyewear选项卡中，选择HoloLens 2作为Device Type，Camera Direction设为World

四、Model Target配置 #

1. 导入你的Vuforia Model Target数据库（.xml和.dat文件），在Vuforia Configuration中勾选激活该数据库
2. 在场景中创建空物体并命名为ModelTargetTracker，添加Model Target Behaviour组件
3. 配置Model Target Behaviour组件：
   • 选择已导入的目标数据库和对应的Model Target
   • 设置Tracking Mode为POSE_TRACKING（适配HoloLens 2空间追踪特性）
   • 勾选Auto Start Tracking，Sensitivity保持默认值即可（后续可根据实际效果微调）
4. 将需要跟踪显示的3D模型设为ModelTargetTracker的子物体，初始状态设为Inactive
5. 添加跟踪状态控制脚本：

   using UnityEngine;
   using Vuforia;
   
   public class ModelTargetHandler : MonoBehaviour
   {
       public GameObject trackedModel;
       private ModelTargetBehaviour modelTarget;
   
       void Start()
       {
           modelTarget = GetComponent<ModelTargetBehaviour>();
           modelTarget.OnTargetFound += OnTargetFound;
           modelTarget.OnTargetLost += OnTargetLost;
           trackedModel.SetActive(false);
       }
   
       void OnTargetFound()
       {
           trackedModel.SetActive(true);
       }
   
       void OnTargetLost()
       {
           trackedModel.SetActive(false);
       }
   }
   

   将脚本挂载到ModelTargetTracker，并把3D模型拖入trackedModel字段

五、测试与验证 #

• 编辑器内测试：点击Play按钮，使用Vuforia模拟器加载模型测试图像，验证跟踪触发逻辑
• 设备部署测试：通过Unity Build Settings生成UWP包，用Device Portal或Visual Studio部署到HoloLens 2，测试物理模型的实际跟踪效果

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