Releases: microsoft/MixedRealityToolkit-Unity
HoloToolkit 2017.4.2.0
Project board: https://github.com/Microsoft/MixedRealityToolkit-Unity/projects/15
Upgrade Guide
Attention!
- This release is targeted for the Unity 2017.x products
- The recommended Editor version is 2017.4 LTS (Long Term Support)
- This release should be compatible for development for both HoloLens & immersive headsets for 2017.2+
- Windows SDK 10.0.17134 is required for 2017.2+
- Visual Studio 2017 is required.
- Fall Creators Update or later is required.
- When upgrading to this release, delete all toolkit folders before importing the package.
What's New
- (#2638) Updated drop of UnityGLTF with the correct coordinate space
- (#2872) QR Code Tracking (preview)
Preview Features
- (#1867) Spectator View (share holograms with HoloLens and iOS devices)
- (#2327) Spectator View multilens support
- (#2872) QR Code Tracking
Import HoloToolkit-Unity-Preview-2017.4.2.0.unitypackage to include SpectatorView or QR Code Tracking in your project.
Fixes
- (#2438) Spectator View Stuck
- (#2487) Resolved rotation issue in TwoHandManipulatable script
- (#2523) The indicator line of the motion controllers does not coincide with the starting point of the ray
- (#2526) ObjectCollection doesn't behave as expected with non-zero rotation
- (#2666) Fix HTK pointer debug rays
- (#2669) Pointing ray doesn't properly disable itself when switching to an unsupported controller model
- (#2670) Fix pointer line visibility when switching the active controller
- (#2898) Add rotated transform to Solvers after glTF coordinate system update
Known issues
The following items are known and currently being investigated.
Mixed Reality Toolkit Unity vNext 2018.8.0.0 Alpha 2 (MR Dev Summit)
Release Notes
- This pre-release is not feature complete.
- Requires Unity 2018.1 or later
- Recommended version: 2018.1.9f1
- This product uses C# 6 language features.
- Use the ".NET 4.x" API Compatibility Level
- To build for Windows Mixed Reality, set
- Platform == Universal Windows Platform
- Select Windows Mixed Reality as the Virtual Reality SDK
- To build for Open VR, set
- Platform== PC, Mac & Linux Standalone
- Select OpenVR as the Virtual Reality SDK
What's New?
- Features
- Input and Intereaction system
- Teleportation
- Pointing rays (straight and parabolic)
- Boundary system
- Automatic floor, tracked area and play area display
- Optional boundary wall and ceiling display
- Devices Supported:
- Windows Mixed Reality
- OpenVR
Mixed Reality Toolkit vNext Alpha v2018.7.0.0
Release Notes
- This pre-release is not feature complete.
- Requires Unity 2018.1 or later
- Recommended version: 2018.1.9f1
- This product uses C# 6 language features.
- Use the ".NET 4.x" API Compatibility Level
- To build for Windows Mixed Reality, set
- Platform == Universal Windows Platform
- Select Windows Mixed Reality as the Virtual Reality SDK
- To build for Open VR, set
- Platform== PC, Mac & Linux Standalone
- Select OpenVR as the Virtual Reality SDK
What's New?
- New MRTK Architecture
- Core / Device Abstraction Layer
- SDK layer
- Features
- Input and Intereaction system
- Teleportation
- Pointing rays (straight and parabolic)
- Boundary system
- Automatic floor and play area display
- Devices Supported:
- Windows Mixed Reality
- OpenVR
Known Issues
- When teleporting, the play area visualization does not move with the user
- Some controller options do not work correctly on OpenVR
- Actual controller models/GLTF support is not currently provided
HoloToolkit 2017.4.1.0
Project board: https://github.com/Microsoft/MixedRealityToolkit-Unity/projects/9
Upgrade Guide
Attention!
- This release is targeted for the Unity 2017.x products
- The recommended Editor version is 2017.4 LTS (Long Term Support)
- This release should be compatible for development for both HoloLens & immersive headsets for 2017.2+
- The recommended minimum Editor version is 2017.1 (we will investigate reported issues on Unity 5.6).
- Windows SDK 10.0.17134 is required for 2017.2+
- Visual Studio 2017 is required.
- Fall Creators Update is required.
- When upgrading to this release, delete all toolkit folders before importing the package.
What's New
- (#2228) In Between Solver that keeps an object between two tracked objects/transforms
- (#2314) Better example for custom Icons for AppBar
- (#2327) Spectator View multilens support [preview]
- (#2343) Make the CompoundButtonSpeech.cs available and add CompoundButtonEventTrigger.cs to attach an event to the keyword recognized through speech
- (#2403) Add inscribed rectangle to BoundaryManager
- (#2467) Add "Add the Spatial Mapping Prefab" to the scene configuration window
Preview Features
- (#1867) Spectator View (share holograms with HoloLens and iOS devices)
- (#2327) Spectator View multilens support
Import HoloToolkit-Unity-Preview-2017.4.1.0.unitypackage to include SpectatorView in your project.
Fixes
- (#1181, #2362) MixedRealityTeleport teleport position is abnormal
- (#1535) Crash calling Dismiss() on PopupMenu if rootAnimator is null
- (#1679) DebugLog of CanShareAnchors is wrong
- (#1712) Slider range not properly working
- (#1879, #2524) OnButtonClicked is triggered twice on an AirTap
- (#2021) TwoHandManipulatable script moves objects even if OneHandMovement option is unchecked
- (#2040) PopupMenu: 'IsModal' and 'CloseOnNonTargetedTap' options don't work correctly
- (#2042) Bounding Box and App Bar not working as expected for Rectangular Holograms
- (#2071) Configuration menu getting reordered after use
- (#2165) Spectator View Build Warnings
- (#2214) If platform is not previously set to UWP, project settings not applied correctly
- (#2217) Fixed a bug where solvers would try to attach to the right hand before it was ready
- (#2225) SpectatorView prevents Standalone (and any other platform where
Handheld
doesn't exist) builds - (#2227) Fixing a bug the causes FaceOrigin collections to face the wrong direction when collections are rotated.
- (#2242, #2522) Toolkit keyboard keys and system keyboard logic updates
- (#2276) "Sharing with UNET" example - Anchor isn't shared with Client
- (#2294) Interactive mesh cursor default distance set to 0
- (#2295) Button class does not block events from reaching fallbackInputStack
- (#2300) MoveToPosition.TargetObject continues to target its own game object instead of the target
- (#2303) Hololens Unet client places anchor at headset position
- (#2324) Mesh transform not preserved when used as room model
- (#2348) Fix for choosing closest grabbable object to grab
- (#2349) Fix for dragging of rotation handles of BoundBoxRig
- (#2356) Fixes an InteractionInputSource bug where data was removed too soon
- (#2380) Billboard.cs up vector fix
- (#2394) Misusing of static class ExtensionMethods
- (#2470) Spectator View (Preview) - Can't build for iOS
Known issues
The following items are known and currently being investigated.
HoloToolkit 2017.4.0.0
Project board: https://github.com/Microsoft/MixedRealityToolkit-Unity/projects/8
Upgrade Guide
Attention!
- This release is targeted for the Unity 2017.x products
- The recommended Editor version is 2017.4 LTS (Long Term Support)
- This release should be compatible for development for both HoloLens & immersive headsets for 2017.2+
- The recommended minimum Editor version is 2017.1 (we will investigate reported issues on Unity 5.6).
- Windows SDK 10.0.17134 is required for 2017.2+
- Visual Studio 2017 is required.
- Fall Creators Update is required.
- When upgrading to this release, delete all toolkit folders before importing the package.
Fixed Since 2017.4.0.0 Release Candidate 2
- (#1940) XAML: HoloToolkit triggers own and system keyboard
- (#2166) Can I Change length of Motion Controller pointing ray when if lost focus from a object?
- (#2208) A few issues with the Build Window
- (#2210) Keyboard dictation input fixes
- (#2215) [Cursor] Properly track sources that were detected before registering as a global listener
What's New
- (#1275, #1277) Motion Controller pointing ray
- (#1918) Dialog and Progress UI
- (#1936) ToolTip UX
- (#1991) Automatically set the default Spatial Mapping Physics Layer (configuration dialog)
- (#1994) ManipulationMode is now public in TwoHandManipulatable
- (#2037) BoundingBox activation events
- (#2043) Materials and Prefabs for additional Selawik font weights
- (#2066) SimpleSinglePointerSelector can connect pointer upon OnSourceDetected
Preview Features
- (#1867) Spectator View (share holograms with HoloLens and iOS devices)
Import HoloToolkit-Unity-PreviewFeatures-2017.4.0.0.unitypackage to include SpectatorView in your project.
Fixes
- (#917, #1169, #1979) Cannot erase all content of KeyboardInputField
- (#1443) Spatial Mapping Physics Layer isn't visible in MRTK project's layer
- (#1790) FadeManager Assertion Failed on Holographic Remoting
- (#1824) Cannot test whether grip position can be obtained from a WSA hand
- (#1887) Button.cs ButtonState is incorrect
- (#1913) FpsDisplay.cs calls InitBuffer every Update
- (#1921) Eliminate deprecated API popups (Unity 2017.x)
- (#1927) Keyboard Input field Backspace/Cursor position incorrect
- (#1935) Headset Adjustment scene
- (#1978) Caret not showing in MRTK Keyboard input field
- (#1983) Cursor.prefab is missing the point light off holograms
- (#1994) Cannot change TwoHandManipulable.ManipulationMode at runtime
- (#2006) remove TextMesh required component in FpsDisplay
- (#2009) BoundingBoxGizmoExample NullReferenceException
- (#2019) HolographicButton: Animator is not playing an AnimatorController
- (#2053) NullReferenceException in ControllerFinder.OnEnable
- (#2062) Update UpgradeGuide.md
- (#2073) Solver Body Lock null refs if the tracked object isn't present
- (#2103) Allow Unsafe Code not auto-checked correctly
- (#2113) Surface Magnetism + Spatial Processing example scene improvement
- (#2120) Set KeyboardAtlas as default (fix symbol characters in MRTK keyboard)
- (#2124) Build warnings with IL2CPP in 2017+
- (#2131) Grip position not reported for in-Editor hands
- (#2157) Tooltip example scene's labels position
- (#2166) Can I Change length of Motion Controller pointing ray when if lost focus from a object?
- (#2170) SpectatorView - HoloLens camera doesn't activate when iPhone tries to join
- (#2208) A few issues with the Build Window
- (#2210) Keyboard dictation input fixes
- (#2215) [Cursor] Properly track sources that were detected before registering as a global listener
Known issues
The following items are known and currently being investigated.
2017.4.0.0 Release Candidate 2
This is the second release candidate for Mixed Reality Toolkit - Unity 2017.4.0.0.
Project board: https://github.com/Microsoft/MixedRealityToolkit-Unity/projects/8
Attention!
- This release is targeted for the Unity 2017.x products
- This release should be compatible for development for both HoloLens & immersive headsets for 2017.2+
- The recommended minimum Editor version is 2017.1 (we will investigate reported issues on Unity 5.6).
- Windows SDK 10.0.17134 is required for 2017.2+
- Visual Studio 2017 is required.
- Fall Creators Update is required.
- When upgrading to this release, delete all toolkit folders before importing the package.
Fixed Since 2017.4.0.0 Release Candidate
- (#1790) FadeManager Assertion Failed on Holographic Remoting
- (#2062) Update UpgradeGuide.md
- (#2124) Build warnings with IL2CPP in 2017+
- (#2157) Tooltip example scene's labels position
- (#2170) SpectatorView - HoloLens camera doesn't activate when iPhone tries to join
What's New
- (#1275, #1277) Motion Controller pointing ray
- (#1918) Dialog and Progress UI
- (#1936) ToolTip UX
- (#1991) Automatically set the default Spatial Mapping Physics Layer (configuration dialog)
- (#1994) ManipulationMode is now public in TwoHandManipulatable
- (#2037) BoundingBox activation events
- (#2043) Materials and Prefabs for additional Selawik font weights
- (#2066) SimpleSinglePointerSelector can connect pointer upon OnSourceDetected
Preview Features
- (#1867) Spectator View (share holograms with HoloLens and iOS devices)
Import HoloToolkit-Unity-PreviewFeatures-2017.4.0.0-rc2.unitypackage to include SpectatorView in your project.
Fixes
- (#917, #1169, #1979) Cannot erase all content of KeyboardInputField
- (#1443) Spatial Mapping Physics Layer isn't visible in MRTK project's layer
- (#1790) FadeManager Assertion Failed on Holographic Remoting
- (#1824) Cannot test whether grip position can be obtained from a WSA hand
- (#1887) Button.cs ButtonState is incorrect
- (#1913) FpsDisplay.cs calls InitBuffer every Update
- (#1921) Eliminate deprecated API popups (Unity 2017.x)
- (#1927) Keyboard Input field Backspace/Cursor position incorrect
- (#1935) Headset Adjustment scene
- (#1978) Caret not showing in MRTK Keyboard input field
- (#1983) Cursor.prefab is missing the point light off holograms
- (#1994) Cannot change TwoHandManipulable.ManipulationMode at runtime
- (#2006) remove TextMesh required component in FpsDisplay
- (#2009) BoundingBoxGizmoExample NullReferenceException
- (#2019) HolographicButton: Animator is not playing an AnimatorController
- (#2053) NullReferenceException in ControllerFinder.OnEnable
- (#2062) Update UpgradeGuide.md
- (#2073) Solver Body Lock null refs if the tracked object isn't present
- (#2103) Allow Unsafe Code not auto-checked correctly
- (#2113) Surface Magnetism + Spatial Processing example scene improvement
- (#2120) Set KeyboardAtlas as default (fix symbol characters in MRTK keyboard)
- (#2124) Build warnings with IL2CPP in 2017+
- (#2131) Grip position not reported for in-Editor hands
- (#2157) Tooltip example scene's labels position
- (#2170) SpectatorView - HoloLens camera doesn't activate when iPhone tries to join
Breaking changes
This release re-breaks #1940, in order to restore the keyboard caret (#2132). A fix is being investigated.
Known issues
The following items are known and currently being investigated.
2017.4.0.0 Release Candidate
This is a release candidate for Mixed Reality Toolkit - Unity 2017.4.0.0.
Project board: https://github.com/Microsoft/MixedRealityToolkit-Unity/projects/8
Attention!
- This release is targeted for the Unity 2017.x products
- This release should be compatible for development for both HoloLens & immersive headsets for 2017.2+
- The recommended minimum Editor version is 2017.1 (we will investigate reported issues on Unity 5.6).
- Windows SDK 10.0.17134 is required for 2017.2+
- Visual Studio 2017 is required.
- Fall Creators Update is required.
- When upgrading to this release, delete all toolkit folders before importing the package.
What's New
- (#1275, #1277) Motion Controller pointing ray
- (#1867) Spectator View (share holograms with HoloLens and iOS devices)
- (#1918) Dialog and Progress UI
- (#1936) ToolTip UX
- (#1991) Automatically set the default Spatial Mapping Physics Layer (configuration dialog)
- (#1994) ManipulationMode is now public in TwoHandManipulatable
- (#2037) BoundingBox activation events
- (#2043) Materials and Prefabs for additional Selawik font weights
- (#2066) SimpleSinglePointerSelector can connect pointer upon OnSourceDetected
Fixes
- (#917, #1169, #1979) Cannot erase all content of KeyboardInputField
- (#1443) Spatial Mapping Physics Layer isn't visible in MRTK project's layer
- (#1824) Cannot test whether grip position can be obtained from a WSA hand
- (#1887) Button.cs ButtonState is incorrect
- (#1913) FpsDisplay.cs calls InitBuffer every Update
- (#1921) Eliminate deprecated API popups (Unity 2017.x)
- (#1927) Keyboard Input field Backspace/Cursor position incorrect
- (#1935) Headset Adjustment scene
- (#1978) Caret not showing in MRTK Keyboard input field
- (#1983) Cursor.prefab is missing the point light off holograms
- (#1994) Cannot change TwoHandManipulable.ManipulationMode at runtime
- (#2006) remove TextMesh required component in FpsDisplay
- (#2009) BoundingBoxGizmoExample NullReferenceException
- (#2019) HolographicButton: Animator is not playing an AnimatorController
- (#2053) NullReferenceException in ControllerFinder.OnEnable
- (#2073) Solver Body Lock null refs if the tracked object isn't present
- (#2103) Allow Unsafe Code not auto-checked correctly
- (#2113) Surface Magnetism + Spatial Processing example scene improvement
- (#2120) Set KeyboardAtlas as default (fix symbol characters in MRTK keyboard)
- (#2131) Grip position not reported for in-Editor hands
Breaking changes
This release re-breaks #1940, in order to restore the keyboard caret (#2132). A fix is being investigated.
Known issues
The following items are known and currently being investigated.
2017.2.1.4 Patch Release
Project board: https://github.com/Microsoft/MixedRealityToolkit-Unity/projects/7
Upgrade Guide
Attention!
- This release is specifically targeted for Unity Editor-2017.2.1p2
- This release should be compatible for development for both HoloLens & immersive headsets for 2017.2+
- Minimum Editor Compatibility for Unity 5.6 for HoloLens development ONLY.
- Windows SDK 10.0.16299 is required for 2017.2+
- Visual Studio 2017 is required.
- Fall Creators Update is required.
- When upgrading to this release, delete all toolkit folders before importing the package.
Fixed since 2017.2.1.4 Release Candidate 2
- (#1958) [Unity 5.6] SpriteAtlas cannot be found
- (#1960) [Unity 5.6/2017.1] Fail to build InteractionSourceExtensions
- (#1962) [Unity 5.6] Unable to build BoundingBox
- (#1964) Imersive device: NullReferenceExeption in FocusManager.TryGetFocusedObject
- (#1967) [Unity 2017.1] Two handed manipulation not working as expected
What's New
- (#1799) Send Slider Value on Update
- (#1838) Add LoFi audio effect
- (#1847) Add MixedRealityToolkit/Standard shader
- (#1849) Two hand manipulable
- (#1880) Add Motion Controller haptics in Editor and Add HolographicButton prefab
- (#1882) Update projectversion.txt to match the current recommended Unity release
- (#1914) Bounding Box and App Bar
Fixes
- (#208, #383, #1672) Billboard fixes
- (#1440) Haptics doesn't work when running in-editor
- (#1825) Fix incorrect audio occlusion frequency restoration
- (#1827) UX Button disabled state doesn't prevent clicks
- (#1831) FixedAngularSize flicker
- (#1868, #1885) ObjectCollection does not remove moved GameObject that is no longer a child from NodeList
- (#1928) Add Holographic Button
- (#1949) Address potential NullReferenceException on Select
- (#1951) Build Options disabled on the MRTK Build Window with 2017.2.1.4-RC
- (#1958) [Unity 5.6] SpriteAtlas cannot be found
- (#1960) [Unity 5.6/2017.1] Fail to build InteractionSourceExtensions
- (#1962) [Unity 5.6] Unable to build BoundingBox
- (#1964) Imersive device: NullReferenceExeption in FocusManager.TryGetFocusedObject
- (#1967) [Unity 2017.1] Two handed manipulation not working as expected
Breaking Changes:
- (#1880) MotionControllerModel.dll renamed to EditorMotionController.dll
2017.2.1.4 Release Candidate 2
This is the second release candidate for Mixed Reality Toolkit - Unity 2017.2.1.4.
Project board: https://github.com/Microsoft/MixedRealityToolkit-Unity/projects/7
Upgrade Guide
Attention!
- This release is specifically targeted for Unity Editor-2017.2.1p2
- This release should be compatible for development for both HoloLens & immersive headsets for 2017.2+
- Minimum Editor Compatibility for Unity 5.6 for HoloLens development ONLY.
- Windows SDK 10.0.16299 is required for 2017.2+
- Visual Studio 2017 is required.
- Fall Creators Update is required.
- When upgrading to this release, delete all toolkit folders before importing the package.
Fixed since 2017.2.1.4 Release Candidate
- (#1951) Build Options disabled on the MRTK Build Window with 2017.2.1.4-RC
- (#1949) Address potential NullReferenceException on Select
What's New
- (#1799) Send Slider Value on Update
- (#1838) Add LoFi audio effect
- (#1847) Add MixedRealityToolkit/Standard shader
- (#1849) Two hand manipulable
- (#1880) Add Motion Controller haptics in Editor and Add HolographicButton prefab
- (#1882) Update projectversion.txt to match the current recommended Unity release
- (#1914) Bounding Box and App Bar
Fixes
- (#208, #383, #1672) Billboard fixes
- (#1440) Haptics doesn't work when running in-editor
- (#1825) Fix incorrect audio occlusion frequency restoration
- (#1827) UX Button disabled state doesn't prevent clicks
- (#1831) FixedAngularSize flicker
- (#1868, #1885) ObjectCollection does not remove moved GameObject that is no longer a child from NodeList
- (#1951) Build Options disabled on the MRTK Build Window with 2017.2.1.4-RC
- (#1949) Address potential NullReferenceException on Select
Breaking Changes:
- (#1880) MotionControllerModel.dll renamed to EditorMotionController.dll
2017.2.1.4 Release Candidate
This is a release candidate for Mixed Reality Toolkit - Unity 2017.2.1.4.
Project board: https://github.com/Microsoft/MixedRealityToolkit-Unity/projects/7
Upgrade Guide
Attention!
- This release is specifically targeted for Unity Editor-2017.2.1p2
- This release should be compatible for development for both HoloLens & immersive headsets for 2017.2+
- Minimum Editor Compatibility for Unity 5.6 for HoloLens development ONLY.
- Windows SDK 10.0.16299 is required for 2017.2+
- Visual Studio 2017 is required.
- Fall Creators Update is required.
- When upgrading to this release, delete all toolkit folders before importing the package.
What's New
- (#1799) Send Slider Value on Update
- (#1838) Add LoFi audio effect
- (#1847) Add MixedRealityToolkit/Standard shader
- (#1849) Two hand manipulable
- (#1880) Add Motion Controller haptics in Editor and Add HolographicButton prefab
- (#1882) Update projectversion.txt to match the current recommended Unity release
- (#1914) Bounding Box and App Bar
Fixes
- (#208, #383, #1672) Billboard fixes
- (#1440) Haptics doesn't work when running in-editor
- (#1825) Fix incorrect audio occlusion frequency restoration
- (#1827) UX Button disabled state doesn't prevent clicks
- (#1831) FixedAngularSize flicker
- (#1868, #1885) ObjectCollection does not remove moved GameObject that is no longer a child from NodeList
Breaking Changes:
- (#1880) MotionControllerModel.dll renamed to EditorMotionController.dll