Virtueller Campus. Virtueller Campus Horw mit interaktiver Steuerung. HowTo: Scripting-Komponente in Betrieb nehmen

Transkript

1 Virtueller Campus Virtueller Campus Horw mit interaktiver Steuerung Bachelor Diplomarbeit FS 2013

2 Inhaltsverzeichnis 1. EINLEITUNG SCRIPTING-KOMPONENTE AUF SERVER INSTALLIEREN JDK RICHTIG EINRICHTEN NEUES OBJEKT IN OPEN WONDERLAND MIT SCRIPTING-KOMPONENTE AUSSTATTEN EINFACHES SCRIPT FÜR DIE DREHUNG EINES OBJEKTS... 4 Abbildungsverzeichnis ABBILDUNG 1: INSTALLIERTE KOMPONENTEN AUF DEM SERVER... 1 ABBILDUNG 2: NEUSTARTEN DES DARKSTAR SERVER... 2 ABBILDUNG 3: JAVA JDK INSTALLIEREN OHNE PUBLIC JRE... 3 ABBILDUNG 4: BEISPIELOBJEKT IN OPEN WONDERLAND EINFÜGEN... 3 ABBILDUNG 5: KONTEXTMENÜ EINES OBJEKTES AUSWÄHLEN... 4 ABBILDUNG 6: SCRIPTING COMPONENT DEM OBJEKT HINZUFÜGEN... 4 ABBILDUNG 7: EINFÜGEN EINES SCRIPTS IN DEN SCRIPTEDITOR... 5 Dominik Alessandri I

3 1. Einleitung Mit der Scripting Component aus dem Modul Warehouse kann die Funktionalität von beliebigen Zellen im Open Wonderland erweitert werden. Um die Scripting-Komponente in Betrieb zu nehmen, sind folgende Vorbedingungen nötig: Laufender Open Wonderland Server scripting-component-module.jar o Selber kompilieren oder Module Warehouse Installiertes JDK 1.7 (Client) 2. Scripting-Komponente auf Server installieren Als erstes muss die Scripting-Komponente auf dem Server installiert werden. Dazu wählt man in der Administrationsoberfläche den Menüpunkt Manage Modules : Abbildung 1: Installierte Komponenten auf dem Server Mit einem Klick auf Choose File kann das File scripting-component-module.jar ausgewählt werden. Ein abschliessender Klick auf Install überträgt das Modul auf den Server. Dominik Alessandri 1

4 Neu installierte Module werden erst bei einem Neustart des Darkstar Servers aktiv. Dazu wählt man im Menüpunkt Manage Server die Aktion restart für die Komponente Darkstar Server : Abbildung 2: Neustarten des Darkstar Server Die Scripting-Komponente ist nun korrekt installiert und kann verwendet werden. 3. JDK richtig einrichten Mit der Scripting Component ist es möglich, den im Open Wonderland vorhandenen Objekten zu mehr Fähigkeiten (Animationen, Positionsverschiebungen etc.) zu verhelfen. Dazu werden die Scripts zur Laufzeit kompiliert, was ein JDK voraussetzt. Tests des Projektteams haben ergeben, dass neue Scripts nur geschrieben werden können, wenn eine JDK installiert ist. Die JRE reicht nicht aus, um Scripts zu kompilieren. Für die Ausführung einmal kompilierter Skripte reicht eine JRE jedoch aus. Am einfachsten deinstalliert man vorgängig alle vorhandenen JRE und JDK Versionen auf dem System und lädt die aktuellste JDK-Version von herunter. Während der Installation deaktiviert man die Option Public JRE : Dominik Alessandri 2

5 Abbildung 3: Java JDK installieren ohne Public JRE Nach erfolgreicher Installation muss die Umgebungsvariablen PATH angepasst werden, damit der Open Wonderland Client mit der JRE des JDK s ausgeführt wird. Folgender Eintrag ist dazu nötig: C:\Program Files\Java\jdk1.7.XXXX\jre\bin; Der Computer erfüllt nun alle Voraussetzungen, um Scripts für Zellen im Open Wonderland zu implementieren. 4. Neues Objekt in Open Wonderland mit Scripting-Komponente ausstatten Die Scripting-Komponente kann nun einem eingefügten Objekt hinzugefügt werden. Dazu wählt man bei geöffnetem Client den Menüpunkt Einfügen -> Modell. Im geöffneten Dialog kann nun ein Modell ausgewählt werden. In diesem Beispiel ist das der Audiorekorder: Abbildung 4: Beispielobjekt in Open Wonderland einfügen Dominik Alessandri 3

6 Das Objekt befindet sich nun in der Nähe des Avatars: Abbildung 5: Kontextmenü eines Objektes auswählen Mit einem Rechtsklick auf das Objekt geht das Kontextmenü auf. Hier wählt man den Punkt Eigenschaften. Es öffnet sich der Objekteditor. Unter den Fähigkeiten klick man auf den Button +. Es öffnet sich der Dialog, wo dem Objekt Fähigkeiten hinzugefügt werden können: Abbildung 6: Scripting Component dem Objekt hinzufügen Hier wählt man die Scripting Component und bestätigt mit einem Klick auf OK. Das Objekt ist nun fähig, bei bestimmten Ereignissen Scripts auszuführen. 5. Einfaches Script für die Drehung eines Objekts Wir möchten nun, dass sich das Objekt dreht, wenn man mit der linken Maustaste draufklickt. Dazu öffnet man den Scripting Editor mit einem Rechtsklick auf das Objekt und anschliessender Auswahl Dominik Alessandri 4

7 von Scripting Editor. Wurden die Arbeiten aus Kapitel 3 richtig ausgeführt, öffnet sich nun der Scripting Editor. Als erstes klickt man auf den Knopf Retrieve Properties, damit das Script weiss, auf welchem Objekt es ausgeführt werden soll. Es füllt sich das Feld Object mit dem Namen des Objektes. Nun kann das Script geschrieben werden. Für eine einfache Rotation kann folgendes verwendet werden: print("hello, this is the rotate test-script"); var v = new java.lang.runnable() { run: function() { increment = (Math.PI/2)/90; for(i = 0; i <= 90; i++) { MyClass.rotateObject(0, 1, 0, -increment, 1); MyClass.mySleep(50); } } } t = new java.lang.thread(v); t.start(); Wichtig zu wissen ist, dass ein Script immer in einem eigenen Thread ausgeführt werden muss. Wird ein Script direkt ausgeführt, ist wird der Avatar blockiert und er kann erst wieder bewegt werden, wenn das Script seine Aufgabe ausgeführt hat. Wurde alles richtig gemacht, sieht der Scripting Editor wie folgt aus: Abbildung 7: Einfügen eines Scripts in den Scripteditor Dominik Alessandri 5

8 Mit einem Klick auf Save Script wird das Script auf dem Server gespeichert. Mit einem Klick auf Test Script sieht man, wie der Audiorekorder sich dreht. Dominik Alessandri 6