Virtueller Campus. Virtueller Campus Horw mit interaktiver Steuerung. HowTo: Non-Player Character (NPC) in Betrieb nehmen

Transkript

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

2 Inhaltsverzeichnis 1. EINLEITUNG WAYPOINTS AUFZEICHNEN AVATAR FÜR NPC EINFÜGEN EINES NPC NPC MIT SCRIPTS AUSSTATTEN... 7 Abbildungsverzeichnis ABBILDUNG 1: NPC AVATAR AN BELIEBIGER STELLE PLATZIEREN... 1 ABBILDUNG 2: ROBOT SEQUENCE ERZEUGEN... 2 ABBILDUNG 3: ROBOT SEQUENCE ABSPEICHERN ALS WAYPOINT... 2 ABBILDUNG 4: ALLE WAYPOINTS AUFGEZEICHNET... 3 ABBILDUNG 5: SPEICHERN DES ROBOT-FILES... 3 ABBILDUNG 6: ANSICHT DES ROBOT-FILES AUF DEM SERVER... 4 ABBILDUNG 7: AVATARTYPEN DES NPC... 4 ABBILDUNG 8: AVATARBASEART PROJEKT IM NETBEANS ÖFFNEN... 5 ABBILDUNG 9: OBJEKTAUSWAHL DER OPEN WONDERLAND... 6 ABBILDUNG 10: EIGENSCHAFTEN DES NEUEN NPCS... 6 ABBILDUNG 11: SCRIPT DES NPCS FÜR DEN AVATAR HOLEN... 7 ABBILDUNG 12: AVATAR FÜR DEN NPC AUSWÄHLEN... 9 ABBILDUNG 13: ANSICHT DES NPCS IM OPEN WONDERLAND... 9 Dominik Alessandri I

3 1. Einleitung Ein NPC (Non-Player Character) ist ein Avatar im Open Wonderland, welcher nicht von einem Benutzer gesteuert wird. Der NPC, auch Robot genannt, kann durch Scripts erweitert werden. Um die Funktionalität der Robots verwenden zu können, sind folgende Vorbedingungen nötig: Scripting-component.jar, Version vom Projektteam (muss Funktion playrobotframeloop() enthalten) NPC.jar (Modul im Module Warehouse) SSH-Zugang auf Server 2. Waypoints aufzeichnen Die Scripting Component bietet die Möglichkeit, Waypoints aufzuzeichnen. Ein Waypoint ist die nummerische Beschreibung einer Lokation im Open Wonderland und wird mit X- Y- und Z- Koordinaten repräsentiert. Der Ablauf der Aufzeichnung der Waypoints ist wie folgt: 1. Avatar an gewünschter Stelle positionieren 2. Position des Avatars ermitteln 3. Koordinaten aufnehmen 4. Schritte 1, 2 und 3 wiederholen bis ein geschlossener Ablauf entsteht Der Avatar kann also an die gewünschte Stelle positioniert werden: Abbildung 1: NPC Avatar an beliebiger Stelle platzieren Nun wird die Scripting Component im Tab Robot aufgerufen und eine Robot Sequence erstellt. Dafür kann links oben der Modus auf Create Robot Sequence gestellt werden: Dominik Alessandri 1

4 Abbildung 2: Robot Sequence erzeugen Die wichtigsten Knöpfe sind Get Avatar Location und Create Step. Da der Avatar für den ersten Waypoint richtig positioniert ist, können nacheinander die Knöpfe Get Avatar Location und Create Step gedrückt werden. Die aktuelle Position erscheint im Fenster auf der rechten Seite: Abbildung 3: Robot Sequence abspeichern als Waypoint Die Prozedur kann nun so lange wiederholt werden, bis der gesamte Pfad im Fenster rechts steht: Dominik Alessandri 2

5 Abbildung 4: Alle WayPoints aufgezeichnet Im Eingabefeld Robot File kann nun der Name des Waypoint-Files definiert werden, in diesem Beispiel ist er RobotIHomeLab_Laufweg. Anhängen möchten wir den Pfad dem Robot RobotIHomeLab, was wir im Feld NPC Name definieren können: Abbildung 5: Speichern des Robot-Files Mit einem Klick auf Write Robot File wird das Pfad-File auf den Server geschrieben. Auf dem Server ist das File im Ordner /.wonderland-server/0.5-dev/run/content/robots vorhanden. Dominik Alessandri 3

6 Abbildung 6: Ansicht des Robot-Files auf dem Server 3. Avatar für NPC Hat man das NPC-Modul auf dem Server installiert, ist es sofort verfügbar und ein NPC kann ohne weiteres in die Welt eingefügt werden. Der Standard Avatar ist ein Azteken-Krieger. Für eine Welt, wie es der virtuelle Campus ist, passt das nicht. Beim NPC unterscheidet man zwischen zwei verschiedenen Avatartypen: IMI-Avatar und Evolver-Avatar. Abbildung 7: Avatartypen des NPC Wenn das Open Wonderland in der Standard-Konfiguration verwendet wird, so steht lediglich der Evolver-Avatar (Azteken-Krieger) zur Verfügung. Um nun die IMI-Avatare zu aktivieren, muss dem Modul avatarbaseart eine Datei mit allen vorhanden Standard-Avataren hinzugefügt werden. Hierzu muss das Modul im Netbeans geöffnet werden. Dominik Alessandri 4

