HoloLensARToolKit 项目使用教程

1. 项目目录结构及介绍

HoloLensARToolKit 项目的目录结构如下：

HoloLensARToolKit/
├── ARToolKitUWP/
├── HoloLensARToolKit/
├── HoloLensCamCalib/
├── Markers/
├── .gitignore
├── .gitmodules
├── ARToolKitUWP-Sample.unitypackage
├── ARToolKitUWP.unitypackage
├── COPYING
├── COPYING.LESSER
├── README.md

目录结构介绍

• ARToolKitUWP/: 包含 ARToolKit 的 UWP 包装器，用于在 HoloLens 上运行 ARToolKit。
• HoloLensARToolKit/: 包含 Unity 项目，包含示例场景和完整的包，用于演示该项目。
• HoloLensCamCalib/: 包含 HoloLens 相机的校准文件。
• Markers/: 包含用于示例的 ARToolKit 标记。
• .gitignore: Git 忽略文件。
• .gitmodules: Git 子模块配置文件。
• ARToolKitUWP-Sample.unitypackage: 包含示例场景的 Unity 包。
• ARToolKitUWP.unitypackage: 包含核心库和脚本的 Unity 包，用于与原生库接口。
• COPYING: GPL-3.0 许可证文件。
• COPYING.LESSER: LGPL-3.0 许可证文件。
• README.md: 项目介绍和使用说明。

2. 项目启动文件介绍

项目的启动文件主要集中在 HoloLensARToolKit/ 目录下的 Unity 项目中。以下是主要的启动文件和场景：

启动场景

• HL1ARToolKitSingle.unity: 适用于 HoloLens 1 的单标记示例场景。
• HL1ARToolKitCube.unity: 适用于 HoloLens 1 的立方体示例场景。
• HL1ARToolKitMulti.unity: 适用于 HoloLens 1 的多标记示例场景。
• HL1ARToolKitCoords.unity: 适用于 HoloLens 1 的坐标系示例场景。
• HL2ARToolKitSingle.unity: 适用于 HoloLens 2 的单标记示例场景。
• HL2ARToolKitCube.unity: 适用于 HoloLens 2 的立方体示例场景。
• HL2ARToolKitMulti.unity: 适用于 HoloLens 2 的多标记示例场景。
• HL2ARToolKitCoords.unity: 适用于 HoloLens 2 的坐标系示例场景。

启动步骤

1. 打开 Unity 项目。
2. 选择适合设备的示例场景（如 HL1ARToolKitSingle.unity 或 HL2ARToolKitSingle.unity）。
3. 配置 ARUWP Controller 和 ARUWP Video 组件，确保视频参数和相机校准文件匹配。
4. 构建并部署到 HoloLens 设备。

3. 项目配置文件介绍

配置文件

• ARUWP Controller: 控制 ARToolKit 的初始化和运行参数。

  • Camera Param Filename: 指定相机校准文件的路径。
  • Video Parameter: 设置视频参数，如分辨率和帧率。

• ARUWP Video: 控制视频流的捕获和处理。

  • Enable Video Preview: 是否启用视频预览。
  • Video Configuration: 视频配置参数。

配置步骤

1. 在 Unity 编辑器中，选择 ARUWP Controller 游戏对象。
2. 在 ARUWP Controller 组件中，设置 Camera Param Filename 为校准文件的路径。
3. 在 ARUWP Video 组件中，根据设备设置视频参数。
4. 确保 Enable Video Preview 在实际应用中关闭以提高性能。

通过以上步骤，您可以成功配置和启动 HoloLensARToolKit 项目，并在 HoloLens 设备上运行增强现实应用。