avameo » APIs

Second Life öffnet sicher weiter

Patrick — Tue, 14 Jul 2009 19:37:05 +0000

Während Linden Lab die HTML on a Prim-Diskussion offensichtlich verschläft und weiterhin unklar ist, inwiefern sich das Second-Life GRID künftig öffnet wird und am HyperGRID partizipieren wird, vereinfacht Linden Lab nun die Schnittstelle, um von außen an InWorld-Objekt zu gelangen.

Über ein Tweet von Andreas Romppel bin ich auf den WebMetrics-Guru Marshall Sponder aufmerksam geworden. Sponder beschäftigt sich bereits seit 2007 mit Metriken für Virtuelle Welten. Offensichtlich hat Sponder ein vergleichbares Produkt zu unserer Kennzahlenerhebung, die wir mittels unseren Landscanners erheben und auswerten.

Das Ganze nennt sich HTTP In and LSL Communications und vereinfacht die Kommunikation mit InWorld-Objekten von außen erheblich. Bisher war dies nur mit einem sehr "krückenhaften" XML-RPC-Call möglich, wie wir dies im Februar 2007 in unserem TechTalk demonstrierten. Details für die aktuelle Ansteuerung von InWorld-Objekten mittels der UUID findet man in diesem Wiki

3D-Internet-Standards: Google mischt mit

Patrick — Wed, 22 Apr 2009 14:37:32 +0000

Über Nicolas Dorwig bin ich gerade auf die Aktivitäten von Google im Bereich 3D-Unterstützung für Browser aufmerksam geworden (siehe auch auf Golem). O3D heißt das neue Wunderkind, ein Browser-PlugIn, welches eine shader-basierte Low-Level-API bereitstellt.

Hier ein Video dazu:

Weitere Links:

IETF diskutiert Standards für Avatare

Patrick — Sun, 05 Apr 2009 07:40:54 +0000

Im März trafen sich einige wichtige Meinungsmacher auf einer Konferenz der Internet Engineering Task (IETF) Force in San Fransisco. Top Thema war die Harmonisierung evtl. Standards und die Interoperabilität zwischen verschiedenen Metaversen wie Second Life und World of Warcraft.

Der heise-Bericht vom 29.03.2009 liest sich allerdings, als ob verschiedene Vertreter mit grundsätzlich unterschiedlichen Anforderungen und Zielen an die Sache gehen.

Kein Wunder, denn das Unterfangen, Second Life, Word of Warcraft und Weblin unter einen "Hut" zu bringen erscheint mir schier unmöglich.

Parallel zu den agilen Internet-Machern, den Betreibern der Plattformen wie Second Life, World of War und Weblin, mischen sich die schwergewichtigen und trägen Strategen in das Spiel ein, wie wir am 27. März berichteten. Hier geht es dann um die Protokolle und Formate wie Canvas3D, Java3D, OpenCL, OpenGL, VRML, X3D.

Natürlich sind diese Diskussionen längst überfällig. Zudem sind Machtspielereien und Angst vor Kontrollverlusten der Diskussionen nicht förderlich.

Dabei hat voraussichtlich der OpenSimulator mit dem OpenGrid-Protokoll gute Chancen, obschon Christian Scholz auf eine Liste der Einzelprobleme aufmerksam machte, die einen einzelenen Standard als unrealistisch erscheinen lassen.

In einer Welt mit stark anwachsender Komplexität wird die Kontrolle immer schwieriger, gezielte und gesteuerte Entscheidungen immer unwahrscheinlicher aufgrund unterschiedlicher Interessen und Meinungen.

Es stellt sich die Frage inwiefern die IETF oder das W3C bei den schnellen Entwicklungen tatsächlich positiv mitwirken können? Ich sehe hier eher emergente, sich selbst entwickelnde Strukturen, die globale und gute Defacto-Standards prägen auf Basis von OpenSource-Lösungen und hochmotivierten Individuen die im Netz effektiv und effizient zusammenarbeiten.

Registrierung vereinfacht

Patrick — Wed, 10 Oct 2007 09:08:40 +0000

