[![Tilia logo][Tilia-Image]](#)

> ### CameraRigs -> UnityXR
> A camera rig prefab utilizing the legacy XR management system for the Unity software.

[![Release][Version-Release]][Releases]
[![License][License-Badge]][License]
[![Backlog][Backlog-Badge]][Backlog]

## Introduction

The UnityXR camera rig provides a basis for a spatial camera rig that tracks a HMD and up to two controllers (left/right) utilizing the built in SDK support by the [Unity] software.

This is built upon the [legacy XR management system] within previous versions of the Unity software that was deprecated in Unity `2019.3.0f1` and replaced with the newer Unity [XR Plugin Framework].

See the [Tilia.CameraRigs.XRPluginFramework.Unity] repository for a camera rig that utilizes this newer Unity XR Plugin Framework.

> **Requires** the Unity software version `2018.3.10f1` (or above).

## Getting Started

Please refer to the [installation] guide to install this package.

## Documentation

Please refer to the [How To Guides] for usage of this package.

Further documentation can be found within the [Documentation] directory and at https://academy.vrtk.io

## Contributing

Please refer to the Extend Reality [Contributing guidelines] and the [project coding conventions].

## Code of Conduct

Please refer to the Extend Reality [Code of Conduct].

## License

Code released under the [MIT License][License].

[License-Badge]: https://img.shields.io/github/license/ExtendRealityLtd/Tilia.CameraRigs.UnityXR.svg
[Version-Release]: https://img.shields.io/github/release/ExtendRealityLtd/Tilia.CameraRigs.UnityXR.svg
[project coding conventions]: https://github.com/ExtendRealityLtd/.github/blob/master/CONVENTIONS/UNITY3D.md

[Tilia-Image]: https://raw.githubusercontent.com/ExtendRealityLtd/related-media/main/github/readme/tilia.png
[License]: LICENSE.md
[Documentation]: Documentation/
[How To Guides]: Documentation/HowToGuides/
[Installation]: Documentation/HowToGuides/Installation/README.md
[Backlog]: http://tracker.vrtk.io
[Backlog-Badge]: https://img.shields.io/badge/project-backlog-78bdf2.svg
[Releases]: ../../releases
[Contributing guidelines]: https://github.com/ExtendRealityLtd/.github/blob/master/CONTRIBUTING.md
[Code of Conduct]: https://github.com/ExtendRealityLtd/.github/blob/master/CODE_OF_CONDUCT.md

[Unity]: https://unity3d.com/
[legacy XR management system]: https://docs.unity3d.com/2018.3/Documentation/Manual/VROverview.html
[XR Plugin Framework]: https://docs.unity3d.com/2019.3/Documentation/Manual/XR.html
[Tilia.CameraRigs.XRPluginFramework.Unity]: https://github.com/ExtendRealityLtd/Tilia.CameraRigs.XRPluginFramework.Unity