Installing Tobii Ocumen

This page explains how to get started with Tobii Ocumen.

Table of Contents

Do not drag-drop the Unity code into your Assets folder; instead use the Unity Package Manager.

Uninstall any Tobii XR SDK you might have in your project. Tobii Ocumen comes bundled with its own Tobii XR SDK.

Add VR support

Install the XR Plugin Management which can be found in the Project Settings tab.

Remember to enable the corresponding Plugin Provider for your headset, for more detailed instructions on how to set up VR support for your headset, see our getting started guides.

When following the getting started guide, skip the step of importing the Tobii XR SDK, it comes bundled in the Ocumen package.


Tobii Ocumen will be made available to you via the Tech Portal from which you can download the latest release, for example:

Inside this bundle you will find various files and folders. The exact details might change with each release and the contained README will give definitive insights on what’s included. However, all Unity code presented on this web site refers to content you can find in the contained /Packages/ folder, marked below.

Package Installation

Once you have unpacked Ocumen you need to import the Unity components into your project.

  • Step 1: Open Package Manager

  • Step 2: “Add package from disk …”

  • Step 3: Import the package.json files in /Packages/ in the following order:

    1. XR SDK
    2. Core
    3. Other packages

Import Samples

Most packages come with samples and other Ocumen documentation often refer to these. You should import them into your project by pressing the Import-button in the Package Manager.

Some samples might require you to make additional choices after importing, e.g., resolving dependencies. You should usually confirm these dialogs, e.g., by clicking “Agree” or importing “Essentials”.

Add your License

To use Ocumen you need a license, both the legal agreement and a technical license file, which you should find in our Tech Portal.

Once you have obtained your license file, add it to your Unity project and drag it to the License Asset field in the TobiiXR_Initializer script in your scene.

The license must have the file extension “.bytes”.

Enable Pico Support (Only Pico Users)

The Tobii Ocumen packages and examples are set up without any external SDK dependency.

To be able to run them on your Pico Neo 2 Eye, you would need to to import Pico’s Unity XR Platform SDK as well as configure your project and scene for Pico. Follow our Pico Getting Started but skip Step 4 of importing the XR SDK since it is already bundled in Tobii Ocumen.