Der Geburtsort von Second Life® konnte ja schon seit langem über die Registration API festgelegt werden. Damit ist es quasi möglich, relativ einfach den "SL-Geburtsort" eines Resident zu beeinflussen, um somit einfach eine Community aufzubauen.

Ist man quasi von Seiten Linden Lab® in Second Life® eingestiegen, war der bevorzugte Geburtsort Orientation Island, die man bekanntlich nur einmal besuchen kann.

Da ich für einen Second Life®-Kurs gerade ein Tutorial erstelle habe ich mir noch einmal die aktuelle Registrierungs-Prozedur angeschaut. Dabei habe ich gesehen, das sich hier einiges geändert hat.

Ab sofort werden von Linden Lab® auch auf der Second Life®-Seite "fremde" Communities unterstützt.

Wie man sieht arbeitet hier Linden Lab® auch daran, den Einstieg in Second Life® bequemer und einfacher zu gestalten

TechTalk #5 – Webmap API Guide – HowTo

Patrick — Fri, 01 Jun 2007 14:32:12 +0000

Hallo, liebe TechTalk-Leser. Heute stellen wir Euch die WebMap-API von Linden Lab® vor. BETA, was sonst. Und deshalb vorneweg. Mit dem Internet Explorer inder der version 7 könnt ihr es direkt vergessen. Richtig! Firefox auspacken oder IE 5 ging bei mir. IE 6 ist laut Dokumentation ebenfalls getestet! Was kann man mit der WebMapAPI machen? Also links im Bild sehr ihr die KybernEthik 1 von oben. Also die Map, welche ihr auch mit dem SL-Client seht. Diese Funktionalität lässt sich relativ einfach in beliebige Webseiten und Webanwendungen einbauen. Dies geschieht mit einer JavaScript-API. Und genau um die soll es in diesem Mini-TechTalk gehen! Wozu man das benutzen kann? Gaaanz einfach! Nehmen wir zum Beispiel den Landscanner von SLTalk & Partner. Das ist ein Scanner, den der SIM-Owner überall auf seinem SIM aufstellen kann, beliebig viele. Über ein komfortables Web-Frontend kann der Betreiber einer SIM alle möglichen Daten abrufen, zum Beispiel wie die Besucherfrequenzen seiner SIM sind oder die durchschnittliche Verweildauer bis hin, wie sich die SIM-Performance in einem bestimmten Zeitraum verhalten hat. Über das Web-Frontend kann man nun die Karte der SIM mittels der JavaScript-API anzeigen und sogar Marker setzen, wo die ganzen Scanner stehen, damit er sie schnell findet. Er kann sich sogar über diese Map direkt dorthin teleportieren. Praktisch oder? Aber schauen wir uns das Ganze einmal wie in gewohnter SL-techTalk-Tiefe an . Haaaaands on! Die folgenden drei Knöpfe sind JavaScript gesteuert. Möglicherweise dauert es einige Sekunden, bis ihr die Buttons sehen könnt, da die JavaScript-API und einige Daten von den Linden Lab-Servern geladen werden müssen.

Nachdem ihr Euch ein wenig vertraut gemacht habt, was die API liefern kann, möchte ich jetzt ein wenig technischer werden. Zunächst muss die JavaScript-API in die HTML-Seite eingebettet werden. Dies geht so:

Einbinden der WebMap API

Nachfolgender Code lädt die API in Form eines Javascript-Include ein.

JavaScript WebMap API

Für die harten JavaScript-Hacker unter Euch, hier der Link zur API. Aber ehrlich gesagt ist JavaScript eigentlich nicht so mein Ding. Soweit so gut. Die API haben wir. Jetzt müssen wir nur noch eine Map erzeugen, und das geht so:

Erzeugen einer Map mit JavaScript-Aufrufen

