jul is a nolife - Second Life

Service web rails pour Second Life (2/2)

jul — Mon, 28 Jan 2008 16:40:00 +0100

Pour continuer sur les traces du précédent article, intéressons nous à nouveau à Second Life et Ruby on Rails. Dans cet article, nous allons voir comment communiquer depuis un objet dans le jeu vers un site Rails. Plus simplement, nous n'allons cette fois pas utiliser le système de webservice de rails, mais uniquement les arguments d'url. Ce service minuscule aura juste pour but de convertir tous les caractères en majuscule.

Cette fois nous commençons donc par la partie LSL :


string texte="Hello World";
string texte_majuscule;

default
{
  state_entry()
    {
    
     string resultat;
     llHTTPRequest("http://monserveur.fr/second_life/majuscule", [HTTP_METHOD, "PUT",HTTP_MIMETYPE,"application/x-www-form-urlencoded"], "texte="+(string)texte);

    }

  http_response(key request_id, integer status, list metadata, string body) {
    texte_majuscule=body;
  }

}

Le résultat est récupéré dans la fonction http_response.

La partie rails est bien plus simple encore :

class SecondLifeController < ApplicationController
 def majuscule
   render :text=>params[:texte].upcase
 end
end

Bien sur il ne s'agit que d'un exemple, je suis sur que vous aurez de bien meilleurs idées que moi!

Second Life web service with rails (1/2)

jul — Wed, 11 Jul 2007 20:27:00 +0200

In this first part, we will see how to communicate with an in-world object from a ruby on rails application thanks to XML-RPC. At the beginning, we define a second life structure (app/models/second_life_struct.rb) which represent the API format of second life :


class SecondLifeStruct < ActionWebService::Struct
  member "Channel", :string
  member "StringValue", :string
  member "IntValue", :int
end

Next, we create a new rails API (app/apis/second_life_api.rb) which use the structure :

class SecondLifeApi < ActionWebService::API::Base
  inflect_names false
  api_method "llRemoteData", :expects=>[SecondLifeStruct], :returns=>[SecondLifeStruct]
end

Before continuing, let's see the object LSL script which receive communication :


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("Communication channel: "+(string)channel);
      } 

      if(type==REMOTE_DATA_REQUEST) {
        llOwnerSay(sval);
        llRemoteDataReply(channel,message_id,"Everything is alright",0);
      }
    }
}

Communication channel is an unique key which permit to communicate back with this object from the Linden's webservice. We must copy this key for loading our rails web page (/second_life/test_object?channel=key)

We just have to define the controller now:

class SecondLifeController < ApplicationController
  web_client_api :second_life, :xmlrpc, "http://xmlrpc.secondlife.com/cgi-bin/xmlrpc.cgi", :timeout=>90

  def test_object
    canal=params[:channel]
    begin
      resultat=second_life.llRemoteData(SecondLifeStruct.new("Channel"=>canal,"StringValue"=>"Hello World!","IntValue"=>"0"))
      render :text=>resultat["StringValue"]
    rescue
     render :text=>"Object doesn't respond"
    end
  end
end

That's all! When we load the page, second life object says "Hello World!" In the next post, we will see how to communicate in the other way : from in-world object to rails application.

More informations about second life XML-RPC format here.

Service web rails pour Second Life (1/2)

jul — Wed, 13 Jun 2007 18:33:00 +0200

Dans cette première partie, nous verrons comment communiquer avec un objet in-world depuis une application ruby on rails grâce à XML-RPC. Pour commencer on définit une structure second life (app/models/second_life_struct.rb) qui représentera le format de l'api second life :

class SecondLifeStruct < ActionWebService::Struct
  member "Channel", :string
  member "StringValue", :string
  member "IntValue", :int
end

Ensuite, on créé une nouvelle api (app/apis/second_life_api.rb) qui utilise cette structure:

class SecondLifeApi < ActionWebService::API::Base
  inflect_names false
  api_method "llRemoteData", :expects=>[SecondLifeStruct], :returns=>[SecondLifeStruct]
end

Avant de continuer, intéressons nous rapidement au script LSL de l'objet qui permettra de recevoir la communication :

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 de communication : "+(string)channel);
      } 

      if(type==REMOTE_DATA_REQUEST) {
        llOwnerSay(sval);
        llRemoteDataReply(channel,message_id,"Tout va bien",0);
      }
    }
}

Le canal de communication correspond à un identifiant unique permettant de communiquer par la suite avec cet objet depuis le service web de Linden. Il faudra copier cet identifiant pour pouvoir appeler notre page dans rails (/second_life/tester_objet?canal=identifiant).

Il ne reste plus qu'à définir le controlleur :

class SecondLifeController < ApplicationController
  web_client_api :second_life, :xmlrpc, "http://xmlrpc.secondlife.com/cgi-bin/xmlrpc.cgi", :timeout=>90

  def tester_objet
    canal=params[:canal]
    begin
      resultat=second_life.llRemoteData(SecondLifeStruct.new("Channel"=>canal,"StringValue"=>"Bonjour tout le monde !","IntValue"=>"0"))
      render :text=>resultat["StringValue"]
    rescue
     render :text=>"L'objet ne répond pas"
    end
  end
end

Et voila, lorsque l'on se connecte à la page, l'objet dans second life nous dira "Bonjour tout le monde !".

Comme on vient de le voir, le système de service web de ruby on rails permet d'interfacer facilement votre application à second life. Le prochain article montrera comment faire l'opération inverse : communiquer depuis un objet second life vers une application rails.

Pour plus d'information sur le format XML-RPC de second life, voir ici.