Tobii Ocumen - FAQ
If you can’t find an answer here, you can contact us via our contact form.
Table of Contents
General
Questions about Tobii Ocumen in general.
Where can I get Tobii Ocumen?
Tobii Ocumen is offered on top of our Tobii XR SDK and available separately. Please contact us via our contact form.
What hardware is Tobii Ocumen compatible with?
| Headset Compatibility | 2021-10-04 | 2021-12-08 | 2023.1.0 | 2024.1.0 |
|---|---|---|---|---|
| HP Reverb G2 Omnicept | Yes | Yes | Yes | Yes |
| Pico Neo 3 Pro Eye | Yes | Yes | Yes | Yes |
| Pico Neo 2 Eye | Yes* | Yes* | No† | No† |
*Calibration quality API not supported.
†Support for the Pico Neo 2 Eye was phased out in the 2023.1.0 release since Pico no longer officially supports the headset. The headset may still work with Ocumen, but we will not provide any support for it.
How do I get started with Tobii Ocumen?
You can find a general getting started video for Tobii Ocumen in our solutions page.
More detailed getting started guides for each individual component can be found in the develop section.
What is the current readiness of Tobii Ocumen?
Tobii Ocumen consists of several components which differ in their state of readiness:
| Component | 2021-10-04 | 2021-12-08 | 2023.1.0 | 2024.1.0 |
|---|---|---|---|---|
| Tobii Ocumen Advanced Signals | Stable | Stable | Stable | Stable |
| Tobii Ocumen I/O | Stable | Stable | Stable | Stable |
| Tobii Ocumen Configuration | Stable | Stable | Stable | Stable |
| Tobii Ocumen Filters | Alpha | Removed* | Stable | Stable |
| Tobii Ocumen Studio | Alpha | Beta | Beta | Beta |
The respective readiness levels mean:
- Stable - The component is complete and has received extensive testing. Newer versions containing bug fixes and improvements will be provided.
- Beta - The component is usable but still undergoing changes, and it has not been extensively tested.
- Alpha - The component is undergoing heavy development and design changes. We only recommend its use in early or experimental development phases.
- Removed - The component has been removed.
*Tobii Ocumen Filters was removed in the 2021-12-08 release for technical reasons, and an improved replacement was added in the 2023.1.0 release.
How do I upgrade from an older Ocumen version in Unity?
To upgrade from an older Ocumen version, remove all existing Tobii Ocumen and Tobii XR SDK packages from the project and add the packages from the new version. After the upgrade, certain code implementations might be needed depending if new version contains breaking changes. Refer to the Ocumen changelog for more info.
Will my older Ocumen projects work with the new version?
Whether older projects will work directly with the new version of Ocumen depends on the extent of changes made in an update. If significant modifications have been made, some adjustments to your old projects will be necessary. To ascertain the exact changes needed, you should refer to the Ocumen changelog or documentation provided with the new version.
How do I upgrade recordings from an older recording version to the latest version?
When creating or playing a recording, Ocumen uses the I/O API with a specific recording format. As of Ocumen 2024.1.0, a converter tool is provided to convert older recordings to the latest version. The converter tool can be run in two ways:
- Using the command line interface: please refer to the documentation in the Tobii Ocumen Converter folder for more information.
- Using Ocumen Studio: when opening an older recording in Ocumen Studio, a prompt will appear asking if you want to convert the recording to the latest version. If you choose to convert the recording, a new recording file will be created in the same folder as the original recording.
How can I get feature X?
If something is missing we would be more than happy to hear about it, please use our contact form.
Ocumen I/O
Questions related to Ocumen I/O.
What languages are supported?
Language and operating system support is generally driven by demand, and additional languages can sometimes be made available upon request. Right now we support:
- Unity C# (Windows / Android) for recording and data import and export.
- Python 3.8+ (Windows) for data import and export.
Why does my Python script crash / behave erraticly?
You probably invoked undefined behavior. All Ocumen I/O bindings, including Python and C#, share the same high-performance library. While this makes moving your script to production easy, it also means you have to pay special attention not to invoke the APIs in forbidden ways. We highly recommend you to revisit the bundled tutorial_09_call_safety.py, which gives an introduction into the underlying issues. In short, make sure you
- never hold on to slices across Ocumen I/O calls,
- never use
0for user IDs, - never pass
Noneunless the API explicitly allows it.