Nachfolgender Code erzeugt eine Instanz der Klasse SLMap, sofern man bei JavaScript objektorientierte Begriffe nutzt Die Hashmap options benutze ich, um die Scrollbuttons auszuschalten, insgesamt kann man hier noch weitere Parameter angeben. Die JavaScript-Instanz wird über den DOM an ein DIV-Element map-container gebunden, welches ich im nächsten Schritt anspreche. Über die Klasse SLPoint definiert Ihr den Kartenausschnitt innerhalb Second Life® !


var options = new Array()
options['hasPanningControls'] = false;
mapInstance = new SLMap(
document.getElementById('map-container'), options);
mapInstance.centerAndZoomAtSLCoord(
new SLPoint('KybernEthik 1',128,128),0);

JavaScript WebMap API

Die meisten Anwender wrappen diesen Code in eine JavaScript-Funktion createMap() und rufen diese Funktion über das onload()-Event des HTML-Body-Tags auf. Ich habe diesen Code auf einen Button gelegt, deshalb müsst ihr auch erst einmal den Button klicken, bevor eine Karte erscheint. Kommen wir zu dem HTML-Div-Element. Über dieses Element wird definiert, wo auf eurer HTML-Seite die Map erscheinen soll:

Div-Container für die Positionierung der Mal

Das ist recht easy. Über einen Style im CSS könnt ihr dieses Div-Element auch nich etwas stylen bzw. sizen. Das zeige ich Euch im nächsten Schritt.

Div-Container für die Map

Wie bereits erwähnt, hier noch der Style für den Map-Container. Entweder passt ihr dies im CSS an oder direkt in eurer HTML-Seite.

Div-Container im CSS stylen

So sieht mein Abschnitt für den Map-Container in meinem CSS aus.

div#map-container {
      width: 450px;
      height: 450px;
}

Div-Container für die Map stylen und sizen

Wenn ihr erstmal eine Map habt, könnt ihr viele tolle Dinge tun (Schaut Euch die API-Reference hierzu im Detail an). Ihr könnt mit der API beliebige Grafiken an bestimmten Positionen legen, um z.B. etwas zu markieren oder Ihr könnt ein Infofenster mit einer Grafik der Region anzeigen. Hier mein Code, der ausgeführt wird, wenn Ihr auf den Button "Zentrum zeigen" klickt.

Hinzufügen eines MapWindows zu einer mapInstance

So könnt ihr der Instanz der Klasse SLMap ein MapWindow hinzufügen. Beachtet, dass ich auch hier wieder eine JavaScript Hashmap verwende, um das Window nach meinen Bedürfnissen zu sizen. Dem Konstruktor der Klasse MapWindow könnt ihr beliebiges HTML übergeben. Escapen nicht vergessen !!!!

