Crear Script para Recibir Datos :

• Abrir nuestro visor favorito y entrar al servidor de OpenSimulator o SecondLife
• Crear un objeto
• Adicionar un Script
• Abrir el script
• Colocar el siguiente codigo :

  default {
     state_entry()
     {
        llOpenRemoteDataChannel();
     }
  
     remote_data(integer type, key channel, key message_id, string sender, integer ival, string sval) {
        if(type == REMOTE_DATA_CHANNEL) {
           llOwnerSay("Canal : " + (string) channel + "");
        }
        else if(type == REMOTE_DATA_REQUEST) {
           llRemoteDataReply(channel,NULL_KEY,"Exito",1221);
           llOwnerSay("Cadena : " + sval + "nNumero: " + (string) ival);
        }
        else {
           llOwnerSay("Error");
        }
     }
  }

• Guardar
• En este momento el servidor debe compilar el script y muestra en el chat :
  [11:54]  Compile successful
  [11:54]  Primitive: Canal : 61b5e9ca-9378-4254-af36-d78d6ed839de
• La cadena : 61b5e9ca-9378-4254-af36-d78d6ed839de es el identificador del canal por el cual escucha el prim, es diferente para cada prim

Enviar Datos con C# :

Se utilizara la libreria XmlRpcCS para realizar la comunicación entre la aplicación y el objeto en OpenSimulator o SecondLife.

• Abrir una consola
• Crear el directorio para el cliente
  mkdir clientxmlrpc
• Cambiar al directorio
  cd clientxmlrpc
• Copiar la libreria al directorio actual
  cp ../XmlRpcCS/XmlRpcCS.dll .
• Crear un archivo Client.cs y adicionamos el siguiente codigo :

  using System.Collections;
  using Nwc.XmlRpc;
   
  public class Client {
          public static void Main() {
                  // Informacion del Servidor de Second Life
                  // Canal por donde escucha el cliente
                  string server = "http://xmlrpc.secondlife.com/cgi-bin/xmlrpc.cgi";
                  string channel = "eafc58de-5d8a-364e-d6d8-4c4cab0129f4";
   
                  // Parametros
                  Hashtable args = new Hashtable();
                  args.Add("Channel",channel);
                  args.Add("IntValue",12345);
                  args.Add("StringValue","Hello World!"); 
   
                  // Cliente XMLRPC
                  XmlRpcRequest request = new XmlRpcRequest();
                  request.MethodName = "llRemoteData";
                  request.Params.Add(args);
   
                  // Invocacion y Resultado
                  Hashtable ret = (Hashtable) request.Invoke(server);
                  System.Console.WriteLine(ret["StringValue"]);
                  System.Console.WriteLine(ret["IntValue"]);
          }
  }

• Compilamos el codigo :
  gmcs -lib:. -r:XmlRpcCS.dll Client.cs
• Ejecutamos
  mono Client.exe
• Debe mostrar en pantalla los valores enviados por el objeto
  Exito
  1221
• Mienstras tanto en OpenSimulator debe aparecer en el chat la informacion enviada
  Hello World!!! 12345

Para usar el mismo codigo con OpenSimulator la cadena server debe tener la direccion de nuestro servidor : http://<ipServidor>:<puerto>/cgi-bin/xmlrpc.cgi

Enlaces :

• LSL XML-RPC en OpenSimulator
  http://www.marlonj.com/blog/2008/12/lsl-xml-rpc-en-opensimulator
• XML-RPC
  http://www.xmlrpc.com
• LSL XML-RPC en Second Life
  http://wiki.secondlife.com/wiki/Category:LSL_XML-RPC

• Microsoft .NET: client/server (Charles Cook)
  http://www.cookcomputing.com/xmlrpc/xmlrpc.shtml
• Microsoft .NET: client/server (Nicholas Christopher)
  http://sourceforge.net/projects/xmlrpccs

