Cliente XML-RPC en Mono para OpenSimulator

Una forma para realizar comunicación entre los prims internos de OpenSimulator o Second Life y el mundo externo es a través del uso de XML-RPC el cual permite enviar mensajes a un objeto dentro de una región, siempre y cuando este se haya registrado para recibir dicha comunicación.

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

Libreria XML-RPC para Mono

Actualmente algunos sistemas como OpenSimulator o Second Life utilizan servicios remotos basados en XML-RPC, por tal motivo es necesario utilizar una libreria para realizar los llamados a estos servicios, actualmente para Microsoft .NET podemos encontrar dos librerias :

• 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