var options = new Array()
options['width'] = 220;
options['height'] = 220;
var mapWindow = new MapWindow("
",options);
mapInstance.addMapWindow(mapWindow,
new SLPoint('KybernEthik 1',128,128));

Erzeugen und positionieren eines Markers in der SLMap.

So nun geht es zum Endspurt. Das Tagging bzw. das setzen von Markern. Wozu das gut sein soll? Na dann schaut mal bei Sloog - tagging the whole new world rein. Oder, wie bereits erwähnt, so ein Web-Frontend für die Administration von Landscannern ist ebenfalls solch ein Anwendungsbeispiel.

Hinzufügen eines MapWindows zu einer mapInstance

Zunächst wird eine Grafik auf eurem Webserver an eine JavaScript-Klasse Img gebunden. Dann bastelt ihr daraus ein Icon. Und dann baut ihr ein Array auf. Dann wird einfach noch eine Instanz der Klasse Marker erzeugt, natürlich mit den Icons und einer SL-Position unter Verwendung der Klasse SLPoint. Und dann nur noch mit der Methode addMarker der SLMap hinzufügen. Simpel, oder?

var yellow_dot_image = 
new Img("http://hier_die_bild_url.xy/b_map_yellow.gif",30,30);
var yellow_icon = new Icon(yellow_dot_image);

var all_images = 
[yellow_icon, yellow_icon, yellow_icon, 
yellow_icon, yellow_icon, yellow_icon];

var marker = new Marker(all_images, 
new SLPoint('KybernEthik 1',128,128));

mapInstance.addMarker(marker);

Erzeugen und setzen eines Markers in der SLMap.

So Leute das war's erstmal. Der Patrick muss jetzt noch ne Tomcat-Schulung vorbereiten und sich deshalb hier mal vom WordPress-Acker verabschieden. TschüSS und bis zum nächsten Mal.
Achja, bevor ich es vergesse, hier zum Schluß der allerwichtigste Link zu diesem Thema: Link zur WebMap-API: http://secondlife.com/developers/mapapi/"

Java WIMS- und RPC-API von SLTalk & Partner

Patrick — Sun, 25 Mar 2007 17:49:32 +0000

Wer anspruchsvolle Projekte in Second Life® umsetzen möchte, merkt schnell, dass eine Komponente wie ein Business-Server erforderlich wird. Insbesondere in Projekten im kommerziellen Umfeld, bei denen es um mehr geht als die einfache Darstellung von 3D-Modellen. Hier geht es oftmals darum Gewinnspiele zu managen, Alterskontrollen zu realisieren, Transaktionen entlang einer Wertschöpfungskette zu steuern und zu monitoren oder sonstige Businesskomponenten auszulagern. Mit der InWorld-Sprache LSL kommt man nicht unbedingt weiter. LSL ist auf ca. 320 Build-In-Funktionen beschränkt, komplexere Datenstrukturen, Modularisierung und andere Standardkonzepte sind nicht möglich. Hier verliert man schnell den Überblick, wenn es um anspruchsvollere Anwendungen geht. Linden Lab® hat Second Life® glücklicherweise über das HTTP-Protokoll nach außen geöffnet. Von außen nach innen gelangt man über XML-RPCs. Somit ist schon einmal die Grundlage geschaffen, damit man geschäftsprozessübergreifende Komponenten nach außen verlagern kann. Und in der Tat empfehlen wir jedem, der anspruchsvollere Anwendungen realisieren möchte, die Businesslogik auf einen eigenen Business-Server auszulagern. SLTalk & Partner implementiert im Rahmen der Projekte Standardkonzepte und generische Frameworks, sodaß ein hohes Maß an Wiederverwertbarkeit und schnellere Projektlaufzeiten ermöglicht werden. Ein Resultat unserer Arbeit ist eine API, die es ermöglicht von einem Java-Business-Server XML-RPCs InWorld aufzurufen. Die API wird als Java-Archiv ausgeliefert und ist mit knapp 170 KB recht schlank. Bestandteil des JARs sind die XML-RPC-Klassen der Apache-Foundation sowie die Wrapper-Klassen von uns.

Klasse	Beschreibung
WIMDDemo.java	Ist eine Demo für einen WIMS-Java-Client und ruft unseren WIMS-Service auf Kybernethik 1 auf.
RPCDemo.java	Ist die etwas mehr generischere Version und ermöglicht es jeglichen XML-RPC-Server in Second Life® aufzurufen.
avameo.jar	Enthält die notwendigen XML-RPC-Klassen der Apache Foundation sowie die nachfolgenden Wrapper-Klassen von SLTalk & Partner
de.avameo.rpc.client.RPCClient	Mit dieser Klasse lassen sich mit Leichtigkeit beliebige XML-RPC-Clients realisieren, welche InWorld-XML-RPC-Server aufrufen
de.avameo.rpc.client.RPCClientFactory	Diese Klasse implementiert das Factory-Pattern, um einen RPCClient für einen bestimmten Channel zu erzeugen
de.avameo.rpc.wims.WIMSClient	Ist ein spezieller Client, welcher unseren WIMS-Servive auf Kybernethik 1 ansteuert. Mit diesem Java-Client kann man von außerhalb Second Life® Instant Messages an Residents schicken.
de.avameo.rpc.common.Key	Diese Klasse repräsentiert eine Second Life® UUID und lässt nur gültige UUID-Keys zu.
de.avameo.rpc.common.InvalidUUIDKeyException	Diese Exception wird von der Klasse Key geworfen, wenn mit einem String keine gültuge SL-UUID erzeugt werden kann.

Es wurde bewußt darauf geachtet, die API möglichst schlank zu halten, um die Anwendung für den Entwickler so einfach wie möglich zu gestalten. In diesem Beitrag stelle ich daher unseren generischen SL-XML-RPC-Client vor und eine spezielle Implementierung dieser API, die unseren kostenlosen WIMS-Service auf KybernEthik 1 ansteuert. Eine WIMS (Web Instant Message 2 Secondlife) lässt sich aus dem Java-Kontext in nur drei Zeilen programmieren. Jeder beliebige andere XML-RPC-Dienst lässt sich über den etwas generischeren Client mit 6 Aufrufen realisieren. Beide Möglichkeiten möchte ich folgend erläutern.

Erzeugen eines WIMS-Clients

WIMSDemo.java erzeugt einen AvatarKey und versendet eine WIMS, nachdem ein WIMSClient erzeugt wurde

import de.avameo.wims.WIMSClient;
import de.avameo.common.Key;

public class WIMSDemo
{
  public static void main(String argv[])
  {
     WIMSClient client = WIMSClient.getInstance();
       try
       {
          Key avatarKey = 
          new Key("b3e9197e-9dc5-45ee-9029-d45de3742944");
          client.sendWIMS(avatarKey, "DemoNachricht");
       }
       catch(Exception e)
      {
         e.printStackTrace();
      }
    }
}

WIMSDemo.java

Einfach oder? Mit nur drei Zeilen Java-Code. Die etwas allgemeinere Methode sieht wie folgt aus:

Erzeugen eines WIMS-Clients

RPCDemo.java erzeugt einen AvatarKey, an den die WIMS geschickt wird. Außerdem erzeugt die Klasse einen Key fuer den Channel, unter dem unser WIMS-Service erreichbar ist. Anschließend wird ein RPC-Client über die RPCClientFactory erzeugt und der Integer-Wert sowie der String-Wert gesetzt, die an den RPC-Channel übertragen werden.

import de.avameo.wims.WIMSClient;
import de.avameo.common.Key;

import de.avameo.rpc.client.RPCClientFactory;
import de.avameo.rpc.client.RPCClient;
import de.avameo.common.Key;
import java.util.HashMap;

public class RPCDemo
{
 public static void main(String argv[])
 {
    Key channelKey = null;
    Key avatarKey  = null;
    RPCClientFactory factory = RPCClientFactory.getInstance();

    try
    {
      // UUID SLTalk & Partner WIMSServer
      channelKey = 
      new Key("f3637e68-759b-8819-5df9-94a889dc69ff"); 


      // UUID Patrick Wunderland
      avatarKey  = 
      new Key("b3e9197e-9dc5-45ee-9029-d45de3742944"); 
    }
    catch(Exception e)
    {
      e.printStackTrace();
    }

    RPCClient client = factory.createClient(channelKey);

    client.setIntVal(0);
    client.setStringValue(
    avatarKey.getUUIDString()+"Dies ist eine TestNachricht ");
    HashMap result = client.executeRPCCall();
    System.out.println("Result="+result);
    }
}

RPCDemo.java

Voilá, das war`s Mal wieder vom TechTalk. Euer Patrick Wunderland auf www.avameo.de Achja, bevor ich es vergesse! Hier die Downloads:

Datei	Beschreibung
WIMSDemo.java	Ist eine Demo für einen WIMS-Java-Client und ruft unseren WIMS-Service auf Kybernethik 1 auf.
RPCDemo.java	Ist die etwas mehr generischere Version und ermöglicht es jeglichen XML-RPC-Server in Second Life® aufzurufen.
avameo.jar	Enthält die notwendigen XML-RPC-Klassen der Apache Foundation sowie die nachfolgenden Wrapper-Klassen von SLTalk & Partner

Die Sache mit dem CLASSPATH muss ich Euch ja nicht erklären Wenn ihr wissen wollt, wie man einen InWorld-XML-RPC-Server in SL mit LSL implementiert, dann empfehle ich Euch meinen TechTalk#4.