Installation
There are two approaches for installing Telerik XR Integration in your Unity project—by importing the assets in the Assets folder or by importing the packages using the Package Manager. The following instructions will guide you through the installation process and will point out the pros and cons of each approach.
Installing inside the Assets Folder
Importing the controls in the Assets
folder will clone the Telerik content to your project. This approach is appropriate if you do not intend to reuse the same code from the same disk location across several projects.
After downloading Telerik assets from Unity Asset Store, you can install them through importing:
-
Choose the Import button to start importing the assets in your project.
- If you have already installed other Telerik assets, then you may choose to replace or skip importing the
XR Core
subfolder as it is common for all Telerik assets.
- If you have already installed other Telerik assets, then you may choose to replace or skip importing the
-
As a result, you will see a
Telerik
folder under theAssets
folder.Inside
Telerik
, you will findXR Core
and all other Telerik packages that you have imported.
Installing as Unity Package
If you want to reference the Telerik code from a single file location to several Unity projects, you can reference each Telerik subfolder as a Unity package. This approach allows you to reuse the same code across different projects:
Create a new Unity project that you will use to organize all Telerik assets in a single place on the file system. Name the project, for example, Telerik UI for Unity XR.
Import all purchased Telerik assets in the
Assets
folder of the Telerik UI for Unity XR project. For more details, see Installation inside the Assets Folder above.Open the actual project you are working on—the one that will use the Telerik code referenced as Unity packages.
-
Reference the XR Core package from the
Assets
folder of the Telerik UI for Unity XR project:Open the Unity Package Manager. See the Unity Manual for more details.
Locate the
package.json
file in theXR Core
folder.
You must first import the XR Core package because all other Telerik packages depend on its code.
-
Reference all other downloaded Telerik packages by repeating the previous step and importing the corresponding
package.json
file.- You must reference XR Integration as the last package because it depends on all other Telerik packages.
After referencing all the purchased packages, you will see them listed under the packages tree node as in the image below.
The package manager adds the references with absolute paths. If you are working in a team and each team member has installed the source control repository in a different file location, then you may consider changing the absolute paths to relative paths in your project
manifest.json
. The image below demonstrates sample relative paths to Telerik packages.
Requirements
You can build AR/VR applications with Telerik UI for Unity XR by using the Oculus XR plugin that you can install from the XR Plug-in Management section in the Unity Project Settings. Telerik XR tooling DOES NOT depend on the Oculus Integration Asset so you are NOT REQUIRED to download it from the Asset Store.
This version of com.progress.xr.integration is compatible with the following Unity versions, platforms, and render pipelines:
- Unity 2020.3
- Windows and Android platforms
- Built-in render pipeline.