Utilizaremos la libreria XmlRpcCS, la cual es utilizada por el proyecto OpenSimulator para implementar el servicio de XMLRPC que permite realizar llamados remotos a objetos en este mundo virtual.

Requerimientos :

• Debemos instalar lo paquetes para compilar la libreria
  sudo apt-get install nant mono-2.0-devel libmono-winforms2.0-cil mono-1.0-devel

Construcción de la Libreria :

• Abrir una consola
• Descargar la ultima versión de la libreria
  http://sourceforge.net/project/platformdownload.php?group_id=123702
• Por ejemplo la versión 1.10
  wget http://ufpr.dl.sourceforge.net/sourceforge/xmlrpccs/XmlRpcCS-1.10.zip
• Descomprimir el archivo
  unzip XmlRpcCS-1.10.zip
• Cambiar al directorio de la libreria
  cd XmlRpcCS
• Compilar la libreria
  nant
• El archivo XmlRpcCS.dll es creado

Enlaces :

• XML-RPC
  http://www.xmlrpc.com

Pruebas iniciales del desempeño y ejecucion de la version 0.1 de la aplicacion MMetaverseSurface que permite controlar un avatar a traves de una superficie. En esta primera prueba se utilizo la plataforma Windows, una camara Genius Slim 1322AF, Second Life y MMetaverseSurface 0.1

Evaluacion :

• Para conectar el avatar a Second Life debe utilizarse el LoginURIy no el que se coloco en la documentacion :

  https://login.agni.lindenlab.com/cgi-bin/login.cgi

• El avatar controlado se mostro como una macha blanca, lo que indica que no termino de descargar su apariencia. Se deben hacer mas pruebas para determinar el problema.
• Al momento de mover el avatar dentro de Second Life, los edificios impiden que este se mueva libremente, se recomienda utilizar una region con pocos edificios para utilizar la superficie.
• Adicionar la posibilidad de indicar las coordenadas de una zona de la region para que el avatar se mueva sobre esta y no sobre toda la superficie. Esto permitiria crear un espacio para utilizar la superficie.
• A diferencia de OpenSimulator el avatar permanece quieto cuando el marcador esta quieto.
• No se pudo probar el giro del avatar debido a que no se descargo la apariencia del cliente.

En terminos generales funciono como debia, solo se presento el problema inesperado de la apariencia del avatar. Las recomendaciones despues de la prueba se tendran en cuenta para la version 0.2 de la aplicacion.

Enlaces :

• Pagina del Proyecto :
  http://www.marlonj.com/blog/proyectos/mmetaversesurface

Siguiendo con los desarrollos para los metaversos, llega la primera version de la superficie para mundos virtuales MMetaverseSurface que permite controlar uno a mas avatars y objetos desde una superficie interactiva en la cual se colocan marcadores que representan dichos elementos.

Esta primera version es una prueba de concepto que busca identificar los elementos necesarios para crear este tipo de aplicaciones, por ejemplo para la creacion de la superficie se utilizara la aplicacion reacTIVision que permite capturar la posicion y angulo de marcadores, los cuales representaran los objetos y avatars; esta aplicacion utiliza una camara de video con soporte de firewire o una camara USB para capturar la imagen de la superficie e identificar cada uno de los marcadores, enviando la informacion de posicion y angulo de cada uno de estos. Para la comunicacion con los mundos virtuales se utiliza LibOpenMetaverse que permite interactuar con mundos virtuales como Second Life y OpenSimulator, esta libreria esta desarrollada en C# lo que hace necesario utilizar un cliente de reacTIVision para dicha plataforma, como tambien hacer el desarrollo de la aplicacion MMetaverseSurface es esta plataforma. Adicionalmente para el desarrollo se utiliza una plataforma Ubuntu Linux con la version de codigo abierto de la plataforma .NET llamada Mono y utilizando la herramienta NAnt para automatizar la construccion del software.

