From 7ce9a180ff544faa0caac68931105152f9e48af0 Mon Sep 17 00:00:00 2001
From: Unity Technologies <@unity>
Date: Wed, 20 Oct 2021 00:00:00 +0000
Subject: [PATCH] com.unity.xr.openxr@1.3.0 ## [1.3.0] - 2021-10-20 ### Added *
Added API `OpenXRInput.SendHapticImpulse` * Added API
`OpenXRInput.StopHaptics` * Added API `OpenXRInput.TryGetInputSourceName` *
Added event `OpenXRRuntime.wantsToRestart` * Added event
`OpenXRRuntime.wantsToQuit` * Added support for `XR_OCULUS_audio_device_guid
` extension. * Added `Haptic` control to OpenXR Controller Profile layouts
that can be bound to an action and used to trigger haptics using the new
`OpenXRInput.SendHapticImpulse` API.
### Fixed
* Fixed ARM32 crash when OpenXR API layers were present
* [ISSUE-1355859](https://issuetracker.unity3d.com/issues/xr-uwp-any-openxr-layer-will-crash-unityopenxr-dot-dll-on-hololens2-when-compiling-with-arm32)
* Fixed issue that would cause console errors if `OpenXRFeature.enable` was changed while the OpenXR Projects Settings windows was open.
* Fixed potential Android crash when shutting down.
* Fixed potential crash with `XR_MSFT_SECONDARY_VIEW_CONFIGURATION_EXTENSION_NAME`
* Fixed issue with alpha channel on Projection layer causing visual artifacts.
* [ISSUE-1338699](https://issuetracker.unity3d.com/issues/xr-openxr-a-black-background-is-rendered-in-hmd-when-using-solid-color-camera-clear-flags)
* [ISSUE-1349271](https://issuetracker.unity3d.com/issues/xr-sdk-openxr-post-processing-postexposure-effect-has-visual-artifacts)
* [ISSUE-1346455](https://issuetracker.unity3d.com/issues/xr-sdk-openxr-right-eye-contains-artifacts-when-taa-anti-aliasing-is-used-with-multi-pass-rendering-mode)
* [ISSUE-1336968](https://issuetracker.unity3d.com/issues/xr-openxr-oculus-post-processing-view-in-hmd-is-darker-and-sometimes-flickers-when-changing-depth-of-field-focus-distance)
* [ISSUE-1338696](https://issuetracker.unity3d.com/issues/xr-sdk-openxr-black-edges-are-rendered-on-the-game-objects-when-fxaa-anti-aliasing-is-used)
* Fixed bug that caused Vulkan support on Oculus to stop working.
* Fixed missing usages on `HoloLensHand` layout.
* Fixed vulkan shared depth buffer on versions `2021.2.0b15` and `2022.1.0a8` or higher.
### Updated
* Improved `OpenXRFeatureSetManager.SetFeaturesFromEnabledFeatureSets` so that no internal methods are required after calling this.
* Updated `Controller` sample to improve the visuals and use the new APIs
---
CHANGELOG.md | 31 +
.../ConformanceAutomationFeature.cs | 36 +-
ConformanceAutomation/HelperTypes.cs | 82 -
.../Native~/conformance_automation_ext.cpp | 13 +
ConformanceAutomation/android.meta | 2 +-
ConformanceAutomation/android/arm64.meta | 2 +-
.../android/arm64/ConformanceAutomationExt.so | Bin 211712 -> 211712 bytes
.../arm64/ConformanceAutomationExt.so.meta | 2 +-
ConformanceAutomation/universalwindows.meta | 2 +-
.../universalwindows/arm32.meta | 2 +-
.../arm32/ConformanceAutomationExt.dll | Bin 14336 -> 14336 bytes
.../arm32/ConformanceAutomationExt.dll.meta | 2 +-
.../universalwindows/arm64.meta | 2 +-
.../arm64/ConformanceAutomationExt.dll | Bin 16896 -> 17408 bytes
.../arm64/ConformanceAutomationExt.dll.meta | 2 +-
.../universalwindows/x64.meta | 2 +-
.../x64/ConformanceAutomationExt.dll | Bin 17408 -> 17920 bytes
.../x64/ConformanceAutomationExt.dll.meta | 2 +-
ConformanceAutomation/windows.meta | 2 +-
ConformanceAutomation/windows/x64.meta | 2 +-
.../windows/x64/ConformanceAutomationExt.dll | Bin 100864 -> 101376 bytes
.../x64/ConformanceAutomationExt.dll.meta | 2 +-
Documentation~/input.md | 4 +
Editor/FeatureSupport/OpenXRFeatureEditor.cs | 17 +-
.../FeatureSupport/OpenXRFeatureSetManager.cs | 31 +-
Editor/FeatureSupport/OpenXRLoaderUI.cs | 2 -
Editor/OpenXREditorSettings.cs | 15 +-
Editor/OpenXRMangementSettings.cs | 2 +-
Editor/PackageSettingsEditor.cs | 51 +-
Editor/Unity.XR.OpenXR.Editor.asmdef | 7 +-
MockDriver/MockDriver.cs | 267 -
.../mock_driver/Include/openxr_mock_driver.h | 67 -
.../Native~/mock_driver/mock_driver.cpp | 150 -
...Unity.XR.OpenXR.Features.MockDriver.asmdef | 18 -
MockDriver/windows.meta | 8 -
MockDriver/windows/x64/mock_driver.dll | Bin 93184 -> 0 bytes
MockRuntime/MockRuntime.cs | 300 +-
.../mock_conformance_automation.cpp | 9 +
.../Extensions/mock_d3d11_enable.cpp | 0
.../mock_msft_first_person_observer.cpp | 0
...mock_msft_secondary_view_configuration.cpp | 0
.../Extensions/mock_vulkan_enable2.cpp | 0
...win32_convert_performance_counter_time.cpp | 24 +
.../{openxr_loader => mock_runtime}/mock.h | 70 +-
MockRuntime/Native~/mock_runtime/mock_api.cpp | 146 +
.../mock_events.h | 12 +
.../mock_extensions.h | 4 -
.../mock_input_state.cpp | 42 +
.../mock_input_state.h | 10 +
.../Native~/mock_runtime/mock_loader.cpp | 788 +
.../mock_runtime.cpp | 167 +-
.../mock_runtime.h | 44 +-
.../mock_runtime_interaction_profiles.cpp | 18 +
.../visibility_mask_data.cpp | 0
.../Extensions/mock_driver_extension.cpp | 125 -
.../Native~/openxr_loader/mock_loader.cpp | 791 +-
...nity.XR.OpenXR.Features.MockRuntime.asmdef | 3 +-
MockRuntime/windows.meta | 2 +-
MockRuntime/windows/x64.meta | 2 +-
MockRuntime/windows/x64/mock_runtime.dll | Bin 0 -> 242688 bytes
.../windows/x64/mock_runtime.dll.meta | 2 +-
MockRuntime/windows/x64/openxr_loader.dll | Bin 238592 -> 137216 bytes
.../windows/x64/openxr_loader.dll.meta | 2 +-
.../Interactions/EyeGazeInteraction.cs | 5 +-
.../Interactions/HTCViveControllerProfile.cs | 8 +
.../KHRSimpleControllerProfile.cs | 28 +-
.../Interactions/MicrosoftHandInteraction.cs | 74 +-
.../MicrosoftMotionControllerProfile.cs | 39 +-
.../OculusTouchControllerProfile.cs | 62 +-
.../ValveIndexControllerProfile.cs | 63 +-
Runtime/Features/OpenXRFeature.cs | 41 +-
Runtime/Features/OpenXRFeatureInternal.cs | 5 +-
Runtime/Features/OpenXRInteractionFeature.cs | 56 +-
Runtime/OpenXRDiagnosticReport.cs | 45 -
Runtime/OpenXRLoader.cs | 135 +-
Runtime/OpenXRLoaderInternal.cs | 12 +-
Runtime/OpenXRNativeTypes.cs | 203 +
.../OpenXRNativeTypes.cs.meta | 2 +-
Runtime/OpenXRProjectValidation.cs | 23 +-
Runtime/OpenXRRestarter.cs | 126 +-
Runtime/OpenXRRuntime.cs | 92 +
Runtime/Unity.XR.OpenXR.asmdef | 6 +
Runtime/UnitySubsystemsManifest.json | 2 +-
Runtime/android.meta | 2 +-
Runtime/android/arm64.meta | 2 +-
Runtime/android/arm64/libUnityOpenXR.so | Bin 1123728 -> 1197512 bytes
Runtime/android/arm64/libUnityOpenXR.so.meta | 2 +-
Runtime/input/HapticControl.cs | 38 +
Runtime/input/HapticControl.cs.meta | 3 +
Runtime/input/OpenXRInput.cs | 644 +-
Runtime/universalwindows.meta | 2 +-
Runtime/universalwindows/arm32.meta | 2 +-
.../universalwindows/arm32/UnityOpenXR.dll | Bin 230912 -> 251392 bytes
.../arm32/UnityOpenXR.dll.meta | 2 +-
Runtime/universalwindows/arm64.meta | 2 +-
.../universalwindows/arm64/UnityOpenXR.dll | Bin 295424 -> 325120 bytes
.../arm64/UnityOpenXR.dll.meta | 2 +-
Runtime/universalwindows/x64.meta | 2 +-
Runtime/universalwindows/x64/UnityOpenXR.dll | Bin 318464 -> 350208 bytes
.../universalwindows/x64/UnityOpenXR.dll.meta | 2 +-
Runtime/windows.meta | 2 +-
Runtime/windows/x64.meta | 2 +-
Runtime/windows/x64/UnityOpenXR.dll | Bin 581632 -> 620544 bytes
Runtime/windows/x64/UnityOpenXR.dll.meta | 2 +-
RuntimeDebugger/DebuggerState.cs | 45 +
.../Editor/RuntimeDebuggerWindow.cs | 48 +-
.../Native~/openxr_runtime_debugger/ringbuf.h | 7 +-
.../serialize_handles.h | 2 +-
.../RuntimeDebuggerOpenXRFeature.cs | 5 +
RuntimeDebugger/android.meta | 2 +-
RuntimeDebugger/android/arm64.meta | 2 +-
.../arm64/libopenxr_runtime_debugger.so | Bin 996632 -> 996632 bytes
.../arm64/libopenxr_runtime_debugger.so.meta | 2 +-
RuntimeDebugger/universalwindows.meta | 2 +-
RuntimeDebugger/universalwindows/arm32.meta | 2 +-
.../arm32/openxr_runtime_debugger.dll | Bin 142336 -> 142336 bytes
.../arm32/openxr_runtime_debugger.dll.meta | 2 +-
RuntimeDebugger/universalwindows/arm64.meta | 2 +-
.../arm64/openxr_runtime_debugger.dll | Bin 822784 -> 823296 bytes
.../arm64/openxr_runtime_debugger.dll.meta | 2 +-
RuntimeDebugger/universalwindows/x64.meta | 2 +-
.../x64/openxr_runtime_debugger.dll | Bin 163328 -> 163840 bytes
.../x64/openxr_runtime_debugger.dll.meta | 2 +-
RuntimeDebugger/windows.meta | 2 +-
RuntimeDebugger/windows/x64.meta | 2 +-
.../windows/x64/openxr_runtime_debugger.dll | Bin 399872 -> 400896 bytes
.../x64/openxr_runtime_debugger.dll.meta | 2 +-
RuntimeLoaders/universalwindows.meta | 2 +-
RuntimeLoaders/universalwindows/arm32.meta | 2 +-
.../arm32/openxr_loader.dll.meta | 2 +-
RuntimeLoaders/universalwindows/arm64.meta | 2 +-
.../arm64/openxr_loader.dll.meta | 2 +-
RuntimeLoaders/universalwindows/x64.meta | 2 +-
.../x64/openxr_loader.dll.meta | 2 +-
RuntimeLoaders/windows.meta | 2 +-
RuntimeLoaders/windows/x64.meta | 2 +-
.../windows/x64/openxr_loader.dll.meta | 2 +-
Samples~/Controller/ActionMap.meta | 8 -
Samples~/Controller/ControllerSample.unity | 16488 +++-------------
...s => ControllerSampleActions.inputactions} | 494 +-
...ControllerSampleActions.inputactions.meta} | 0
.../Controller/Prefabs/AxisControl.prefab | 462 +
.../Prefabs/AxisControl.prefab.meta | 4 +-
.../Controller/Prefabs/ButtonControl.prefab | 152 +
.../Prefabs/ButtonControl.prefab.meta | 4 +-
Samples~/Controller/Prefabs/ControlRow.prefab | 249 +
.../Controller/Prefabs/ControlRow.prefab.meta | 5 +-
.../Controller/Prefabs/ControlText.prefab | 81 +
.../Prefabs/ControlText.prefab.meta | 5 +-
Samples~/Controller/Prefabs/Controller.prefab | 4319 ++++
.../Controller/Prefabs/Controller.prefab.meta | 7 +
.../Controller/Prefabs/Vector2Control.prefab | 378 +
.../Prefabs/Vector2Control.prefab.meta | 7 +
Samples~/Controller/Scripts/ActionToAxis.cs | 17 +
.../Controller/Scripts/ActionToAxis.cs.meta | 2 +-
Samples~/Controller/Scripts/ActionToButton.cs | 45 +
.../Controller/Scripts/ActionToButton.cs.meta | 11 +
.../Scripts/ActionToButtonISX.cs.meta | 2 +-
.../Controller/Scripts/ActionToControl.cs | 70 +
.../Scripts/ActionToControl.cs.meta | 3 +
.../Controller/Scripts/ActionToDeviceInfo.cs | 28 +
.../Scripts/ActionToDeviceInfo.cs.meta | 11 +
.../Controller/Scripts/ActionToHaptics.cs | 11 +-
.../Scripts/ActionToSliderISX.cs.meta | 2 +-
.../Controller/Scripts/ActionToVector2.cs | 21 +
.../Scripts/ActionToVector2.cs.meta | 11 +
.../Scripts/ActionToVector2SliderISX.cs.meta | 2 +-
.../Controller/Scripts/ActionToVisibility.cs | 40 +
.../Scripts/ActionToVisibility.cs.meta | 11 +
.../Scripts/ActionToVisibilityISX.cs.meta | 2 +-
.../DisplayDeviceInfoFromActionISX.cs.meta | 2 +-
.../Editor/InterceptFeatureInstaller.cs | 9 +-
.../InterceptFeaturePlugin/android.meta | 2 +-
.../InterceptFeaturePlugin/android/arm64.meta | 2 +-
.../universalwindows.meta | 2 +-
.../universalwindows/arm32.meta | 2 +-
.../universalwindows/arm64.meta | 2 +-
.../universalwindows/x64.meta | 2 +-
.../InterceptFeaturePlugin/windows.meta | 2 +-
.../InterceptFeaturePlugin/windows/x64.meta | 2 +-
.../windows/x64/InterceptFeaturePlugin.dll | Bin 97280 -> 97280 bytes
.../Editor/MeshingFeatureInstaller.cs | 7 +
.../MeshingFeaturePlugin/android.meta | 2 +-
.../MeshingFeaturePlugin/android/arm64.meta | 2 +-
.../arm64/libMeshingFeaturePlugin.so.meta | 2 +-
.../universalwindows.meta | 2 +-
.../universalwindows/arm32.meta | 2 +-
.../universalwindows/arm64.meta | 2 +-
.../universalwindows/x64.meta | 2 +-
.../x64/MeshingFeaturePlugin.dll | Bin 40448 -> 40448 bytes
.../MeshingFeaturePlugin/windows.meta | 2 +-
.../MeshingFeaturePlugin/windows/x64.meta | 2 +-
.../windows/x64/MeshingFeaturePlugin.dll | Bin 123392 -> 123392 bytes
.../windows/x64/MeshingFeaturePlugin.dll.meta | 2 +-
Shared/Native~/plugin_load.cpp | 119 +
Shared/Native~/plugin_load.h | 43 +
TestHelpers.meta | 8 -
.../Unity.XR.OpenXR.TestHelpers.asmdef | 16 -
TestHelpers/WaitForLoaderRestart.cs | 66 -
TestHelpers/WaitForLoaderShutdown.cs | 48 -
Tests/Editor/FeatureSetManagerTests.cs | 659 -
Tests/Editor/FeatureSetTests.cs | 393 +
...rTests.cs.meta => FeatureSetTests.cs.meta} | 0
Tests/Editor/FeatureTests.cs | 52 +-
Tests/Editor/OpenXRCallbackTests.cs | 4 +-
Tests/Editor/OpenXREditorTestHelpers.cs | 231 +
Tests/Editor/OpenXREditorTestHelpers.cs.meta | 11 +
Tests/Editor/OpenXRInputEditorTests.cs | 79 +
Tests/Editor/OpenXRInputEditorTests.cs.meta | 3 +
Tests/Runtime/DiagnosticReportTests.cs | 104 +-
Tests/Runtime/MockInteractionFeature.cs | 209 +
Tests/Runtime/MockInteractionFeature.cs.meta | 3 +
...verRuntimeTests.cs => MockRuntimeTests.cs} | 288 +-
...Tests.cs.meta => MockRuntimeTests.cs.meta} | 0
Tests/Runtime/NativeTests.cs | 68 +
Tests/Runtime/NativeTests.cs.meta | 11 +
Tests/Runtime/OpenXRFeatureTests.cs | 17 +
Tests/Runtime/OpenXRInputTests.cs | 703 +
Tests/Runtime/OpenXRInputTests.cs.meta | 11 +
Tests/Runtime/OpenXRLoaderSetup.cs | 50 +-
Tests/Runtime/OpenXRRuntimeTests.cs | 270 +-
Tests/Runtime/Unity.XR.OpenXR.Tests.asmdef | 6 +-
Tests/Runtime/UnityVersionUtilityTests.cs | 85 +
.../Runtime/UnityVersionUtilityTests.cs.meta | 11 +
Tests/Runtime/WaitForLoaderRestart.cs | 67 +
.../Runtime}/WaitForLoaderRestart.cs.meta | 0
Tests/Runtime/WaitForLoaderShutdown.cs | 75 +
.../Runtime}/WaitForLoaderShutdown.cs.meta | 0
Tests/Runtime/WaitForRestarter.cs | 40 +
Tests/Runtime/WaitForRestarter.cs.meta | 11 +
Tests/Runtime/WaitForXrFrame.cs | 20 +-
Tests/Runtime/WaitForXrFrame.cs.meta | 12 +-
ValidationExceptions.json | 15 +
ValidationExceptions.json.meta | 7 +
package.json | 6 +-
235 files changed, 15168 insertions(+), 16938 deletions(-)
delete mode 100644 ConformanceAutomation/HelperTypes.cs
delete mode 100644 MockDriver/MockDriver.cs
delete mode 100644 MockDriver/Native~/mock_driver/Include/openxr_mock_driver.h
delete mode 100644 MockDriver/Native~/mock_driver/mock_driver.cpp
delete mode 100644 MockDriver/Unity.XR.OpenXR.Features.MockDriver.asmdef
delete mode 100644 MockDriver/windows.meta
delete mode 100644 MockDriver/windows/x64/mock_driver.dll
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/Extensions/mock_conformance_automation.cpp (88%)
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/Extensions/mock_d3d11_enable.cpp (100%)
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/Extensions/mock_msft_first_person_observer.cpp (100%)
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/Extensions/mock_msft_secondary_view_configuration.cpp (100%)
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/Extensions/mock_vulkan_enable2.cpp (100%)
create mode 100644 MockRuntime/Native~/mock_runtime/Extensions/mock_win32_convert_performance_counter_time.cpp
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/mock.h (70%)
create mode 100644 MockRuntime/Native~/mock_runtime/mock_api.cpp
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/mock_events.h (51%)
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/mock_extensions.h (87%)
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/mock_input_state.cpp (69%)
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/mock_input_state.h (68%)
create mode 100644 MockRuntime/Native~/mock_runtime/mock_loader.cpp
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/mock_runtime.cpp (93%)
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/mock_runtime.h (91%)
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/mock_runtime_interaction_profiles.cpp (95%)
rename MockRuntime/Native~/{openxr_loader => mock_runtime}/visibility_mask_data.cpp (100%)
delete mode 100644 MockRuntime/Native~/openxr_loader/Extensions/mock_driver_extension.cpp
create mode 100644 MockRuntime/windows/x64/mock_runtime.dll
rename MockDriver/windows/x64/mock_driver.dll.meta => MockRuntime/windows/x64/mock_runtime.dll.meta (92%)
create mode 100644 Runtime/OpenXRNativeTypes.cs
rename MockDriver/MockDriver.cs.meta => Runtime/OpenXRNativeTypes.cs.meta (80%)
create mode 100644 Runtime/input/HapticControl.cs
create mode 100644 Runtime/input/HapticControl.cs.meta
delete mode 100644 Samples~/Controller/ActionMap.meta
rename Samples~/Controller/{ActionMap/InputActions.inputactions => ControllerSampleActions.inputactions} (58%)
rename Samples~/Controller/{ActionMap/InputActions.inputactions.meta => ControllerSampleActions.inputactions.meta} (100%)
create mode 100644 Samples~/Controller/Prefabs/AxisControl.prefab
rename TestHelpers/Unity.XR.OpenXR.TestHelpers.asmdef.meta => Samples~/Controller/Prefabs/AxisControl.prefab.meta (57%)
create mode 100644 Samples~/Controller/Prefabs/ButtonControl.prefab
rename MockDriver/Unity.XR.OpenXR.Features.MockDriver.asmdef.meta => Samples~/Controller/Prefabs/ButtonControl.prefab.meta (57%)
create mode 100644 Samples~/Controller/Prefabs/ControlRow.prefab
rename MockDriver/windows/x64.meta => Samples~/Controller/Prefabs/ControlRow.prefab.meta (55%)
create mode 100644 Samples~/Controller/Prefabs/ControlText.prefab
rename MockDriver.meta => Samples~/Controller/Prefabs/ControlText.prefab.meta (55%)
create mode 100644 Samples~/Controller/Prefabs/Controller.prefab
create mode 100644 Samples~/Controller/Prefabs/Controller.prefab.meta
create mode 100644 Samples~/Controller/Prefabs/Vector2Control.prefab
create mode 100644 Samples~/Controller/Prefabs/Vector2Control.prefab.meta
create mode 100644 Samples~/Controller/Scripts/ActionToAxis.cs
rename ConformanceAutomation/HelperTypes.cs.meta => Samples~/Controller/Scripts/ActionToAxis.cs.meta (80%)
create mode 100644 Samples~/Controller/Scripts/ActionToButton.cs
create mode 100644 Samples~/Controller/Scripts/ActionToButton.cs.meta
create mode 100644 Samples~/Controller/Scripts/ActionToControl.cs
create mode 100644 Samples~/Controller/Scripts/ActionToControl.cs.meta
create mode 100644 Samples~/Controller/Scripts/ActionToDeviceInfo.cs
create mode 100644 Samples~/Controller/Scripts/ActionToDeviceInfo.cs.meta
create mode 100644 Samples~/Controller/Scripts/ActionToVector2.cs
create mode 100644 Samples~/Controller/Scripts/ActionToVector2.cs.meta
create mode 100644 Samples~/Controller/Scripts/ActionToVisibility.cs
create mode 100644 Samples~/Controller/Scripts/ActionToVisibility.cs.meta
create mode 100644 Shared/Native~/plugin_load.cpp
create mode 100644 Shared/Native~/plugin_load.h
delete mode 100644 TestHelpers.meta
delete mode 100644 TestHelpers/Unity.XR.OpenXR.TestHelpers.asmdef
delete mode 100644 TestHelpers/WaitForLoaderRestart.cs
delete mode 100644 TestHelpers/WaitForLoaderShutdown.cs
delete mode 100644 Tests/Editor/FeatureSetManagerTests.cs
create mode 100644 Tests/Editor/FeatureSetTests.cs
rename Tests/Editor/{FeatureSetManagerTests.cs.meta => FeatureSetTests.cs.meta} (100%)
create mode 100644 Tests/Editor/OpenXREditorTestHelpers.cs
create mode 100644 Tests/Editor/OpenXREditorTestHelpers.cs.meta
create mode 100644 Tests/Editor/OpenXRInputEditorTests.cs
create mode 100644 Tests/Editor/OpenXRInputEditorTests.cs.meta
create mode 100644 Tests/Runtime/MockInteractionFeature.cs
create mode 100644 Tests/Runtime/MockInteractionFeature.cs.meta
rename Tests/Runtime/{MockDriverRuntimeTests.cs => MockRuntimeTests.cs} (57%)
rename Tests/Runtime/{MockDriverRuntimeTests.cs.meta => MockRuntimeTests.cs.meta} (100%)
create mode 100644 Tests/Runtime/NativeTests.cs
create mode 100644 Tests/Runtime/NativeTests.cs.meta
create mode 100644 Tests/Runtime/OpenXRInputTests.cs
create mode 100644 Tests/Runtime/OpenXRInputTests.cs.meta
create mode 100644 Tests/Runtime/UnityVersionUtilityTests.cs
create mode 100644 Tests/Runtime/UnityVersionUtilityTests.cs.meta
create mode 100644 Tests/Runtime/WaitForLoaderRestart.cs
rename {TestHelpers => Tests/Runtime}/WaitForLoaderRestart.cs.meta (100%)
create mode 100644 Tests/Runtime/WaitForLoaderShutdown.cs
rename {TestHelpers => Tests/Runtime}/WaitForLoaderShutdown.cs.meta (100%)
create mode 100644 Tests/Runtime/WaitForRestarter.cs
create mode 100644 Tests/Runtime/WaitForRestarter.cs.meta
create mode 100644 ValidationExceptions.json
create mode 100644 ValidationExceptions.json.meta
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1a12175..682d161 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,37 @@ All notable changes to this package will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+## [1.3.0] - 2021-10-20
+### Added
+* Added API `OpenXRInput.SendHapticImpulse`
+* Added API `OpenXRInput.StopHaptics`
+* Added API `OpenXRInput.TryGetInputSourceName`
+* Added event `OpenXRRuntime.wantsToRestart`
+* Added event `OpenXRRuntime.wantsToQuit`
+* Added support for `XR_OCULUS_audio_device_guid
+` extension.
+* Added `Haptic` control to OpenXR Controller Profile layouts that can be bound to an action and used to trigger haptics using the new `OpenXRInput.SendHapticImpulse` API.
+
+### Fixed
+* Fixed ARM32 crash when OpenXR API layers were present
+ * [ISSUE-1355859](https://issuetracker.unity3d.com/issues/xr-uwp-any-openxr-layer-will-crash-unityopenxr-dot-dll-on-hololens2-when-compiling-with-arm32)
+* Fixed issue that would cause console errors if `OpenXRFeature.enable` was changed while the OpenXR Projects Settings windows was open.
+* Fixed potential Android crash when shutting down.
+* Fixed potential crash with `XR_MSFT_SECONDARY_VIEW_CONFIGURATION_EXTENSION_NAME`
+* Fixed issue with alpha channel on Projection layer causing visual artifacts.
+ * [ISSUE-1338699](https://issuetracker.unity3d.com/issues/xr-openxr-a-black-background-is-rendered-in-hmd-when-using-solid-color-camera-clear-flags)
+ * [ISSUE-1349271](https://issuetracker.unity3d.com/issues/xr-sdk-openxr-post-processing-postexposure-effect-has-visual-artifacts)
+ * [ISSUE-1346455](https://issuetracker.unity3d.com/issues/xr-sdk-openxr-right-eye-contains-artifacts-when-taa-anti-aliasing-is-used-with-multi-pass-rendering-mode)
+ * [ISSUE-1336968](https://issuetracker.unity3d.com/issues/xr-openxr-oculus-post-processing-view-in-hmd-is-darker-and-sometimes-flickers-when-changing-depth-of-field-focus-distance)
+ * [ISSUE-1338696](https://issuetracker.unity3d.com/issues/xr-sdk-openxr-black-edges-are-rendered-on-the-game-objects-when-fxaa-anti-aliasing-is-used)
+* Fixed bug that caused Vulkan support on Oculus to stop working.
+* Fixed missing usages on `HoloLensHand` layout.
+* Fixed vulkan shared depth buffer on versions `2021.2.0b15` and `2022.1.0a8` or higher.
+
+### Updated
+* Improved `OpenXRFeatureSetManager.SetFeaturesFromEnabledFeatureSets` so that no internal methods are required after calling this.
+* Updated `Controller` sample to improve the visuals and use the new APIs
+
## [1.2.8] - 2021-07-29
* Fixed an issue that was causing Oculus Android OpenGL builds to stop working after v31 of the oculus software was installed.
* Fixed a bug that would cause Asset Bundles to fail building in some circumstances when OpenXR was included in the project.
diff --git a/ConformanceAutomation/ConformanceAutomationFeature.cs b/ConformanceAutomation/ConformanceAutomationFeature.cs
index 3e1172d..36750e3 100644
--- a/ConformanceAutomation/ConformanceAutomationFeature.cs
+++ b/ConformanceAutomation/ConformanceAutomationFeature.cs
@@ -1,6 +1,6 @@
using System;
using System.Runtime.InteropServices;
-using UnityEngine.XR.OpenXR.Input;
+using UnityEngine.XR.OpenXR.NativeTypes;
#if UNITY_EDITOR
using UnityEditor.XR.OpenXR.Features;
#endif
@@ -33,7 +33,7 @@ public class ConformanceAutomationFeature : OpenXRFeature
private static ulong xrSession = 0ul;
///
- protected override bool OnInstanceCreate(ulong instance)
+ protected internal override bool OnInstanceCreate(ulong instance)
{
if (!OpenXRRuntime.IsExtensionEnabled("XR_EXT_conformance_automation"))
{
@@ -49,21 +49,21 @@ protected override bool OnInstanceCreate(ulong instance)
}
///
- protected override void OnInstanceDestroy(ulong xrInstance)
+ protected internal override void OnInstanceDestroy(ulong xrInstance)
{
base.OnInstanceDestroy(xrInstance);
ConformanceAutomationFeature.xrInstance = 0ul;
}
///
- protected override void OnSessionCreate(ulong xrSessionId)
+ protected internal override void OnSessionCreate(ulong xrSessionId)
{
ConformanceAutomationFeature.xrSession = xrSessionId;
base.OnSessionCreate(xrSession);
}
///
- protected override void OnSessionDestroy(ulong xrSessionId)
+ protected internal override void OnSessionDestroy(ulong xrSessionId)
{
base.OnSessionDestroy(xrSessionId);
ConformanceAutomationFeature.xrSession = 0ul;
@@ -156,6 +156,29 @@ public static bool ConformanceAutomationSetPose(string topLevelPath, string inpu
new XrPosef(position, orientation));
}
+ ///
+ /// Set the angular and linear velocity of a pose
+ ///
+ /// An OpenXRPath that specifies the OpenXR User Path of the value to be changed (e.g. /user/hand/left).
+ /// An OpenXRPath that specifies the full path of the input component whose state you wish to set (e.g. /user/hand/left/input/select/click).
+ /// True if the linear velocity is valid
+ /// Linear velocity value
+ /// True if the angular velocity is valid
+ /// Angular velocity value
+ ///
+ public static bool ConformanceAutomationSetVelocity(string topLevelPath, string inputSourcePath, bool linearValid, Vector3 linear, bool angularValid, Vector3 angular)
+ {
+ return xrSetInputDeviceVelocityUNITY(
+ xrSession,
+ StringToPath(topLevelPath),
+ StringToPath(inputSourcePath),
+ linearValid,
+ new XrVector3f(-1.0f * linear), // Linear velocity is multiplied by -1 in the OpenXR plugin so it must be negated here as well
+ angularValid,
+ new XrVector3f(-1.0f * angular) // Angular velocity is multiplied by -1 in the OpenXR plugin so it must be negated here as well
+ );
+ }
+
// Dll imports
private const string ExtLib = "ConformanceAutomationExt";
@@ -182,5 +205,8 @@ public static bool ConformanceAutomationSetPose(string topLevelPath, string inpu
[DllImport(ExtLib, EntryPoint = "script_xrSetInputDeviceLocationEXT")]
private static extern bool xrSetInputDeviceLocationEXT(ulong xrSession, ulong topLevelPath, ulong inputSourcePath, ulong space, XrPosef pose);
+
+ [DllImport(ExtLib, EntryPoint = "script_xrSetInputDeviceVelocityUNITY")]
+ private static extern bool xrSetInputDeviceVelocityUNITY(ulong xrSession, ulong topLevelPath, ulong inputSourcePath, bool linearValid, XrVector3f linear, bool angularValid, XrVector3f angular);
}
}
diff --git a/ConformanceAutomation/HelperTypes.cs b/ConformanceAutomation/HelperTypes.cs
deleted file mode 100644
index dfa39ff..0000000
--- a/ConformanceAutomation/HelperTypes.cs
+++ /dev/null
@@ -1,82 +0,0 @@
-///
-/// OpenXR types as C# structs to pass to an OpenXR runtime
-///
-///
-
-namespace UnityEngine.XR.OpenXR.Features.ConformanceAutomation
-{
- struct XrVector2f
- {
- float x;
- float y;
-
- public XrVector2f(float x, float y)
- {
- this.x = x;
- this.y = y;
- }
-
- public XrVector2f(Vector2 value)
- {
- x = value.x;
- y = value.y;
- }
- };
-
- struct XrVector3f
- {
- float x;
- float y;
- float z;
-
- public XrVector3f(float x, float y, float z)
- {
- this.x = x;
- this.y = y;
- this.z = -z;
- }
-
- public XrVector3f(Vector3 value)
- {
- x = value.x;
- y = value.y;
- z = -value.z;
- }
- };
-
- struct XrQuaternionf
- {
- float x;
- float y;
- float z;
- float w;
-
- public XrQuaternionf(float x, float y, float z, float w)
- {
- this.x = -x;
- this.y = -y;
- this.z = z;
- this.w = w;
- }
-
- public XrQuaternionf(Quaternion quaternion)
- {
- this.x = -quaternion.x;
- this.y = -quaternion.y;
- this.z = quaternion.z;
- this.w = quaternion.w;
- }
- };
-
- struct XrPosef
- {
- XrQuaternionf orientation;
- XrVector3f position;
-
- public XrPosef(Vector3 vec3, Quaternion quaternion)
- {
- this.position = new XrVector3f(vec3);
- this.orientation = new XrQuaternionf(quaternion);
- }
- };
-}
diff --git a/ConformanceAutomation/Native~/conformance_automation_ext.cpp b/ConformanceAutomation/Native~/conformance_automation_ext.cpp
index c7892f3..144497f 100644
--- a/ConformanceAutomation/Native~/conformance_automation_ext.cpp
+++ b/ConformanceAutomation/Native~/conformance_automation_ext.cpp
@@ -14,12 +14,15 @@
assert(ret == XR_SUCCESS); \
}
+typedef XrResult(XRAPI_PTR* PFN_xrSetInputDeviceVelocityUNITY)(XrSession session, XrPath topLevelPath, XrPath inputSourcePath, bool linearValid, XrVector3f linear, bool angularValid, XrVector3f angular);
+
// OpenXR runtime functions
PFN_xrSetInputDeviceActiveEXT unity_xrSetInputDeviceActiveEXT = nullptr;
PFN_xrSetInputDeviceStateBoolEXT unity_xrSetInputDeviceStateBoolEXT = nullptr;
PFN_xrSetInputDeviceStateFloatEXT unity_xrSetInputDeviceStateFloatEXT = nullptr;
PFN_xrSetInputDeviceStateVector2fEXT unity_xrSetInputDeviceStateVector2fEXT = nullptr;
PFN_xrSetInputDeviceLocationEXT unity_xrSetInputDeviceLocationEXT = nullptr;
+PFN_xrSetInputDeviceVelocityUNITY unity_xrSetInputDeviceVelocityUNITY = nullptr;
// Trace for Debug
static IUnityXRTrace* s_Trace = nullptr;
@@ -81,6 +84,15 @@ script_xrSetInputDeviceLocationEXT(XrSession session, XrPath topLevelPath, XrPat
return XR_SUCCESS == unity_xrSetInputDeviceLocationEXT(session, topLevelPath, inputSourcePath, space, pose);
}
+extern "C" bool UNITY_INTERFACE_EXPORT UNITY_INTERFACE_API
+script_xrSetInputDeviceVelocityUNITY(XrSession session, XrPath topLevelPath, XrPath inputSourcePath, bool linearValid, XrVector3f linear, bool angularValid, XrVector3f angular)
+{
+ if (nullptr == unity_xrSetInputDeviceVelocityUNITY)
+ return false;
+
+ return XR_SUCCESS == unity_xrSetInputDeviceVelocityUNITY(session, topLevelPath, inputSourcePath, linearValid, linear, angularValid, angular);
+}
+
// Init
extern "C" void UNITY_INTERFACE_EXPORT UNITY_INTERFACE_API
@@ -93,6 +105,7 @@ script_initialize(PFN_xrGetInstanceProcAddr xrGetInstanceProcAddr, XrInstance in
CHECK_XRCMD(xrGetInstanceProcAddr(instance, "xrSetInputDeviceStateFloatEXT", (PFN_xrVoidFunction*)&unity_xrSetInputDeviceStateFloatEXT));
CHECK_XRCMD(xrGetInstanceProcAddr(instance, "xrSetInputDeviceStateVector2fEXT", (PFN_xrVoidFunction*)&unity_xrSetInputDeviceStateVector2fEXT));
CHECK_XRCMD(xrGetInstanceProcAddr(instance, "xrSetInputDeviceLocationEXT", (PFN_xrVoidFunction*)&unity_xrSetInputDeviceLocationEXT));
+ CHECK_XRCMD(xrGetInstanceProcAddr(instance, "xrSetInputDeviceVelocityUNITY", (PFN_xrVoidFunction*)&unity_xrSetInputDeviceVelocityUNITY));
XR_TRACE_LOG(s_Trace, "[ConformanceAutomationExt] - script_initialize complete");
}
diff --git a/ConformanceAutomation/android.meta b/ConformanceAutomation/android.meta
index bc25424..25ef672 100644
--- a/ConformanceAutomation/android.meta
+++ b/ConformanceAutomation/android.meta
@@ -1,5 +1,5 @@
fileFormatVersion: 2
-guid: 1f52cd0d4b6446c7bf8d693801c00c92
+guid: e8e6abaa7e4e4396bf89d41b8cdcf5be
folderAsset: yes
DefaultImporter:
externalObjects: {}
diff --git a/ConformanceAutomation/android/arm64.meta b/ConformanceAutomation/android/arm64.meta
index ff7c4bc..8da1bc6 100644
--- a/ConformanceAutomation/android/arm64.meta
+++ b/ConformanceAutomation/android/arm64.meta
@@ -1,5 +1,5 @@
fileFormatVersion: 2
-guid: 9401590f41ee497a8a2c859bb9b69349
+guid: 67453f43ec4c43158c2b317948badc27
folderAsset: yes
DefaultImporter:
externalObjects: {}
diff --git a/ConformanceAutomation/android/arm64/ConformanceAutomationExt.so b/ConformanceAutomation/android/arm64/ConformanceAutomationExt.so
index 57a08b7fc9b9326ff3c0c6773c4162c5b6014b90..ca4307a8184252226d7cc8a3fcc1cc27457a2ebb 100644
GIT binary patch
delta 61201
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%0DLi-w1oh*DYkWmj1g6Dj_$#
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
b7pZtY(2KSYp8Rf+`Gq9zP1Wo*fA4<*wy>}f
delta 61142
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