w1ndy / VRTK-Windows-MR-Extension

Extension for VRTK to include Windows Mixed Reality controller visualization with GLTF

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

VRTK-Windows-MR-Extension

Extension for Virtual Reality Toolkit to include Windows Mixed Reality Controller visualization.

How To Use

Simply add this repository to your VRTK Unity project which includes the latest VRTK. Find a unity package and ZIP in releases or add this repository as a submodule.

Note: There are known issues when downloading this repository as a ZIP through the Clone or download button. Apparently github marks all DLLs as unsafe so they won't be recognized in Unity.

Important: When building for IL2CPP make sure to move the folder UWP and all it's content to the top level of your Unity project (next to Assets).

Example project structure:

+-- Assets
|	+-- Extensions
|	|   +-- VRTK
|	|   +-- VRTK-Windows-MR-Extension
|	+-- Folder_1
|	+-- Folder_2
|	...
+-- UWP

NOTE: VRTK will check for a script included in this repository and adds a Scripting Predefine Symbol (VRTK_DEFINE_WINDOWSMR_CONTROLLER_VISUALIZATION) if found. If you encounter unexpected behaviour make sure the Predefine Symbol is added in the Player Settings.

If missing, add the MotionControllerVisualization component to the ControllerManager which is part of the WindowsMR SDKSetup.

What is included

  • Functionality to visualize Windows Mixed Reality Motion Controllers in Editor and Build
  • glTF which is used to load models at runtime
  • This repository mostly includes altered components from Microsoft Mixed Reality Toolkit to fit VRTK

Why is this not included in VRTK

This repository holds a lot of Windows specific code which people who want to use VRTK may not ever use, e.g. when they just want to use Oculus or SteamVR. An SDK in VRTK is always dependent on a vendor SDK package to be installed, but that's about it. For Oculus models to show up you actually need to also import Oculus Avatar, but VRTK works fine without Avatar being imported. The same is done with this repository since there is no native solution by Microsoft.

About

Extension for VRTK to include Windows Mixed Reality controller visualization with GLTF

License:MIT License


Languages

Language:C# 83.9%Language:HLSL 11.4%Language:ShaderLab 4.8%