Museumsfunktionalität.md

+Die **Museumsfunktionalität** basiert auf [Geführte Navigation](https://gitlab.reutlingen-university.de/neuewelt9/nw9/-/wikis/Gef%C3%BChrte-Navigation), ist in diesem Modul integriert und führt sehenswerte Objekte in Gebäude 9. Dort angekommen besteht die Möglichkeit mit den Objekten zu interagieren, um mehr darüber zu erfahren. 
+
+![Gefuehrte_Navigation](uploads/48ee22e07229a913e724bad2c90601b9/Gefuehrte_Navigation.mp4)
+
+## Verwendetes Asset
+
+In den Meetings wurde sich für ein Pinguin-Asset entschieden, um eine größtmögliche Akzeptanz zu erhalten und eine Verbindung zur Informatik zu haben (Stichwort: Linux, Tux). Nach dem Testen unterschiedlicher kostenfreier Assets haben wir uns für einen Voxel-Pinguin entschieden, da dieser eine korrekte Bewegungsanimation, einen ideale Form und einen hohen Akzeptanzfaktor aufwies.
+
+![penguin](uploads/db145f62c47b2fca9a99550fa357b52a/penguin.PNG)
+
+License agreement: Standard Unity Asset Store EULA
+
+License type: Extension Asset
+
+Quelle: <https://assetstore.unity.com/packages/3d/characters/animals/5-animated-voxel-animals-145754>
+
+## Museum/Navigation
+
+Da die Museumsfunktionalität direkt in der geführten Navigation integriert ist, wählt man zunächst im Startmenü "Geführte Navigation" aus. Auf der nächsten Seite wird das "Gesuchte" (**Sehenswürdigkeiten** oder **Zeig mir alles**!) und anschließend das gewünschte Ziel ausgewählt. Wichtig ist hierbei, dass nicht jedes Objekt diese Museumsfunktionalität bietet. Beispiele mit der genutzten Museumsfunktionalität sind Bilder wie **Kongo Triptychon** oder **März**.
+Zuletzt wird die Auswahl mit **Navigation starten** bestätigt und die Navigation beginnt.
+
+![Mueseum_1](uploads/8ef349388fa3dc23207e7c47ad2a6e18/Mueseum_1.PNG)
+
+Die Objekte sind in einer JSON Datei hinterlegt, welche abseits des Codes angepasst werden kann. Die Struktur ist in diesem Format aufgebaut:
+
+```plaintext
+{
+  "rooms": [
+    {
+      "name": "Kongo Triptychon",
+      "description": "HAP Grieshaber",
+      "type":"Sehenswürdigkeiten"
+    },
+    {
+      "name": "März",
+      "description": "Josua Reichert",
+      "type":"Sehenswürdigkeiten"
+    },
+    {
+      "name": "Rhytmus",
+      "description": "Gerhard Köhler",
+      "type":"Sehenswürdigkeiten"
+    }
+    ...
+}
+```
+
+Die Datei ist im Ordner **.\\Assets\\StreamingAssets** und heißt **nw9rooms.json**. Dateien die im Ordner StreamingAssets abgelegt werden, können auch nach dem Buildprozess im Programmordner unter StreamingAssets bearbeitet werden.
+
+Sobald die Navigation gestartet wurde, startet der/die Spieler*in vor Gebäude 9 mit dem Pinguin. Auf dem Bildschirm wird ein Infotext angezeigt, der den/die Spieler*in darum bittet den Pinguin zu folgen.
+
+![Mueseum_2](uploads/48d533c3600c926dabbcfca9d203867c/Mueseum_2.png)
+
+Wenn der Pinguin am gewünschten Ziel angekommen ist, bleibt dieser stehen und der/die Spieler*in wird darüber in Kenntnis gesetzt, dass die Navigation nun zu Ende ist. Der/Die Spieler*in kann nun weiter frei im Gebäude herumlaufen, oder über zurück in das Startmenü wechseln. Durch die Museumsfunktionalität besteht die Möglichkeit mit dem Objekt zusätzlich zu interagieren, um weitere Informationen angezeigt zu bekommen.
+
+![Mueseum_3](uploads/c0d593038afa9d04b1e52a63f938254b/Mueseum_3.png)
+
+![museum_interaction_3](uploads/302891627172ca2f3f22d7f884de1b1f/museum_interaction_3.png)
+
+![museum_interaction_4](uploads/d268ef83cfe0a23e56a00b5d02a37ef2/museum_interaction_4.png)
+
+## Zugehörige Dateien
+
+### <ins>Szenen</ins>
+
+im Ordner **.\\Assets_Application\\Scene:**
+
+**GuidedNavigation**
+
+Beschreibung: Die Szene für die Navigation
+
+### <ins>Skripte</ins>
+
+im Ordner **.\\Assets\\\_Application\\Scripts\\Application:**
+
+**GlobalNavigationTarget.cs**
+
+Beschreibung: Als Klassenkonstrukt für den GlobalStorage
+
+Näheres unter: [Daten zwischen Szenen speichern oder austauschen](https://gitlab.reutlingen-university.de/neuewelt9/nw9/-/wikis/Daten-zwischen-Szenen-speichern-oder-austauschen)
+
+![global_nav_target](uploads/f3212c22b9d1f2db118f038ee98f1b29/global_nav_target.PNG)
+
+**ExtensionMethods.cs**
+
+Beschreibung: Erweiterung des <span dir="">NavMeshAgent</span>s um eine Distanzprüfung für den Pinguin zum Ziel
+
+Quelle: <https://stackoverflow.com/questions/61421172/why-does-navmeshagent-remainingdistance-return-values-of-infinity-and-then-a-flo>
+
+![ext_methods_1](uploads/2563a1f2436c394f32074caa6face537/ext_methods_1.PNG)
+
+![ext_methods_2](uploads/a493ce616617630e4c9a4717bc5ac89a/ext_methods_2.PNG)
+
+im Ordner **.\\Assets\\\_Application\\Scripts\\Controller:**
+
+**GuideMovementController.cs**
+
+Beschreibung: Die Navigationslogik
+
+![guided_movement_controller_1](uploads/0b13ea227a94f8cd1b8044365a173315/guided_movement_controller_1.PNG)
+
+![guided_movement_controller_2](uploads/e576d25e6c87558a67fea7a74cefd642/guided_movement_controller_2.PNG)
+
+**KeyInputController.cs**
+
+Beschreibung: Zur Verarbeitung der Controller- bzw. Tastatureingaben während dem Spiel
+
+im Ordner **.\\Assets\\\_Application\\Scripts\\Controller\\Museum:**
+
+**MuseumInteraction.cs**
+
+Beschreibung: Um mit Museumsobjekten zu interagieren
+
+![museum_interaction_1](uploads/9665b0e01ce4ae74810d6f355440bf18/museum_interaction_1.PNG)
+
+![museum_interaction_2](uploads/600b113db792fcee7259ae4857ba7740/museum_interaction_2.PNG)
+
+### <ins>Assets</ins>
+
+im Ordner **.\\Assets\\VoxelAnimals:**
+
+**Alles**
+
+Beschreibung: Der Voxel-Pinguin
+
+im Ordner **.\\Assets\\StreamingAssets:**
+
+**nw9rooms.json**
+
+Beschreibung: JSON-Datei mit Raumbezeichnungen und Beschreibungen
\ No newline at end of file