com.rwth.unity.omilaxr
v2.0.10
Published
This is the base package for OmiLAXR ecosystem. This package has shareable code for all OmiLAXR packages.
Downloads
337
Readme
OmiLAXR (v2)
This is the base package for OmiLAXR holding all core components of the pipeline pattern. Starting from this package you can install further modules (packages) based on your needs.
Just drag and drop the prefab Resources/Prefab/OmiLAXR
into your scene.
Compatibility
Because of the less dependencies and modular design of OmiLAXRv2 this framework is compatible with all XR frameworks. It doesnt matter if you use MRTK, VRTK, SteamVR, UnityXR, ... and it doesnt matter what equipment you use.
You can look for existing modules tracking the behaviour you need. The rest can be easily implemented by you own - and we hope you will share it with the community!
The only thing we need to consider are the Unity version. We try to support as much as possible upwards of Unity 2019.4.40f1. You are invited to contribute!
The compatibility was tested on
- [ ] Unity 2019.4.40f1 (LTS)
- [X] Unity 2020.3.48f1 (LTS)
- [X] Unity 2021.3.15f1 (LTS)
- [X] Unity 2021.3.45f1 (LTS)
- [X] Unity 2022.3.52f1 (LTS)
- [X] Unity 2023.2.20f1 (no LTS)
- [X] Unity 6000.0.25f1 (LTS)
Please contact us on https://discord.gg/yJgk4ATg if it is not running on your Unity version. We will try to make it possible.
Module dependencies
The adapter has following third-party dependencies attached:
TextMeshPro
: We use this package to detect text of ui elements like buttons.Newtonsoft.JSON
: Is used for (de-)serialize JSON files.
Install by using scoped registry
- Ensure in "Project settings" > "Package Manager" that you have the scoped registry with following settings:
- Name: npmjs
- URL: http://registry.npmjs.com
- Scope(s):
com.rwth.unity.omilaxr
- Go to Package Manager.
- Click on the (+) button.
- Select 'Add package by name'.
- Place in 'Name' field:
com.rwth.unity.omilaxr
.
Adding scoped registry by using manifest.json (also recommended - quick way)
- Alternatively, instead of adding the scoped registry inside Unity editor you can do it by using
manifest.json
file. - Go to you project root and then open
Packages/manifest.json
. - Ensure following entries in your file:
"scopedRegistries": [ { "name": "npmjs", "url": "http://registry.npmjs.com/", "scopes": [ "com.rwth.unity.omilaxr" ] }]
. - Go to the Unity Package Manager to
My registries
and install the packagecom.rwth.unity.omilaxr
.
Install by using Git url
- Go to Package Manager.
- Click on the (+) button.
- Select 'Add package from git URL'.
- Paste
https://gitlab.com/learntech-rwth/omilaxr-ecosystem/v2/heart-rate/omilaxr.hyperate.git
and confirm.
For Developers
To work with this package we recommend to place it somewhere outside your Unity project (if the package gets an own git repository) or in root of your project.
Than, you can include the package into your project by going to Window > Package Manager
, click on (+)
button and finally import the package.json
of this project by clicking on Add package from disk
.
For production use we recommend to use Add package form git URL
or using scoped registries (see below).
Default Folder Structure
Here you can see the default structure of the adapter unity packages. The folders surrounding with (FOLDER) are not delivered by default.
- root
- (Editor)
- Plugins
- Resources
- Prefabs
- StreamingAssets
- ...
- Runtime
- Actors
- Composers
- HigherComposers
- Endpoints
- Extensions
- Filters
- Hooks
- Listeners
- Pipelines
- TrackingBehaviours
- Tests
- Runtime
- (Editor)
Publication
You can publish your package at any npm registry.
It makes sense to publish packages for easier distribution in other projects.
But we recommend to use npmjs.com
. Here you can get more details.
But the steps are very easy.
- Create an account on
npmjs.com
. - On demand increase your
version
number inpackage.json
. - Commit and push your changes.
- Open a terminal.
- Go to the root of your project.
- Run
npm login
and login via browser (or what else you like). - Run
npm publish --access public
. - Wait until publication is ready.