VRTK GearVR Test

---

Warning! This repository is no longer maintained.

Details below refer to an old version of VRTK (3.3.0-alpha branch, January 2018).

---

This is a repository for testing Virtual Reality Toolkit (VRTK) on GearVR (see VRTK description below, in the next section).

This is a totally separate repository and isn't representative of any work currently being carried out on VRTK.

Everything here works with the GearVR D-Pad only, it is designed just to enable a gaze-based interaction without a gamepad or controller. If using a controller you probably don't need this: the GearVR controller can work with VRTK (see this video by @thestonefox https://github.com/thestonefox [ https://www.youtube.com/watch?v=ma2AetALN_k]), it is mapped on Touchpad.

Minimum Unity version is 5.5.4.

Oculus package must be added installing OculusUtilities.

You can find instructions here.

In Assets\VRTK_GearVR_Test here are 5 scenes to be tested with GearVR:

• template basic scene (000_Template_BasicScene_GearVR)
• object touching and grabbing (005_Controller_BasicObjectGrabbing_GearVR)
• interaction with Unity UI (034_Controls_InteractingWithUnityUI_GearVR)
• controlling movements with GearVR D-Pad (015_Controller_TouchpadAxisControl_GearVR)
• teleport (044_CameraRig_RestrictedTeleportZones_GearVR)

Note: Before building on your Android device, you must copy special OSIG file additions (oculussig_*) to Assets/Plugins/Android/Assets/

____

VRTK - Virtual Reality Toolkit

A productive VR Toolkit for rapidly building VR solutions in Unity3d.

Supported SDK	Download Link
UnityEngine.VR	Core Unity3d library
VR Simulator	Included
SteamVR	SteamVR Plugin
Oculus	Oculus Utilities
* Ximmerse	Ximmerse Unity SDK
* Daydream	Google VR SDK for Unity
* HyperealVR	Hypereal VR Unity Plugin

* experimental

Documentation

The API documentation for the project can be found within this repository in API.md which includes the up to date documentation for this GitHub repository.

Alternatively, the stable versions of the documentation can be viewed online at http://docs.vrtk.io.

Frequently Asked Questions

If you have an issue or question then check the FAQ.md document to see if your query has already been answered.

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.

• Download or clone this repository.
• 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.

For further information about setting up a specific SDK and using VRTK in your own project, check out the GETTING_STARTED.md document.

What's In The Box

VRTK is a collection of useful scripts and concepts to aid building VR solutions rapidly and easily in Unity3d 5+.

It covers a number of common solutions such as:

• Locomotion within virtual space.
• Interactions like touching, grabbing and using objects
• Interacting with Unity3d UI elements through pointers or touch.
• Body physics within virtual space.
• 2D and 3D controls like buttons, levers, doors, drawers, etc.
• And much more...

Examples

A collection of example scenes have been created to aid with understanding the different aspects of VRTK.

A list of the examples can be viewed in Examples/README.md which includes an up to date list of examples showcasing the features of VRTK.

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.

Made With VRTK

Many games and experiences have already been made with VRTK.

Check out the MADE_WITH_VRTK.md document to see the full list.

Contributing

I would love to get contributions from you! Follow the instructions below on how to make pull requests.

For the full contribution guidelines see the CONTRIBUTING.md document.

Pull requests

1. Fork the project, clone your fork, and configure the remotes.
   1. If you're submitting a bug fix or refactor pull request then target the repository master branch.
   2. If you're submitting a new feature or enhancement that changes functionality then target the next release branch in the repository (which is currently 3.3.0-alpha).
2. Commit your changes in logical units.
3. Make sure all the example scenes are still working.
4. Push your topic branch up to your fork.
5. Open a Pull Request with a clear title and description.

License

Code released under the MIT License.

Any Third Party Licenses can be viewed in THIRD_PARTY_NOTICES.md.