7 Abbildung 8: Avatarbaseart Projekt im Netbeans öffnen Nun haben wir die Möglichkeit, dieses Projekt über das build.xml neu zu kompilieren und zu packen. Es ist jedoch so, dass ein neues Packen des JARs nicht ausreicht. Im Verzeichnis art -> assets -> configurations des Projektes muss eine Datei mit dem Namen content.txt erzeugt werden. In dieser Datei ist eine Auflistung aller XML-Dateien gespeichert. Diese Datei kann entweder manuell oder mit der Konsole erzeugt werden. Der Befehl für die Konsole sieht wie folgt aus: Windows: dir *.xml /b >> content.txt Linux: ls *.xml > content.txt Ist die Datei mit dem Namen content.txt erzeugt, kann das Modul mit dem Build-Target dist neu gepackt werden. Das erzeugte JAR wird über die Adminkonsole auf den Server deployed. Dominik Alessandri 5

8 4. Einfügen eines NPC Am Startpunkt des Pfades wird nun ein NPC eingefügt. Dies geht über das Menü unter Einfügen -> Objekt. In der erscheinenden Auswahl wird NPC gewählt und mit einem Klick auf Hinzufügen erscheint der NPC im Open Wonderland. Abbildung 9: Objektauswahl der Open Wonderland In den Eigenschaften des NPC s wird nun ein Name definiert. Optimal ist, wenn der Name mit dem vorhin aufgezeichneten Waypoint-File korrespondiert. Der Name lautet in unserem Fall RobotIHomeLab : Abbildung 10: Eigenschaften des neuen NPCs Mit einem Klick auf Anwenden wird der Name übernommen. Der NPC lässt sich ab sofort mit diesem Namen ansprechen. Dominik Alessandri 6

9 5. NPC mit Scripts ausstatten Der NPC muss nun wissen, welchen Pfad er entlanglaufen soll. Auch soll er seine Arbeit beim Eintritt in die Welt aufnehmen. Mit einem Rechtsklick auf den NPC -> Scripting Editor wird der Scripting Editor geöffnet. Als erstes muss der Button Retrieve Properties betätigt werden. Für unsere Funktion möchten wir die beiden Skripte avatar.js und startup.js überschreiben. Dazu wählen wir zuerst das Skript avatar.js und klicken auf Retrieve Script : Abbildung 11: Script des NPCs für den Avatar holen Das Fenster bleibt leer, da noch kein Skript hinterlegt wurde. Folgendes Skript dient der Avatar- Steuerung: print('enter avatar.js script\r\n'); print('event type - ' + avatareventtype + '\r\n'); print('event source - ' + avatareventsource + '\r\n'); print('event animation - ' + avatareventanimation + '\r\n'); if(stateint[0] == 0) if(avatareventtype == 'STARTED') if(avatareventanimation == 'Walk') stateint[0] = 1; stateint[1] = 0; stateint[2] = 1; stateint[3] = 0; if(avatareventanimation == 'Male_PublicSpeaking' avatareventanimation == 'Female_PublicSpeaking') stateint[0] = 1; stateint[1] = 0; stateint[2] = 1; stateint[3] = 1; else if(avatareventtype == 'STOPPED') Dominik Alessandri 7

10 if(avatareventanimation == null) stateint[3]--; else stateint[2]--; if(stateint[1] == 0 && stateint[2] == 0 && stateint[3] == 0) stateint[0] = 0; print('playing next frame\r\n'); if(stateint[4] == 1) stateint[4] = MyClass.playRobotFrame(); Mit einem Klick auf Save Script wird das Skript auf den Server geschrieben. Das Skript startup.js sieht wie folgt aus. Die fett markierten Stellen müssen den Gegebenheiten angepasst werden: var ihomelabthread = new java.lang.runnable() run: function() //Dateiname auf Server (Robot File) MyClass.buildRobot('RobotIHomeLab_Laufweg'); //Folder im Robots Content (NPC Name) MyClass.setNpcAvatarName('RobotIHomeLab'); stateint[0] = 0; stateint[1] = 0; stateint[2] = 0; stateint[3] = 0; stateint[4] = 1; MyClass.enableAvatarEvents(); while(true) MyClass.playRobotFrameLoop(); startihomelab = new java.lang.thread(ihomelabthread); MyClass.mySleep(2500); startihomelab.start(); Das Skript wird wiederum mit einem Klick auf Save Script auf dem Server gespeichert. Dem NPC kann über den Objekteditor ein anderes Aussehen verpasst werden. Dazu ruft man Werkzeuge -> Objekteditor auf. Bei der Fähigkeit NPC kann dem Objekt RobotIHomeLab der Avatar Type auf IMI Avatars gestellt werden. Im Dropdown kann nun das Aussehen des NPC s definiert werden. Mit einem Klick auf Anwenden wird die Einstellung gespeichert: Dominik Alessandri 8

11 Abbildung 12: Avatar für den NPC auswählen Sobald der NPC im Blickfeld des Benutzers erscheint, wir das Startup-Skript ausgeführt. Nach einer Neuanmeldung sollte der NPC also den vordefinierten Pfad ablaufen und beim Erreichen des letzten Waypoints wieder mit dem ersten beginnen (Funktion playrobotframeloop() ): Abbildung 13: Ansicht des NPCs im Open Wonderland Dominik Alessandri 9