如何将Antilatency SDK安装到Unity

如何将Antilatency SDK安装到Unity

这是关于如何使用Unity Package Manager在您项目中安装Antilatency SDK的简短说明

在本文中

要安装Antilatency SDK(发行版),请转到配置器页面,选择Unity版本和您所需的库。如果不确定确切需要哪些库和组件,可以在“Antilatency库”节了解。
Generate按钮,等待服务器上正在进行生成。SDK包准备好后,单击Download(下载):您将被重定向到GitHub存储库页面。接下来的步骤取决于安装方法和使用的Unity版本。
如果您所选的SDK子集(subset)已经准备好并可在GitHub上使用,您将立即看到Download按钮

使用Git URL安装

如果您使用的Unity是2019年版本或更高版本的,并且在系统上安装并配置了Git,那么将Antilatency SDK添加到项目中的最简单方法是使用Unity软件包管理器直接从GitHub存储库安装它。如果您的系统上没有Git,请安装它或使用非Git方法
在生成的SDK子集页面(GitHub上),复制“README.md”节开头的Unity Package Manager链接。
打开Unity项目并转到Package Manager(软件包管理器)窗口(菜单项:Window ⇾ Package Manager)。
单击+,选择Add package from git URL,粘贴链接,然后单击Add
等待软件包下载并安装到您项目中。
完成!“Antilatency SDK”项应出现在已安装的项目包列表和“Packages”节中。
如果出现“No 'git' executable was found...”错误,您可以使用这个解决方案
您可以在此处阅读关于使用Git URL安装的更多信息

从本地磁盘安装软件包

这种方法也适用于不支持Git的Unity版本。
首先,将SDK包下载到本地磁盘:在GitHub上打开生成的SDK子集页面,下载并解压当前分支的存档。
打开Unity项目并转到Package Manager(软件包管理器)窗口(菜单项:Window ⇾ Package Manager)。
通过Package Manager添加Antilatency SDK(+ ⇾ Add package from disk,然后在下载的SDK文件夹中选择“package.json”)。
您可以在此处阅读有关从本地目录安装软件包的更多信息
等待软件包下载并安装到您项目中。
完成!您可以检查包是否安装在Package Manager或项目窗口的“Packages”节。

如何更改Antilatency SDK子集

如果您想在已经将SDK添加到项目中之后更新子集或更改组件,那么应该重新组装子集并将其重新安装到Unity。
要基于已安装的软件包快速创建新的子集,请打开Unity Package Manager,找到Antilatency SDK软件包说明,将链接复制到浏览器并配置新版本。
该链接也可以在Antilatency SDK包内的README.md文件中找到
使用SDK配置器生成新的子集,从项目中删除旧包,然后安装新包。

如何在Unity项目中使用Antilatency SDK

完成上述安装SDK的步骤后,Antilatency系统就可以在您的项目中工作了。让我们考虑一个简单的使用示例,其中我们将跟踪圆柱在台上的位置。
  1. 我们创建一个空对象来存储有关跟踪区的信息。我们将此对象命名为Environment,并向其添加AltEnvironment脚本,该脚本位于“Antilatency SDKRuntimeModulesAltEnvironment”中。此脚本获取有关跟踪区的数据,该区在以下Environments中默认设置:
  2. 现在,我们将创建另一个空对象,该对象将存储有关连接的Antilatency设备的信息。我们将此对象命名为Network,并将DeviceNetwork脚本添加到其中:
  3. 现在,我们将创建一个要跟踪的对象,例如,圆柱。需要向其中添加跟踪脚本。对于本例,我们使用AltTrackingDirect脚本为例,该脚本查找第一个可用的Alt,如果找到了,则开始对其执行跟踪Task(任务)。
    此脚本很少在实际项目中使用。更常见的是,使用AltTrackingTag脚本,它允许通过底座标记来区分跟踪的对象,或者使用AltTrackingUsbSocket,它在通过USB连接的设备上启动跟踪过程。

  4. 跟踪脚本应获取有关跟踪区和可用设备的信息。为此,我们将在步骤1-2中准备的对象作为参数传递给它:
  5. 完成!启动应用程序后,台上的圆柱将由跟踪器跟踪。
这里可以找到使用Antilatency系统的Unity项目的更复杂示例:项目示例