Skip to content

Latest commit

 

History

History
80 lines (71 loc) · 5.49 KB

README.md

File metadata and controls

80 lines (71 loc) · 5.49 KB
Raw

Simple XRInput for Unity3D & whats it for

This API universalizes different vendor XR input oddities into a single easy-to-use agnostic XR-Input layer allowing you to write the bulk of your code against it then easily target multiple platforms (namely Steam, Oculus, WMR, etc) without having to deal with the endless flux of complication or fragmentation between different companies or even Unity's native input API flux. More non-standard Input sources could be added to if needed making it so you don't need to modify Input systems scattered around in your projects down the road.

How to setup

  • NOTE: If you have "Initialize XR on Startup" off & manually create a loader instance, you may need to pass that instance to "XRInput.loaderOverride".
  • Drop 'Unity3D-XRInput/Assets/Reign/XRInput/XRInput' prefab into scene & thats it.
  • Select Input type and ready to go!

'Oculus' setup

  • Import integration 'Oculus Integration'
  • In OculusXRFeatureEnabler class disable "EditorApplication.update += EnableOculusXRFeature;" (this can be annoying)

'SteamVR' setup

  • Ensure 'com.valvesoftware.unity.openvr' .tgz file is installed via Unity package manager for OpenVR input mode
  • NOTE: In 'Packages/manifest.json' you can set packages to be relitive paths like so: "file:../com.some-package.tgz"'
  • NOTE: SteamVR Plugin must NOT be installed for OpenVR_Legacy Input mode to work!
  • NOTE: If SteamVR Plugin is installed follow these steps for OpenVR Input mode to work!
    • Create a new folder: "Assets/StreamingAssets/SteamVR/Original"
    • Move all .json files into "Original" folder
    • Copy all .json files from "Assets/StreamingAssets/OpenVR/" to "Assets/StreamingAssets/SteamVR/"
    • In the "SteamVR" folder, rename "reign_actions.json" to "actions.json"
    • Make sure "Steam Plugin In Use" is checked on in the XRInput script in your scene
  • OpenXR with Cosmos controllers (NOTE: bumpers don't work in OpenXR mode)
    • Download interaction profile here
    • Install "com_htc_upm_vive.openxr.controllers-x.x.x.tgz" in Unity's package manager
    • NOTE: In 'Packages/manifest.json' you can set packages to be relitive paths like so: "file:../com.some-package.tgz"'
    • NOTE: Unity bug: do not try adding the profile in Unity's UI or it breaks the settings file & you may then have to delete it
    • Open "Open XR Package Settings.asset" in VS-Code & find "nameUi: HTC Vive Cosmos Controller Support"
    • Set "m_enabled: 1" to enable it
    • NOTE: if this doesn't work delete the settings file & try again
    • You should now see the profile in Unity's settings UI & can add other profiles as normal

'Windows Mixed Reality' setup

  • Download and open 'MixedRealityFeatureTool'
  • In the app follow navigation steps...
    • Click: Start
    • Select root Unity3D project path & click 'Discover Features'
    • Expand 'Platform Support' & check 'Mixed Reality OpenXR Plugin'
    • Click 'Get Features' & close when done
  • In Unity's OpenXR settings: Add 'Microsoft Motion Controller Profile' & 'HP Reverb G2 Controller Profile'

'HTC VIVE Focus 3' setup

'Pico 2' setup

  • Use legacy 'PicoVR Unity SDK' plugin NOT 'Unity Integration SDK' plugin
  • Extract 'PicoVR_Unity_SDK.zip' in a folder
  • Import "64bit" version of the unitypackage
  • In Pvr_SDKSetting disable "EditorApplication.update += Update;" (this can cause issues)
  • NOTE: Enable/Disable Pico2 so it doesn't conflict with other devices:
    • Change Plugins/Android/AndroidManifest.xml to PICO2_AndroidManifest.xml
    • Disable Plugins/Android/Pico_PaymentSDK_Android_V1.0.24.jar
    • Disable Plugins/Android/libs/pvrSDK-release.aar
  • NOTE: Legacy docs: https://sdk.picovr.com/docs/sdk/en/chapter_one.html

'Pico 3 & 4' setup

  • Use 'Unity Integration SDK' plugin NOT legacy 'PicoVR Unity SDK' plugin
  • Extract 'PICO Unity Integration SDK.zip' in a folder
  • Move extracted folder to "<Your-Proj>/Packages"
  • You should now see 'PicoXR' in Unity's standard XR managment area

How to get Input

  • Take a look at 'Unity3D-XRInput/Assets/Reign/XRInput/Example/TestAssets/TestInput.cs' for basic working example
  • You can get Input in multiple ways
    • Get full input state of controller: XRInput.ControllerState(...)
    • Get specific input state of controller: XRInput.ButtonTrigger(...), XRInput.Button1(...), etc
    • Get specific input state via callbacks: ButtonTriggerOnEvent, ButtonTriggerDownEvent, Button1DownEvent, etc

Android: See Input in Example scene

  • Run: adb logcat -s Unity ActivityManager PackageManager dalvikvm DEBUG