# HoloLens 2 > ProjectAnywhereXR
###### tags: `AR`

:::spoiler Inhaltsverzeichnis
[toc]
:::

## Einleitung

### ProjectAnywhereXR

Das [ProjectAnywhereXR](https://www.unrealengine.com/en-US/blog/introducing-project-anywhere-xr-a-free-sample-project-for-mixed-reality-3d-geospatial-visualization) von Epic Games ermöglicht die Simulation von 3D-Kartenmaterial auf der Hololens 2. Dabei wird das Kartenmaterial vom Computer direkt auf die Hololens 2 gestreamt und ermöglicht somit die Darstellung von 3D-Kartenmaterial in der physischen Umgebung des Nutzers. Die folgende Anleitung erläutert dabei welche Schritte zum Einrichten eines ProjectAnywhereXR notwendig sind und wie dieses per Hololens 2 und Computer bedient wird.

### Vorraussetzungen
Um ein eigenes ProjectAnywhereXR erfolgreich aufsetzten zu können, müssen die folgenden Vorraussetzungen erfüllt sein.

+ [EpicGames Launcher](https://www.epicgames.com/store/de/download)
+ [Unreal Engine](https://www.unrealengine.com/en-US/download)
- [Plugin Cesium](https://www.unrealengine.com/marketplace/en-US/product/cesium-for-unreal)
- [Plugin Microsoft Mixed Reality UX](https://www.unrealengine.com/marketplace/en-US/product/mixed-reality-ux-tools)
- [Cesium Account](https://cesium.com/ion/signin/)
- Windows 10/11

Der EpicGames Launcher dient hierbei zur Installation der Unreal Engine sowie der benötigen Plugins. Desweiteren wird das ProjectAnywhereXR später ebenfalls per EpicGames Launcher heruntergeladen.

---
## Projekt aufsetzen

In den folgenden Schritten wird ein neues ProjectAnywhereXR angelegt und der zuvor erstellte Cesium Account so eingerichtet, dass dieser anschließend in der UnrealEngine mit dem ProjectAnywhereXR verbunden werden kann.

### ProjektAnywhereXR installieren
:::spoiler Anleitung
1. Download vom [ProjectAnywhereXR](https://unrealengine.com/marketplace/en-US/learn/project-anywhere-xr) mit dem EpicGames Launcher und erstellen eines neuen Projektes im Unreal Editor.
:::

### Cesium Account einrichten
:::spoiler Anleitung
2. Einloggen in den [Cesium ion](https://cesium.com/ion/signin/) Account.

3. Im **Asset-Depot** die folgenden **3D-Tildes** hinzufügen.

* Aerometrex Denver Photogrammetry
* Bing Maps Aerial
* Cesium OSM Buildings
* Cesium World Terrain
* Melbourne Photogrammetry


4. Auf **Access Token** gehen und **Create Token** auswählen, um einen Token zu generieren.


5. Im **Create Token** Menü einen neuen Token mit dem Namen "ProjectAnywhereXR" erstellen und die Einstellungen wie folgt aktivieren.

* **Scope**
* assets:list
* assets:read
* profile:read
* assets:write
* geocode

* **Ressources**: Selected assets aktivieren und die folgenden Assets hinzufügen.
* Aerometrex Denver Photogrammetry
* Bing Maps Aerial
* Cesium OSM Buildings
* Cesium World Terrain
* Melbourne Photogrammetry

Abschließend mit **Create** einen neuen Token erstellen.


6. Anschließend den **Token** kopieren damit dieser in den nächsten Schritten im Unreal Projekt eingefügt werden kann.

:::

### Unreal Editor "World Outliner" einrichten
:::spoiler Anleitung
7. Im Unreal Editor **World Outliner** die folgenden vier **3DTilsets** auswählen und anschließende den im 6. Schritt kopierten Cesium ion Token in das dafür vorgesehene Feld **Ion Access Token** einfügen.

* Cesium OSM Buildings
* Cesium Word Terrain
* Denver
* Melbourne Photogrammetry


8. Anschließenden wird der Token noch in das **3DTilset Cesium Word Terrain** unter dem Punkt **Bing Maps Aerial** in das Feld **Ion Access Token** eingefügt.


9. Abschließend erscheint das Projekt im Viewport des Unreal Editors und wir speichern die Einstellungen ab.

:::

---
## Computer mit HoloLens verbinden
Nachdem das Projekt erfolgreich erstellt wurde und im Viewport des Unreal Editors angezeigt wird, wird der Computer mit der HoloLens verbunden, um das Projekt auf die Hololens zu streamen.
:::spoiler Anleitung

1. Auf der HoloLens wird die App **Holographic Remoting** installiert, damit die Verbindung zum Computer herstellt werden kann.


2. Nachdem die App auf der Hololens gestartet wurde, wird die **IP-Adresse** der HoloLens im Display angezeigt. Die IP-Adresse der HoloLens wird in den nächsten Schritten benötigt.


3. Das Microsoft Windows Mixed Reality Plug-in muss unter **Settings** -> **Plug-ins** aktiviert sein.


4. Im Unreal Editor unter **Project Settings** -> **Platforms**, wird **Windows Mixed Reality** ausgewählt.


5. Unter **Windows Mixed Realtiy** werden die folgenden Einstellungen vorgenommen und die **IP-Adresse** der HoloLens eingegeben.


6. Abschließend wird druch **Connect** eine Verbindung zu der HoloLens aufgebaut, welche in der HoloLens noch bestätigt werden muss.


7. Ist die Verbindung erfolgreich hergestellt worden, wird dies wie im folgenden Bild dargestellt angezeigt.


8. Ist die HoloLens erfolgreich mit dem Computer verbunden, kann das Projekt per **Play Button** im Viewport über den **Modus VR Preview** auf die HoloLens gestreamt werden.



9. Der Streaming Mode auf dem Computer kann über die **ESC-Taste** wieder verlassen werden.
:::
---
## Navigation mit der HoloLens2
### Menü

Das Menü lässt sich durch Öffnen der linken Hand aufrufen. Mit der rechten Hand können anschließend die folgenden Optionen in der Menüleiste ausgewählt werden. Dazu können die einzelnen Punkte durch Antippen mit der rechten Hand ausgewählt werden.
:::spoiler Anleitung

* **Data Attribution**: Zeigt die Herkunft und Rechte der ausgewählten Map an.

* **Calibrate**: Ermöglich das Setzen des Feldes, in dem die Map angezeigt wird.

* **Move Up**: Ermöglicht das Anheben des durch Calibrate gesetzen Feldes, in dem die Map angezeigt wird.

* **Move Down**: Ermöglicht das Absenken des durch Calibrate gesetzen Feldes, in dem die Map angezeigt wird.

* **Rotate Left**: Ermöglicht das Drehen des durch Calibrate gesetzen Feldes um 90° nach links, in dem die Map angezeigt wird.

* **Rotate Right**: Ermöglicht das Drehen des durch Calibrate gesetzen Feldes um 90° nach rechts, in dem die Map angezeigt wird.

:::

### Feld platizeren

Nachdem im Menü auf **Calibrate** getippt wurde, kann ein Feld in dem die Map dargestellt werden soll, platziert werden. Dazu wird das Feld durch Bestätigung mit der rechten Hand, an einem beliebigen Ort platziert.
:::spoiler Anleitung

:::

### Globus drehen
Durch greifen des Reglers kann der Globus rotiert werden, um die gewünschte Location auswählen zu können.
:::spoiler Anleitung
:::

### Standort auswählen
Über die gelben Pins können die einzelnen Standorte ausgewählt werden. Dazu können die Pins mit der rechten Hand ausgewählt werden, bis diese rot aufleuchten und anschließend durch antippen ausgewählt werden. Die ausgewählte Location erscheint kurze Zeit später im gesetzten Feld.
:::spoiler Anleitung

:::

### Map bewegen
Durch das greifen der Map mit einer Hand, kann sich innerhalb der Map bewegt werden. Wenn die Map richtig gegriffen wurden, wird aus der gestrichelten eine durchgezogene Line.
:::spoiler Anleitung

:::

### Zoom
Sofern die Map mit der rechten Hand gegriffen wurden, um sich innerhalb der Map zu bewegen, kann durch die gleiche Aktion mit der linken Hand die Höhe verändert werden. Dazu muss, nachdem die Map mit beiden Händen gegriffen wurde, die linke Hand nach rechts oder links bewegt werden, um die Höhe zu verändern.
:::spoiler Anleitung

:::

---
:::info
 Dieses Dokument steht unter freier Lizenz:
[CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/deed.de).

* Autor: Steffen Schulz
* Ansprechpartner: [Rico Meiner](https://www.jade-hs.de/team-info/suche/?user=5598)
:::