2017.2.1.3 Hot Fix

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.

Breaking Changes:

• Fixed #1800 Fixed Compiling errors by moving Sharing With UNET Completely into Examples folder. If your project requires the UNET Sharing library be sure to also download the examples package and manually import the sharing with UNET folder.

2017.2.1.2 Patch Release

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

-(#1491, #1578, #1678) Added Grid layout group to Interaction Buttons and Object Collections
-(#1544) MRDL Solvers and misc helpers.
-(#1508, #1594, #1600, #1595) MRDL Bounding Boxes
-(#1471, #1585) Updated Build portal to support Building and deploying VR apps to the local machine.
-(#1456) Added Touch Screen input source implementation.
-(#1435) Added QueryTopology_FindLargestPositionsSittable() to the Spatial Understanding Features.

Release Notes

-(#1479) Updated and standardized the license headers.
-(#1521) Xbox Controller Input Handler fixes.
-(#1526) Removed the Boundary Manager from the HoloLens.
-(#1560) Fixed bug in UserNotifications example that didn't correctly check for local user.
-(#1542) Fixes for Focus Manager and uGUI interactions.
-(#1555) Teleportation logic fixes.
-(#1496) Fixed Virtual Keyboard.
-(#1563) Fixed fade plane to be transparent.
-(#1509) Removed most cross feature dependencies.
-(#1554) Updated Tile Generator.
-(#1590) Removed invalid attributes on properties.
-(#1649, #1575) Fixed UIRaycastCamera settings and references
-(#1650) Updated glTF libraries.
-(#1608) Optimized Layer Extensions.
-(#1618, #1690) Fixed and updated Dictation Manager.
-(#1670) Added signed binaries complements of Microsoft.

Known Issues

• (#1800) UNET PlayerController class does not compile correctly. Workaround: Remove Sharing with UNET folder.

2017.2.1.1 Patch Release

Attention!

• Patch Release for 2017.2.1.0 Release
• As always, patch releases are recommended only for users affected by those bugs fixed in that patch.

Release Notes

• Fixed: Standalone build errors.
• Fixed unused field warning in BoundaryManager

MixedRealityToolkit for Unity 2017.2.1f1

Upgrade Guide

Attention!

• This release is specifically targeted for Unity Editor-2017.2.1f1
  • 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

• (#1197, #1294, #1305, #1332, #1364) Mixed Reality Design Labs UX features.
• (#1274) Audio Banks.
• (#1165) Interactive layout elements.
• (#1195, #1196, #1242, #1206, #1268, #1379) Added Motion Controller glTF rendering in Editor.
• (#1308) Added Windows API Contract Checker.
• (#1326) Microphone Helper.
• (#1482) Allow serialized mesh to be converted to supplied local space.

Release Notes

• (#1526) BoundaryManager will be destroyed on HoloLens because of new Unity behavior.
• (#1521) Xbox controller fixes to handle gamepad input that got broken.
• (#1182) Updated sharing scenes to use Sharing World Anchor Manager.
• (#1133) Misc Virtual Keyboard fixes.
• (#1163, #1251, #1359, #1387) Misc Build Window and Project Configuration fixes.
• (#1255) Fixes Interaction Sources not properly being registered at startup in some cases.
• (#1250) Updated Teleport logic and Floor offset in IMHDs.
• (#1259, #1338) Fixed an issue where the Mixed Reality Camera Inspector.
• (#1269, #1126) GamePad input axis fixes.
• (#1256, #1350) Fixed uGUI raycasting for HoloLens and IMHDs.
• (#1329) Properly consuming clicks in TapToPlace.cs.
• (#1361) Clicker and HandDraggable fixes for HoloLens.
• (#1298, #1464) FadeScript was renamed to FadeManager, and was updated.
  • Removed the F key input mapping that was used for testing.
• (#1419, #1427) Fixed Unity editor backwards compatibility.
• (#1290) Validation for Position and Rotation from UnityEngine.XR.WSA.InteractionSourceState.sourcePose.
• (#1469) Removed System.IO.dll that was needed to successfully build IL2CPP projects. (Unity Bug)

Breaking Changes from last release v1.2017.2.0

• (#1208) Updated Singleton with DontDestroyOnLoad and will now survive scene transitions.
• (#1349) Removed Manager.prefab. Users should use InputManager.prefab.
• Made the 16299 SDK the default when building with the Build And Deploy Window for 2017.2+
  • 15063 is still the default SDK target for all previous builds of Unity.
• Made msbuild 15.0 the default build version number.
• Now all world space canvases are required to assign the FocusManager.Instance.UIRaycastCamera (a child of the InputManager's EventSystem ) to their event camera field.
• A dialog will pop up the first time you switch to the WorldSpace render mode asking if you'd like to switch.
  
  
• Updating your existing canvases is done for you by the FocusManager if one exists in your scene.
• You can also call FocusManager.Instance.UpdateCanvasEventSystems() at runtime.
• If you're procedurally creating canvases you can also set the world/event camera to FocusManager.Instance.UIRaycastCamera.
• UAudio events are now handed by UAudioBank. To Upgrade your events:
  1. Open existing project and Inspect the UAudioManager.
  2. Use the Export button to create a bank from the existing embedded data.
  • You may need to adjust the falloff curve and distance of spatialized sounds due to changes in the underlying spatializer library.
  • You can now move the generated asset around and rename it as required. (Default asset name is ConvertedAudioBank)

Known Issues:

• Doesn't build for Window Standalone.
  • Fix: Add UNITY_WSA around broken lines.

MixedRealityToolkit for Unity 2017.2.0p1 MRTP4

Upgrade Guide

Attention!

• Window Mixed Reality developers use Unity Editor 2017.2.0p1 MRTP 4
  • When building for Windows Mixed Reality target 10.0.16299 SDK.
• HoloLens developers use Unity Editor 2017.1.2
  • When building for HoloLens be sure to target the 10.0.15063 SDK.
• When upgrading to this release, delete all toolkit folders before importing the package.
• Minimum Editor Compatibility for Unity 5.6 for HoloLens development ONLY.

Release Notes

• (#1101) Updated Raycasting logic
• (#1141, #1098) Ported Input Updates from Dev Branch
• (#1106) Updated Medical Example

Breaking Changes from last release v1.2017.1.2

• TryGetPosition is now TryGetPointerPosition
• TryGetOrientation is now TryGetPointerRotation
• SpeechKeywordRecognizedEventData is now SpeechEventData
• All other changes should throw Obsolete warnings with suggested updates.

MixedRealityToolkit-Unity for Unity 2017.2.0 MRTP

Pre Release of the HoloToolkit for Unity 2017.2.0p1 MRTP 4
What's new for the Fall Creators Update

Upgrade Guide

Attention!

• When upgrading to this release, delete all toolkit folders before importing the package.
• This release is for Windows Mixed Reality HMDs only.
  • HoloLens Developers please continue to use the master branch release.
• This is the last Pre-Release for the Dev branch and is used to help mitigate the breaking changes back to master. Please use this release as a reference point before switching to the main release.

Release Notes

• (#828, #1057, #1059, #1060, #1064, #1069, #1072, #1075, #1081, #1082, #1091, #1093, #1089, #1175) Merged all changes from master branch into the development branch.
• (#1016, #1026, #1053, #1052, #1062, #1028, #1085, #1088, #1100) Synced the Input System and Utilities feature areas to make older projects forwards compatible.
• (#1122) Fixed issue with TeleportMarker
• (#1021) Added Motion Controllers Example

Breaking Changes from last pre-release v1.Dev.2017.2.0

• Moved InteractionSourceExtensions into the Input feature folder.
• fixed spelling in ICurosr.SetVisibility was SetVisiblity
• RegisterPointableCanvas is now obsolete.
• GazeManager.UpdateHitDetails(FocusDetails focusDetails, bool isRegisteredForFocus) is now UpdateHitDetails(FocusDetails focusDetails, RaycastHit hitInfo, bool isRegisteredForFocus)
• DebugInteractionSourceState public fields are now PascalCase.
• FocusManager.BorrowPointerEventData() is now GetPointerEventData()
• Removed SpecularHightlight.shader
• Marked StartAwareBehaviour obsolete.
• Marked StartAwareSingleton obsolete.

MixedRealityToolkit-Unity for Unity 2017.1.2f1

Latest Release of the HoloToolkit for Unity 2017.1.2f1

Attention!

• When upgrading to this release, delete all toolkit folders before importing the package.
• This release is not for Windows Mixed Reality HMDs. Please use the Dev branch pre-releases instead.

Release Notes

• (#1096) Updated Editor to 2017.1.2f1
• (#975) Added backwards support for Unity 5.6
• (#983) Fixed cross platform serialization issues
• (#936, #994, #1052, #1062) Xbox Controller Support
• (#981) Build and Deploy Updates
• (#998) Fixed Speech keyword editor assignment issues
• (#989) Added cursor offset to TapToPlace
• (#980) Fixed race condition for re-connection in AutoJoinSessionAndRoom
• (#985) Adds the option to download the Sharing Service executable from this repository
• (#1069) Fixed IP max character length for IPv4 addresses
• (#1075) Fixed anchor name assignment
• (#1056) Fixed WorldAnchorManager start inheritance
• (#1090) Removed MicStream from core folders until it passes WACK
• (#1059, #1079, #1072, #1085, #1091, #1093) Prep project for forward compatibility to 2017.2

Breaking Changes

• Renamed feature folders
• Merged Test and Example folders
• Removed MicStream scripts and libraries until they pass WACK

2017.2 Pre Release

This tag is for the pre-merge of the master branch into the 2017.2 dev branch.

MixedRealityToolkit-Unity for Unity 2017.1.1f1

Latest Release of the HoloToolkit for Unity 2017.1.1f1

• (#854) Fixed UAudioManager Editor Bug and added Test Scene for UAudioManager.
• (#852, #864) CameraCache utility that replaces Camera.main.
• (#888, #929) Update Editor to 2017.1.1f1 for Security Update & VS 2017 15.3 compatibility.
• (#874, #924) Refactored TapToPlace.
• (#904) Fixed 3dText multi pass and single pass stereo rendering.
• (#887, #955) Updated and refactored Editor Utilities.
• (#930) Fixed mismatched Mic network stream.
• (#747) Added persistent keyword capability.
  • Removed obsolete warnings from scene loader.
• (#927, #935) Added confidence level to keywords.
• (#905, #960) Added some Enhanced 3D primitives.
• (#965) Fixed IL2CPP build errors.
• (#931, #967) Fixed and updated example scenes.
• (#962) Fixed Quality Settings regression.
• (#742) Update to WorldAnchorManager and added MultiLens capabilities.

Breaking Changes

• GameObjects that utilize the WorldAnchorStore need to have unique names.
  • This is important so you can spawn identical objects across the network without needing to know the anchor names ahead of time.

MixedRealityToolkit-Unity for Unity 2017.1.0f3

Latest release of the HoloToolkit for Unity 2017.1.0f3

Repository Branding Updated to MixedRealityToolkit-Unity.

• (#728) Improvements for ImportExportAnchorManager.
• (#492) Fixed uNet issues with the server broadcasting when building as master.
• (#752) SpawnManager Update.
• (#776) Build & Deploy tools fixed determining Visual Studio instance.
• (#765) Added 3d keyboard.
• (#717) Fixes to SpatialUnderstandingExample scene.
• (#733) Added a basic Application View Manager to Popup and return a value.
• (#764) Added medical volumetric rendering example.
• (#810) Replaced all project shaders with Fast Configurable Shader.
• (#805) Fixed Updated GazeManager uGUI raycast calculations & GazeTransform initialization.
• (#827) Minor Refactoring and Cleanup.
• (#839) Fixed issue with mesh cursor light not being deactivated properly.