> For the complete documentation index, see [llms.txt](https://unity.progdocs.se/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unity.progdocs.se/tillaeggspaket/xr-toolkit.md).

# XR Toolkit

*Uppdaterat för XR Toolkit 2.6.3*

XR Toolkit är Unitys officiella sätt att arbeta med VR och liknande. Förhoppningsvis är det lite mer stabilt och långsiktigt än att köra med något fristående ramverk eller bibliotek, till exempel VRTK.

*De här instruktionerna har testats i Unity 2022.3 men bör fungera även med lite tidigare versioner.*

**Termer**

* **VR-headset:** Den "hjälm" man sätter på huvudet för att se VR-världen.
* **VR-handkontroll:** De fysiska apparater man håller i respektive hand för att styra saker i VR-världen.

## Setup

Utgå från ett vanligt 3D-projekt.

Gå till [Package manager](/andra-funktioner/package-manager.md), installera:

* **XR Plugin Management**
* **XR Interaction Toolkit**
  * Under **Samples**, installera:
    * **Starter Assets**
    * **XR Interaction Simulator** ([för att testa utan tillgång till ett VR-headset](/tillaeggspaket/xr-toolkit/device-simulator.md))
* **Unity OpenXR Meta** (om du tänkt arbeta med Quest 2/3)

### XR Plugin management

Gå till Project settings.

* **XR Plugin Management**
  * Kryssa i OpenXR och Meta Quest feature group
* **OpenXR**
  * Enabled Interaction Profiles
    * Logg till **Oculus Touch Controller Profile**, om du jobbar mot Quest 2/3

### Enkel scen-setup

Ta bort din Main Camera från scenen.

Sök i Assets efter "xr origin" och dra ut en instans av **XR Origin (XR Rig)** till scenen. Den prefaben finns annars i mappen Samples→XR Interaction Toolkit→\[version]→Starter Assets→Prefabs. Fördelen med att använda denna prefab är att man får med nästan allt man behöver direkt från början. Nackdelen är att man kanske inte gillar hur det fungerar…

Den kommer att fungera som mittpunkten som VR-trackingen utgår från. Placera den där du vill att spelaren ska börja, och tänk att den ligger på golvet mellan spelarens ben.

## Rekommenderade justeringar

XR Origin-riggen har ett par standardgrejer som kan upplevas som jobbiga eller opassande för många vana VR-användare – t.ex. har den inte bara teleportation inbyggd utan också åksjukekontroller (möjligheten att flytta sig i VR-världen genom att dra i vänster handkontrolls styrspak). Den har också strålar som utgår från båda handkontrollerna kontinuerligt och som kan användas för att interagera med saker i spelvärlden, där standard snarare är att man bara kan interagera med saker man kan röra vid.

* För att stänga av åksjuke-kontrollerna: Gå in under **XR Origin (XR Rig) → Locomotion** och ta bort eller stäng av child-objektet **Move**.
* För att stänga av fjärrmanipulering: Gå in under **XR Origin (XR Rig) → Camera Offset → Left Controller** och plocka bort child-objektet **Ray Interactor.**

## Manuell scen-setup

De här instruktionerna ger dig en mer avskalad setup – du måste själv lägga in locomotion och annat.

Ta bort scenens Main Camera.

Lägg in en **XR Interaction Manager** i scenen (GameObject → XR → Interaction Manager).

Lägg in en **XR Origin** i scenen (GameObject → XR → XR Origin (VR)).

Expandera XR Origin och dess Camera Offset och markera LeftHand Controller. Klicka på "Select Preset" (<img src="https://3098195724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJTeBJlEweD3YcPwKkg%2Fuploads%2FZGgaeGmmQsyb3Diw2shm%2Fimage.png?alt=media&amp;token=1a7dbc2f-f1e6-4006-b246-519d9c8fb619" alt="" data-size="line">) och välj **XRI Default Left Controller**. Gör samma sak för RightHand Controller, men där väljer du **XRI Default Right Controller**.