VR-Klassenzimmer (VR Umgebung von Teach-R)

Allgemeine Information

Für einen Überblick zum Kernteam, Anwendungsfälle oder eine Einführung für Entwickelnde schauen Sie gern in unser Wiki.

Bedienungsanleitung (master branch)

Setup der Brille

Schließen Sie zuerst das Head mounted Display (HMD) an. Starten Sie SteamVR über Steam. Sofern vorhanden/nötig, starten Sie nun TPCast oder eine andere kabellose Erweiterung für Ihr HMD. Messen Sie eine c.a. 2m x 2m freie Fläche aus, die sogenannte Play area. (Größer ist natürlich auch möglich) (Optional) Kalibieren Sie den Eyetracker und die Playarea nach Anleitung des von Ihnen verwendeten Systems.

Starten des Klassenzimmers (aus Unity)

Für Interessierte, die mit uns entwickeln möchten, haben wir detailliertere Hinweise zusammengestellt, wie Sie sich in dem Projekt zurechtfinden können. Um Ihre Arbeit auch an andere weitergeben zu können, vergessen Sie nicht sich an gewisse Standards zu halten -> Open Source. Kurzanleitung (ohne Eyetracking). Beachten Sie auch die FAQ's.

1. Installieren Sie Unity Hub.
2. Installieren Sie Git und GitLFS, welches benötigt wird um größere Assets zu installieren.
3. Klonen Sie das Repository auf Ihren Rechner
4. Fügen Sie es in Unity Hub zu Ihren Projekten hinzu. Hier wird Ihnen die derzeitige Version angezeigt, die für das Projekt notwendig ist.
5. Installieren Sie die von Unity Hub vorgeschlagene Version von Unity.
6. Starten Sie das Projekt in Unity. Dieser Schritt wird einen Moment dauern, da Unity ein paar Einstellungen vornehmen muss. (Falls Sie programmieren möchten, raten wir auch zu einem Editor nach Präferenz - standardmäßig Visual Studio, alternativ Visual Studio Code oder Rider)
7. Standardmäßig lädt Unity beim ersten Starten eine leere Szene. Wählen Sie ein Klassenzimmer mit gewünschter Sitzordnung im Ordner "Assets/Scenes".
8. Klicken Sie auf den "Play-Button" oben in der Mitte. Nach einer kurzen Ladezeit startet die Anwendung.

Wenn das HMD richtig erkannt wurde, können Sie sich nun im VR Klassenzimmer mittels Teleportation (Touchpad auf den Controllern) oder realer Positionsänderung fortbewegen.

Starten des Frontend/ Coach / Website Control

Online

(Achtung die Usability ist etwas unterschiedlich) Aachener Instanz: https://coach-vr.elearn.rwth-aachen.de/

Potsdamer Instanz: https://teach-r.soft.cs.uni-potsdam.de/#/

Offline

Der Code wurde ausgelagert und ist aktuell unter diesem Link zu finden Link. Klonen Sie auch dieses Repository auf Ihren Rechner.

Achtung - aktuell wird die Applikation überarbeitet. Falls Sie an dieser Stelle auf Probleme stoßen, heißt das vermultich, dass wir die Dokumentation vernächlässigt haben. Bitte weisen Sie uns darauf schamlos hin. ;-)

1. Öffnen Sie auf in Ihrem File-Explorer das Projekt VR-Klassenzimmer und navigieren Sie in den Ordner "website-control~".
2. Mit einem Rechtsklick in den Ordner rufen Sie nun die Git-bash auf. Es öffnet sich eine Konsole.
3. Stellen Sie sicher, dass NodeJS installiert ist mit "npm -v". Sollte dies keine Version von NodeJS anzeigen, installieren Sie NodeJS und starten Sie die Konsole neu.
4. Folgend installieren Sie in der Konsole mit der Zeile "npm install @reduxjs/toolkit" sowohl redux, als auch das toolkit mit allen notwendigen plugins. Dies dauert einen Moment, danach können Sie die Konsole schließen.
5. Im website-control~ Ordner liegt eine Datei Namens "startCoach.sh", die Sie nun starten können. Nach einer kurzen Ladezeit öffnet sich Ihr Browser mit dem Frontend des Coachs.

In dieser Oberfläche können Sie die virtuellen Schülerinnen und Schüler steuern, indem Sie sich mit Unity verbinden und dann die Buttons mit Verhaltensweisen nutzen. Fortgeschrittene Nutzer:innen können Szenarien starten, die Medien steuern, geskriptete Unterrichtsszenarien vorbereiten und die Datensammlung für Learning Analytics steuern. Hierzu finden Sie seperate Dokumentationen.

Zum Beenden der Software klicken Sie in Unity erneut den Play-Button.

How To Cite

Um die Anwendung zu zitieren, nutzen Sie gern die CFF (hier aufbereitet als Website). Hier finden Sie eine Erklärung zur Zitierweise von Software. Wenn Sie Ihre Publikation mit in die Liste aufnehmen wollen, kontaktieren Sie gern Axel Wiepke.

Entwicklerinfos

Das GitLab eigene Issue-Tracking-System bietet (mehr oder weniger gut dokumentiert) einen Überblick über laufende und geplante Entwicklungen. Es wird außerdem zur Erfassung von Störungen, Fehlern und Anfragen verwendet. Einen Startpunkt für die Entwicklung stellt das GitLab eigene Wiki dar.

Bei Fragen und Anmerkungen wenden Sie sich gern an wiepke@uni-potsdam.de.