Actualmente la version 0.1 de la aplicacion permite controlar uno o mas avatars a los cuales se les ha asignado un marcador y que permite utilizando el simulador o el reacTIVision controlar el avatar dentro de la region en la que se encuentra, permitiendo cambiar la posicion y angulo en el que mira el avatar. Actualmente existen algunos problemas con el movimiento que hacen que el avatar no se quede estatico en una posicion, si no que opsilar entre dos posiciones.

Para las pruebas iniciales se utilizo como servidor OpenSimulator instalado en la misma maquina que la aplicacion lo que permite tener una respuesta muy rapida de los movimientos del avatar, tambien se utilizo el simulador de reacTIVision para tener el control preciso sobre la aplicacion.

Requerimientos :

• Windows : Microsoft .NET Framework 2.0 (v2.0.50727 or later)
• Linux : mono 1.9 - http://www.mono-project.com/

Instalacion :

• Descargar el archivo con la distribucion de la aplicacion
• Descomprimir
• Editar el archivo mmetaversesurface/bin/MMetaverseSurface.exe.config y cambiar la url de autenticacion del mundo virtual.
  • Para Second Life utilice : https://login.agni.lindenlab.com
  • Para OpenSimulator utilice : http://192.168.1.4:9000 (cambiar la IP y el puerto a los de suservidor)
• Editar el archivo mmetaversesurface/bin/avatars.txt
  Modificar la linea suministrando la informacion del avatar a controlar
  Id del Marcador, Nombre, Apellido, Clave
  El id del marcador es un numero que representa el marcador a utilizar dentro de reacTIVision

Ejecutar :

• Ejecutar el TUIO Simulator o ejecutar la aplicacion reacTIVision
• Ejecutar el MMetaverseSurface.exe
• Conectarse al mundo virtual utilizando un avatar diferente al utilizado en la aplicacion
• Teletransportarse a sitio donde se encuentra el avatar a ser controlado
• Controlar el avatar utilizando los marcadores

Enlaces :

• Pagina del Proyecto :
  http://www.marlonj.com/blog/proyectos/mmetaversesurface
• Descargar la aplicacion :
  http://msketchbook.googlecode.com/files/mmetaversesurface_0.1.zip

Al principio solo dejaba al avatar cinco segundos en el mundo, pero al tratar de entrar de nuevo el servidor me sacaba diciendo que el avatar ya estaba logueado, entonces probe con 60 segundos, 30 segundos, al final me quede con 15 segundos asegurando asi que el proceso de autenticacion y loqueo se cumpla totalmente, para luego proceder a cerrar la conexion.

• Abrir una consola
• Crear el directorio para nuestro programa
  mkdir MyBot
  cd MyBot
• Copiar las dlls necesarias de la libreria libopenmetaverse compiladas anteriormente
  cp <directorio libopenmv>/trunk/bin/OpenMetaverse.dll .
  cp <directorio libopenmv>/trunk/bin/OpenMetaverseTypes.dll .
  cp <directorio libopenmv>/trunk/bin/OpenMetaverse.StructuredData.dll .
  cp <directorio libopenmv>/trunk/bin/log4net.dll .
• Crear el programa en C#
  vi MyBot.cs

  using System;
  using System.Threading;
  using OpenMetaverse; // Libreria de Acceso OpenSimulator
   
  public class MyBot
  {
          public static void Main()
          {
                  // Crear cliente
                  GridClient client = new GridClient();
   
                  // Informacion acerca del avatar y la aplicacion
                  LoginParams loginParams =
                           client.Network.DefaultLoginParams(
                                  "Juan","Perez","1234","MyBot","0.1");
   
                  // Colocamos la direccion de nuestro simulador
                  loginParams.URI = "http://192.168.1.3:9000/";
   
                  // Tratamos de entrar
                  if(client.Network.Login(loginParams))
                  {
                          // Si entramos sacamos un mensaje,
                          // esperamos 15 segundos
                          // y salimos del mundo
                          Console.WriteLine("Entrando ...");
                          Thread.Sleep(15000);
                          client.Network.Logout();
                  }
                  else
                          // Si no fue posible loguearse, mostrar error
                          Console.WriteLine(client.Network.LoginMessage);
          }
  }

