Skip to content

Commit 315e141

Browse files
authored
Merge pull request #202551 from dfields-msft/user/dfields/AoaRemotingUpdates
Update Unity Remoting instructions
2 parents d938ff7 + a0f937d commit 315e141

File tree

1 file changed

+10
-13
lines changed

1 file changed

+10
-13
lines changed

articles/object-anchors/quickstarts/unity-remoting.md

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: In this quickstart, you learn how to enable Unity Remoting in a pro
44
author: dfields-msft
55
manager: virivera
66
ms.author: dfields
7-
ms.date: 04/04/2022
7+
ms.date: 06/22/2022
88
ms.topic: quickstart
99
ms.service: azure-object-anchors
1010
ms.custom: mode-other
@@ -27,27 +27,24 @@ To complete this quickstart, make sure you have:
2727
|Component |Unity 2019 |Unity 2020 |
2828
|--------------------------------|-------------|-------------|
2929
|Unity Editor | 2019.4.36f1 | 2020.3.30f1 |
30-
|Windows Mixed Reality XR Plugin | 2.9.2 | 4.6.2 |
30+
|Windows Mixed Reality XR Plugin | 2.9.3 | 4.6.3 |
3131
|Holographic Remoting Player | 2.7.5 | 2.7.5 |
3232
|Azure Object Anchors SDK | 0.19.0 | 0.19.0 |
3333
|Mixed Reality WinRT Projections | 0.5.2009 | 0.5.2009 |
3434

3535
## One-time setup
3636
1. On your HoloLens, install version 2.7.5 or newer of the [Holographic Remoting Player](https://www.microsoft.com/p/holographic-remoting-player/9nblggh4sv40) via the Microsoft Store.
3737
1. In the <a href="/windows/mixed-reality/develop/unity/welcome-to-mr-feature-tool" target="_blank">Mixed Reality Feature Tool</a>, under the **Platform Support** section, install the **Mixed Reality WinRT Projections** feature package, version 0.5.2009 or newer, into your Unity project folder.
38-
1. In the Unity **Package Manager** window, ensure that the **Windows XR Plugin** is updated to version 2.9.2 or newer for Unity 2019, or version 4.6.2 or newer for Unity 2020.
39-
1. In the Unity **Project Settings** window, click on the **XR Plug-in Management** section, select the **PC Standalone** tab, and ensure that the box for **Windows Mixed Reality** is checked, as well as **Initialize XR on Startup**.
40-
1. Open the **Windows XR Plugin Remoting** window from the **Window/XR** menu, select **Remote to Device** from the drop-down, and enter your device's IP address in the **Remote Machine** box.
41-
1. Place .ou model files in `%USERPROFILE%\AppData\LocalLow\<companyname>\<productname>` where `<companyname>` and `<productname>` match the values in the **Player** section of your project's **Project Settings** (e.g. `Microsoft\AOABasicApp`). (See the **Windows Editor and Standalone Player** section of [Unity - Scripting API: Application.persistentDataPath](https://docs.unity3d.com/ScriptReference/Application-persistentDataPath.html).)
38+
1. In the Unity **Package Manager** window, ensure that the **Windows XR Plugin** is updated to version 2.9.3 or newer for Unity 2019, or version 4.6.3 or newer for Unity 2020.
39+
1. In the Unity **Project Settings** window, select the **XR Plug-in Management** section, select the **PC Standalone** tab, and ensure that the **Windows Mixed Reality** and **Initialize XR on Startup** checkboxes are checked.
40+
1. Place `.ou` model files in `%USERPROFILE%\AppData\LocalLow\<companyname>\<productname>` where `<companyname>` and `<productname>` match the values in the **Player** section of your project's **Project Settings** (for example, `Microsoft\AOABasicApp`). (See the **Windows Editor and Standalone Player** section of [Unity - Scripting API: Application.persistentDataPath](https://docs.unity3d.com/ScriptReference/Application-persistentDataPath.html).)
4241

4342
## Using Remoting with Object Anchors
43+
1. Launch the **Holographic Remoting Player** app on your HoloLens. Your device's IP address will be displayed for convenient reference.
4444
1. Open your project in the Unity Editor.
45-
1. Launch the **Holographic Remoting Player** app on your HoloLens.
46-
1. *Before* entering **Play Mode** for the first time, *uncheck* the **Connect on Play** checkbox, and manually connect to the HoloLens by pressing **Connect**.
47-
1. Enter **Play Mode** to finish initializing the connection.
48-
1. After this, you may reenable **Connect on Play** for the remainder of the session.
49-
1. Enter and exit Play Mode as needed; iterate on changes in the Editor; use Visual Studio to debug script execution, and all the normal Unity development activities you're used to in Play Mode!
45+
1. Open the **Windows XR Plugin Remoting** window from the **Window/XR** menu, select **Remote to Device** from the drop-down, ensure your device's IP address is entered in the **Remote Machine** box, and make sure that the **Connect on Play** checkbox is checked.
46+
1. Enter and exit Play Mode as needed - Unity will connect to the Player app running on the device, and display your scene in real time! You can iterate on changes in the Editor, use Visual Studio to debug script execution, and do all the normal Unity development activities you're used to in Play Mode!
5047

5148
## Known limitations
52-
* Some Object Anchors SDK features are not supported since they rely on access to the HoloLens cameras which is not currently available via Remoting. These include <a href="/dotnet/api/microsoft.azure.objectanchors.objectobservationmode">Active Observation Mode</a> and <a href="/dotnet/api/microsoft.azure.objectanchors.objectinstancetrackingmode">High Accuracy Tracking Mode</a>.
53-
* The Object Anchors SDK currently only supports Unity Remoting while using the **Windows Mixed Reality XR Plugin**. If the **OpenXR XR Plugin** is used, <a href="/dotnet/api/microsoft.azure.objectanchors.objectobserver.issupported">`ObjectObserver.IsSupported`</a> will return `false` in **Play Mode** and other APIs may throw exceptions.
49+
* Some Object Anchors SDK features aren't supported since they rely on access to the HoloLens cameras, which isn't currently available via Remoting. These include <a href="/dotnet/api/microsoft.azure.objectanchors.objectobservationmode">Active Observation Mode</a> and <a href="/dotnet/api/microsoft.azure.objectanchors.objectinstancetrackingmode">High Accuracy Tracking Mode</a>.
50+
* The Object Anchors SDK currently only supports Unity Remoting while using the **Windows Mixed Reality XR Plugin**. If the **OpenXR XR Plugin** is used, <a href="/dotnet/api/microsoft.azure.objectanchors.objectobserver.issupported">`ObjectObserver.IsSupported`</a> will return `false` in **Play Mode** and other APIs may throw exceptions.

0 commit comments

Comments
 (0)