{"_id":"594949e62be16d0026ec04e3","category":{"_id":"594949e62be16d0026ec04ce","version":"594949e52be16d0026ec04cd","project":"571fa55ca0acd42000af9545","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-04-26T17:29:00.405Z","from_sync":false,"order":0,"slug":"documentation","title":"Overview"},"project":"571fa55ca0acd42000af9545","parentDoc":null,"user":"571fa519db52d01700f5cf3d","version":{"_id":"594949e52be16d0026ec04cd","project":"571fa55ca0acd42000af9545","__v":2,"createdAt":"2017-06-20T16:14:29.816Z","releaseDate":"2017-06-20T16:14:29.816Z","categories":["594949e62be16d0026ec04ce","594949e62be16d0026ec04cf","594949e62be16d0026ec04d0","594949e62be16d0026ec04d1","594949e62be16d0026ec04d2","594949e62be16d0026ec04d3","594949e62be16d0026ec04d4","594949e62be16d0026ec04d5","594949e62be16d0026ec04d6","594949e62be16d0026ec04d7","594949e62be16d0026ec04d8","594949e62be16d0026ec04d9","594949e62be16d0026ec04da","594949e62be16d0026ec04db","594949e62be16d0026ec04dc","594949e62be16d0026ec04dd","594949e62be16d0026ec04de","594949e62be16d0026ec04df","594949e62be16d0026ec04e0","594949e62be16d0026ec04e1","59497219f4a8980024dd0631"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"Kunekune","version_clean":"3.2.0","version":"3.2.0"},"__v":1,"updates":["591d50b0989d340f00332a66","59f72d1cfba7fd00102710ad"],"next":{"pages":[],"description":""},"createdAt":"2016-07-31T16:45:41.517Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"> *VRTK offers a VR Simulator that works without any third party SDK, but VR device support requires a supported VR SDK to be imported into the Unity project.*\n\n## Using the example project & scenes\n\n* Download or clone vrtk.\n* Open the folder in Unity to load the project.\n* Have a look at the included example scenes.\n\nThe example scenes support all the VRTK supported VR SDKs. To make use of VR devices (besides the included VR Simulator) import the needed third party VR SDK into the project.\n\n## Using VRTK in your own project\n\n* Download or clone vrtk.\n* Import the `Assets/VRTK` folder into your Unity project.\n* Add the `VRTK_SDKManager` script to a GameObject in the scene.\n\nThe SDK Manager handles setting up everything to use the various supported SDKs via `VRTK_SDKSetup`s. To use a VR SDK the following steps are needed:\n\n* Download and import the SDK into the project.\n* Create a new empty game object.\n  * Add `VRTK_SDKSetup` to it.\n  * Add the VR SDK's game objects (e.g. the Camera Rig) as children.\n  * On the SDK Setup set the `SDK Selection` to the respective VR SDK.\n  * Make sure all the `Object References` are set correctly by `Auto Populate` or set them manually.\n* On the SDK Manager under `Setups` add a new slot and select the SDK Setup for that slot.\n\nRepeat the steps above to add additional SDK Setups to the SDK Manager.\n\nIf the `Auto Load` setting on the SDK Manager is enabled the SDK Setups are automatically loaded in the order they appear in the list:\n* The first Setup that is usable (i.e. initializable without errors and the HMD is connected) will be used.\n* If a Setup can't be used the next one will be tried instead.\n* If no Setup is usable VR support is disabled.\n\nThe SDK Manager allows switching the used SDK Setup at runtime. To add a simple overlay GUI to do so add the `SDKSetupSwitcher` prefab from `VRTK/Prefabs` to the scene.\n\nRead the rest of this document for more detailed instructions on how to set up and use the supported VR SDKs.\n\n### VR Simulator\n\n**Instructions for using the VR Simulator**\n\n* Follow the initial steps above by adding the `VRSimulatorCameraRig` prefab from `VRTK/Prefabs` as a child of the SDK Setup game object.\n* Use the Left Alt to switch between mouse look and move a hand.\n* Press Tab to switch between left/right hands.\n* Hold Left Shift to change from translation to rotation for the hands.\n* Hold Left Ctrl to switch between X/Y and X/Z axis.\n* Additional button mappings can be found on `SDK_InputSimulator` on the prefab.\n* All button mappings can be remapped using the inspector on the prefab.\n\n### SteamVR\n\n**Instructions for using SteamVR**\n\n* Import the [SteamVR Plugin](https://www.assetstore.unity3d.com/en/#!/content/32647) from the Unity Asset Store.\n* Follow the initial steps above by adding the `[CameraRig]` prefab from the plugin as a child of the SDK Setup game object.\n\n\n### Oculus\n\n**Instructions for using Oculus Utilities**\n\n* Download the [Oculus Utilities](https://developer.oculus.com/downloads/package/oculus-utilities-for-unity-5/) from the Oculus developer website.\n* Import the `.unitypackage`.\n* Follow the initial steps above by adding the `OVRCameraRig` prefab from the Utilities as a child of the SDK Setup game object.\n* On the `OVRCameraRig` in the scene find the `OVRManager` and set its `Tracking Origin Type` to `Floor Level`.\n\n\n### Ximmerse *(experimental)*\n\n**Instructions for using Ximmerse**\n\n* Download the [Ximmerse Unity SDK](https://github.com/Ximmerse/SDK/tree/master/Unity) from the Ximmerse SDK Github page.\n* Import the `.unitypackage`.\n* Follow the initial steps above by adding the `VRCameraRig` prefab from the SDK as a child of the SDK Setup game object.\n  * It is recommened to use `Floor Level` as the `Tracking Origin Type`, with the position of `VRCameraRig` set to `(0f, 0f, 0f)`. `Eye Level` can also be used, in this case it is recommended to set the position to `(0f, 1.675f, 0f)`.\n  * Make sure `SimplePicker` is **not** attached to any of the game objects `cobra02-L` and `cobra02-R`. `SimplePicker` is provided by the Ximmerse SDK but using the script may break VRTK's grab functionality.\n* Switch the build settings in `File > Build Settings...` to `Android`.\n\n> Currently Ximmerse 6DOF tracking is only supported on Android. 3DOF tracking is supported on both iOS and Android. Ximmerse are getting MFI certification from Apple at the moment.\n\n\n### Daydream *(experimental)*\n\n**Instructions for using Daydream**\n\n* Open a new or existing project in Unity that offers Daydream integration.\n* Download the [Google VR SDK](https://developers.google.com/vr/unity/download) from the Google developer website.\n* Import the `.unitypackage`.\n* Switch the build settings in `File > Build Settings...` to `Android`.\n* In `Edit > Project Settings > Player` set the following:\n  * API Level to `Nougat`.\n  * Bundle Identifier and other settings for use with Android.\n* In the `Hierarchy` window, create a new empty GameObject named `DaydreamCameraRig`.\n* Add the following as children of `DaydreamCameraRig`:\n  * A new `Camera`.\n  * The `GvrControllerPointer` prefab from `GoogleVR/Prefabs/UI`.\n  * The `GvrControllerMain` prefab from `GoogleVR/Prefabs/Controller`.\n  * The `GvrViewerMain` prefab from `GoogleVR/Prefabs` (enables the view in editor play mode).\n* Disable Daydream's native pointer tools by removing or disabling `DaydreamCameraRig/GvrControllerPointer/Laser`.\n* Follow the initial steps above by adding the `DaydreamCameraRig` object as a child of the SDK Setup game object.\n\n> Note: Daydream supports only one controller, the left scripting alias controller of VRTK will not be used.","excerpt":"","slug":"getting-started","type":"basic","title":"Getting Started"}
> *VRTK offers a VR Simulator that works without any third party SDK, but VR device support requires a supported VR SDK to be imported into the Unity project.* ## Using the example project & scenes * Download or clone vrtk. * Open the folder in Unity to load the project. * Have a look at the included example scenes. The example scenes support all the VRTK supported VR SDKs. To make use of VR devices (besides the included VR Simulator) import the needed third party VR SDK into the project. ## Using VRTK in your own project * Download or clone vrtk. * Import the `Assets/VRTK` folder into your Unity project. * Add the `VRTK_SDKManager` script to a GameObject in the scene. The SDK Manager handles setting up everything to use the various supported SDKs via `VRTK_SDKSetup`s. To use a VR SDK the following steps are needed: * Download and import the SDK into the project. * Create a new empty game object. * Add `VRTK_SDKSetup` to it. * Add the VR SDK's game objects (e.g. the Camera Rig) as children. * On the SDK Setup set the `SDK Selection` to the respective VR SDK. * Make sure all the `Object References` are set correctly by `Auto Populate` or set them manually. * On the SDK Manager under `Setups` add a new slot and select the SDK Setup for that slot. Repeat the steps above to add additional SDK Setups to the SDK Manager. If the `Auto Load` setting on the SDK Manager is enabled the SDK Setups are automatically loaded in the order they appear in the list: * The first Setup that is usable (i.e. initializable without errors and the HMD is connected) will be used. * If a Setup can't be used the next one will be tried instead. * If no Setup is usable VR support is disabled. The SDK Manager allows switching the used SDK Setup at runtime. To add a simple overlay GUI to do so add the `SDKSetupSwitcher` prefab from `VRTK/Prefabs` to the scene. Read the rest of this document for more detailed instructions on how to set up and use the supported VR SDKs. ### VR Simulator **Instructions for using the VR Simulator** * Follow the initial steps above by adding the `VRSimulatorCameraRig` prefab from `VRTK/Prefabs` as a child of the SDK Setup game object. * Use the Left Alt to switch between mouse look and move a hand. * Press Tab to switch between left/right hands. * Hold Left Shift to change from translation to rotation for the hands. * Hold Left Ctrl to switch between X/Y and X/Z axis. * Additional button mappings can be found on `SDK_InputSimulator` on the prefab. * All button mappings can be remapped using the inspector on the prefab. ### SteamVR **Instructions for using SteamVR** * Import the [SteamVR Plugin](https://www.assetstore.unity3d.com/en/#!/content/32647) from the Unity Asset Store. * Follow the initial steps above by adding the `[CameraRig]` prefab from the plugin as a child of the SDK Setup game object. ### Oculus **Instructions for using Oculus Utilities** * Download the [Oculus Utilities](https://developer.oculus.com/downloads/package/oculus-utilities-for-unity-5/) from the Oculus developer website. * Import the `.unitypackage`. * Follow the initial steps above by adding the `OVRCameraRig` prefab from the Utilities as a child of the SDK Setup game object. * On the `OVRCameraRig` in the scene find the `OVRManager` and set its `Tracking Origin Type` to `Floor Level`. ### Ximmerse *(experimental)* **Instructions for using Ximmerse** * Download the [Ximmerse Unity SDK](https://github.com/Ximmerse/SDK/tree/master/Unity) from the Ximmerse SDK Github page. * Import the `.unitypackage`. * Follow the initial steps above by adding the `VRCameraRig` prefab from the SDK as a child of the SDK Setup game object. * It is recommened to use `Floor Level` as the `Tracking Origin Type`, with the position of `VRCameraRig` set to `(0f, 0f, 0f)`. `Eye Level` can also be used, in this case it is recommended to set the position to `(0f, 1.675f, 0f)`. * Make sure `SimplePicker` is **not** attached to any of the game objects `cobra02-L` and `cobra02-R`. `SimplePicker` is provided by the Ximmerse SDK but using the script may break VRTK's grab functionality. * Switch the build settings in `File > Build Settings...` to `Android`. > Currently Ximmerse 6DOF tracking is only supported on Android. 3DOF tracking is supported on both iOS and Android. Ximmerse are getting MFI certification from Apple at the moment. ### Daydream *(experimental)* **Instructions for using Daydream** * Open a new or existing project in Unity that offers Daydream integration. * Download the [Google VR SDK](https://developers.google.com/vr/unity/download) from the Google developer website. * Import the `.unitypackage`. * Switch the build settings in `File > Build Settings...` to `Android`. * In `Edit > Project Settings > Player` set the following: * API Level to `Nougat`. * Bundle Identifier and other settings for use with Android. * In the `Hierarchy` window, create a new empty GameObject named `DaydreamCameraRig`. * Add the following as children of `DaydreamCameraRig`: * A new `Camera`. * The `GvrControllerPointer` prefab from `GoogleVR/Prefabs/UI`. * The `GvrControllerMain` prefab from `GoogleVR/Prefabs/Controller`. * The `GvrViewerMain` prefab from `GoogleVR/Prefabs` (enables the view in editor play mode). * Disable Daydream's native pointer tools by removing or disabling `DaydreamCameraRig/GvrControllerPointer/Laser`. * Follow the initial steps above by adding the `DaydreamCameraRig` object as a child of the SDK Setup game object. > Note: Daydream supports only one controller, the left scripting alias controller of VRTK will not be used.