XR Interaction Toolkit on XR技术研习社

4 种安装特定版本 Package 的方法

Mon, 22 Dec 2025 11:50:00 +0800

引言

在 Unity 项目的开发生命周期中，工具版本的确定性往往比追求最新更为重要。然而，在实际的工程实践中，开发者面临的需求远比「使用最新版本」复杂得多，包括但不仅限于以下情境：

团队协作对齐：为了确保所有成员的代码表现一致，必须严格锁定所有 Package 的版本号。
老旧项目维护：接手或复现一个两年前的项目时，新版 Package 往往会导致兼容性报错，比如 XRI 2.x 升级到 3.x 的架构断层、API 结构不兼容等。当老项目架构对旧版本 Package 开发依赖严重时，此时回退到旧版本往往是更高效的解决方案。
特定环境复现：跟随特定的技术教程学习时（如 XR Interaction Toolkit、ARFoundation 课程），必须使用与之严格匹配的工具版本，才能得到更好的沉浸式学习体验——版本差异会因为命令路径、界面布局的不一致，而导致学习进程的中断。

对于需要在线安装管理的工具包（比如 Interaction Toolkit、ARFoundation 等），Package Manager 的默认策略通常是推荐当前可用的「最新版」。而安装指定版本的 Package 相对比较有挑战性，因为这些工具包通常不提供离线下载文件，所以我们需要掌握在 Package Manager 中安装特定版本的技巧。

适用范围说明

本文讨论的对象是通过 Package Manager 在线安装的工具包 Package（UPM），并非传统意义上的资源包（.unitypackage）。后续也将会使用 Package 指代前者。

此外，部分第三方厂商（如 PICO、Meta 等）提供的 SDK 通常支持离线安装方式，可直接从官方渠道获取历史版本，故不在本文讨论范围内。

四种方法

方法零：通过详情页历史版本安装

在尝试复杂方法前，可先检查 Unity 原生提供的历史列表，在这里 Unity 会提供几个推荐的稳定版本。

操作步骤（以 Unity 2022 为例）

在 Package Manager 中选择目标 Package。
在右侧详情页点击 Version History 选项卡。
如果目标版本在列表中，直接点击右下角的 Update to x.x.x。

Interaction Toolkit 新版模拟器快捷键

Tue, 15 Apr 2025 17:45:00 +0800

引言

在新版 Interaction Toolkit 中，对 XR 模拟器进行了比较大的更新，本文将介绍其中常用的快捷键。

基本操作快捷键

Tab - 在控制器模式和 Full Body 全身控制模式之间切换
Y - 展开/折叠左下角的 UI 主菜单
X - 当切换到手柄控制器或手部时，可展开顶部二级菜单
R - 重置所有部件回到初始状态
W/A/S/D - 向前/左/后/右移动选中的部件
Q/E - 上下移动选中的部件
方向键 - 旋转所选部件
鼠标右键（按住）- 对当前选中的部件进行旋转

控制器/手部模拟快捷键

左中括号 [ - 选择并控制左手手柄/左手，重复按下可在手柄和手部之间切换
右中括号 ] - 选择并控制右手手柄/右手，重复按下可在手柄和手部之间切换
Shift +（快捷键）- 对左手发出动作时的组合键，需要先按住 Shift 然后结合其他快捷键
T - 模拟按下 Trigger 键
G - 模拟抓取（Grip）
1/2 - 模拟手柄控制器上的右手控制器 A 键、B 键或左手控制器 X、Y 键
空格键 - 用于持续（保持）发出动作，按下 Space 切换 Press/Release 状态
`（波浪键/反引号键）- 循环切换 Space 键要控制的动作（Trigger、Grip、Primary、Secondary）
I/J/K/L - 用于模拟摇杆输入：I（向前/瞬移），J（向左转身），K（向后），L（向右转身）
M - 手部捏合动作（Pinch）
K - 手部抓取动作（Grab）
N - 手部戳点动作（Poke）

Interaction Toolkit 跳跃功能详解

Wed, 09 Apr 2025 18:00:00 +0800

本文主要内容

介绍实现跳跃功能的 Jump Provider 组件
如何禁用跳跃功能
如何将跳跃功能绑定到其他按键上

跳跃功能概述

在 Interaction Toolkit 新版本中，如果使用新版本中的 XR Origin 预制体进行场景初始化，跳跃功能会默认集成在预制体中，开发者无需手动实现，程序运行时，通过点击右手手柄控制器的 A 键即可实现跳跃。

跳跃功能的实现结构

要了解 Interaction Toolkit 中跳跃功能的实现，首先需要了解相关游戏对象的结构。

在游戏对象 XR Origin 下的 Locomotion 中，包含了一个名为 Jump 的子物体，在其上挂载了一个名为 Jump Provider 的组件，这是实现跳跃功能的主要组件。值得注意的是，跳跃功能并不仅凭 Jump Provider 实现，在 Interaction Toolkit 的移动架构中，各种移动形式不仅需要各自的 Provider，还需要一个全局管理角色 Locomotion Mediator 来管理协调不同的移动方式。

如何禁用跳跃功能

并非所有 VR 项目都需要跳跃功能，而默认情况下跳跃功能占用了右手控制器的 A 键。如果项目不需要跳跃或者需要在 A 键上实现其他功能，此时在 Hierarchy 窗口中将 Jump 子物体隐藏即可禁用跳跃功能。

Interaction Toolkit 空间键盘（Spatial Keyboard）功能的实现

Sun, 23 Mar 2025 17:04:00 +0800

在 VR 应用开发中，文本输入是一个常见需求，而 Unity 的 Interaction Toolkit 提供了空间键盘功能，使开发者能够快速实现这一功能。本文将详细介绍如何在 Unity XR 项目中实现两种形态的空间键盘：全局空间键盘和世界空间键盘。

准备工作

在开始实现空间键盘功能前，需要先导入相关资源包并解决依赖问题。

导入 Spatial Keyboard 资源包

首先确保已安装 Unity XR Interaction Toolkit，然后进行以下操作：

打开 Package Manager
找到 Interaction Toolkit
在 Samples 标签页下找到 Spatial Keyboard
点击 Import 导入资源包

导入过程中会提示对 TextMesh Pro 的依赖，这是因为键盘上的文字是通过 TextMesh Pro 呈现的。

解决版本依赖问题

初次导入后可能会遇到版本依赖问题。如果运行应用程序时出现与 KeyboardOptimizer.cs 相关的报错，如下图所示：

此时需要升级 TextMesh Pro 插件：

打开 Package Manager
切换到 Unity Registry
找到 TextMesh Pro
点击 Update 升级到较新版本（如从 3.0.7 升级到 3.0.9）