• Compilar el programa :
  gmcs -lib:. -r:OpenMetaverse.dll MyBot.cs
• Ejecutar el programa :
  mono MyBot.exe

Para verificar que esto esta funcionando puede abrir el visor y entrar con un usuario a la zona inicial de la region, cuando ejecute el programa Juan Perez aparecera por unos momentos.

Preparativos :

• Abrir una terminal
• Debemos instalar el cliente de subversion para poder descargar los fuentes del repositorio
  sudo apt-get install subversion
• Debemos instalar lo paquetes para compilar la libreria
  (He instalado ya tantos paquetes de mono que la verdad no se con cuales es lo minimo)
  sudo apt-get install nant mono-2.0-devel libmono-winforms2.0-cil mono-1.0-devel

Compilar LibOpenMetaverse :

• Descargar la version actual de la libreria por medio de subversion
  svn co http://openmetaverse.org/svn/omf/libopenmetaverse/trunk/
• Ir al directorio trunk
  cd trunk
• Ejecutar un shell que prepara el proyecto y lo compila
  sh runprebuild.sh nant
• Aqui tenemos un problema, el script lanza el siguiente error :
  [: 11: ==: unexpected operator
  [: 18: ==: unexpected operator
  Parece ser que el shell no entiende los operadores ==
• Para corregir esto ejecutamos con el shell bash
  bash runprebuild.sh nant
• Los binarios de la libreria esta en el directorio bin

Instalar Compilador de C# :

• Abrir una consola
• Debemos instalar el compilador de c#,
  esto debe instalar la plataforma mono si no se ha instalado previamente :
  sudo apt-get install mono-mcs
• Voila !!!

Escribir, Compilar y Ejecutar Programa :

• Crear el archivo HolaMundo.cs
  vi HolaMundo.cs
• Escribir el siguiente programa en C# :

  using System;
   
  public class HolaMundo
  {
          public static void Main()
          {
                  Console.WriteLine("Hola Mundo");
          }
  }

• Compilar el Programa
  mcs HolaMundo.cs
• Ejecutar el Programa, nos debe salir en consola el mensaje Hola Mundo
  mono HolaMundo.exe

Instalaremos la version binaria del la libreria libsecondlife en una maquina Ubuntu 8.10, para esto necesitamos tambien instalar mono.

Instalar Mono :

• Abrir una consola y ejecutar
  sudo apt-get install mono-runtime

Instalar Libsecondlife :

• Ir a la pagina de descarga
  http://www.libsecondlife.org/wiki/Download
• Buscar la distribucion binaria, comprimida en zip y copiar el enlace
  http://www.libsecondlife.org/builds/libsecondlife-0_5_0-binary.zip
• Abrir una consola
• Crear un directorio para almacenar la libreria
  mkdir libsl
  cd libsl
• Descargar el archivo (2.7M)
  wget http://www.libsecondlife.org/builds/libsecondlife-0_5_0-binary.zip
• Descomprimir el archivo
  unzip libsecondlife-0_5_0-binary.zip

Ejecutar Cliente Consola :

• Libsecondlife cuenta con un programa que nos permite acceder al mundo virtual a traves de consola y dar indicaciones a nuestro avatar o explorar el mundo :
• mono TestClient.exe --first Juan --last Perez --pass 1234 --loginuri=http://192.168.1.3:9000/
  52 [1] INFO  - No log configuration found, defaulting to console logging
  424 [2] INFO  - <Juan Perez>: Connecting to (192.168.1.3:9000)
  606 [3] WARN  - <Juan Perez>: Received a duplicate of packet #2, current type: AvatarAppearance
  745 [4] INFO  - <Juan Perez>: Received a region handshake for OpenSim Test (192.168.1.3:9000)
  Logged in Juan Perez
  Type quit to exit.  Type help for a command list.
  1 avatars online> say Hola
  Said Hola