FreeSwitch es una solución de telefonía de software libre multiplataforma diseñada para rutear e interconectar protocolos de comunicación populares que usan audio, vídeo, texto o cualquier otra forma de medio.

Actualmente es utilizado por un sin numero de aplicaciones como el servicio proveedor de voz entre las cuales se encuentra OpenSim la version de software libre del servidor de mundos virtuales basado en SecondLife por tal motivo me di a la tarea de compilar FreeSwitch con soporte para el modulo mod_xml_curl que permite a el modulo desarrollando en OpenSim la comunicación con el mundo virtual.

Este tutorial se centra en la compilación de FreeSwitch desde el repositorio Git bajo el sistema operativo Ubuntu Server 11.1o a 32 bits instalando los paquetes necesarios para la compilación básica y habilitando el modulo para la comunicacion con OpenSim.

Pasos :

• Abrir una terminal como usuario administrador en el servidor Ubuntu
• Instalar los paquetes necesarios para la compilación del software
  Ejecutar el siguiente comando :
  sudo apt-get install git-core build-essential autoconf automake libtool libncurses5 libncurses5-dev make libjpeg-dev pkg-config unixodbc unixodbc-dev  libz-dev
• Descargar los fuentes desde el reposotorio Git oficial de FreeSwitch, ejecutar los siguientes comandos :
  cd /usr/local/src
  sudo git clone git://git.freeswitch.org/freeswitch.git
  cd freeswitch
• Realizar una comprobación del sistema y preconfiguracion :
  sudo ./bootstrap.sh
• Habilitar el modulo para la comunicación con OpenSim
  Editar el archivo modules.conf, buscar la linea #xml_int/mod_xml_curl y quitar el comentario (símbolo numeral)
  sudo vi modules.conf
• Configurar el software para su compilación (Esto puede tomar algún tiempo, 5 min)
  sudo ./configure
• Compilar el software (Esto toma mucho tiempo, unos 30 min)
  sudo make
• Si no hay errores podemos instalar el software
  sudo make install
• Una vez instalado el software esta instalado en
  /usr/local/freeswitch
• Para iniciar el servicio ejecute el comando :
  sudo /usr/local/freeswitch/bin/freeswitch
• Para detenerlo desde la consola escriba el comando
  shutdown

Configuración del modulo para integración con OpenSim :

• Detenga el servicio de FreeSwitch
• Abrir el archivo de modulos y habilitar el mod_xml_curl
  Buscar la linea <!-- <load module="mod_xml_curl"/> -->
  y quitar los comentarios : <load module="mod_xml_curl"/>
  sudo vi /usr/local/freeswitch/conf/autoload_configs/modules.conf.xml
• Copiar el archivo original de configuracion del modulo
  sudo mv /usr/local/freeswitch/conf/autoload_configs/xml_curl.conf.xml /usr/local/freeswitch/conf/autoload_configs/xml_curl.conf.xml.old
• Adicionar la nueva configuración del modulo, editar el archivo :
  (puede cambiar freeswitch con el nombre de usuario que desea y password con la clave de acceso a usar )
  (también puede cambiar localhost con la IP de la maquina que tiene el servidor de OpenSim)
  sudo vi /usr/local/freeswitch/conf/autoload_configs/xml_curl.conf.xml
  colocar el siguiente contenido :
  <configuration name="xml_curl.conf" description="cURL XML Gateway">
  <bindings>
  <binding name="directory">
  <param name="gateway-url" value="http://localhost:9000/fsapi/freeswitch-config" bindings="directory"/>
  <param name="gateway-credentials" value="freeswitch:password"/>
  <param name="disable-100-continue" value="true"/>
  </binding>
  <binding name="dialplan">
  <param name="gateway-url" value="http://localhost:9000/fsapi/freeswitch-config" bindings="dialplan"/>
  <param name="gateway-credentials" value="freeswitch:password"/>
  <param name="disable-100-continue" value="true"/>
  </binding>
  </bindings>
  </configuration>
• Abrir el archivo de configuración de conferencias y comentar todos los archivos de sonido para que estos no se reproduzcan cuando los usuarios estan conectados al mundo virtual
  sudo vi /usr/local/freeswitch/conf/autoload_configs/conference.conf.xml
  (Bajo el profile default comente todas las entradas de archivos wav)
• Ejecute el servicio de FreeSwitch para verificar que todo este correcto

Configuración del OpenSim :

• Esta configuracion ha sido probada usando OpenSim 0.7.3.1 en un servidor StandAlone
• Suponga que el OpenSim esta instalado en el directorio opensim
• Ir al directorio de ejecutables del OpenSim
  cd opensim/bin/
• Abrir el archivo de configuracion de OpenSim
  sudo vi OpenSim.ini
• Busque la configuración por defecto del FreeSwitch y cambie para que luzca así :
  [FreeSwitchVoice]
  Enabled = true
  LocalServiceModule = OpenSim.Services.FreeswitchService.dll:FreeswitchService
• Edite el archivo de configuración del servicio
  sudo vi config-include/StandaloneCommon.ini
• Busque la configuración de FreeSwitch y cambie para que luzca asi :
  (Cambie la IP 192.168.0.103 por la IP del servidor que tiene el servicio de FreeSwitch, esta debe ser una IP que los clientes puedan acceder, no debe ser localhost)
  [FreeswitchService]
  ServerAddress = 192.168.0.103
  Realm = 192.168.0.103
  SIPProxy = 192.168.0.103:5060
  DefaultTimeout = 5000
  Context = default
  UserName = freeswitch
  Password = password
  EchoServer = 192.168.0.103
  EchoPort = 50505
  AttemptSTUN = false
• Ahora puede reiniciar el OpenSim y el FreeSwitch en ese orden
  ya que FreeSwitch necesita acceder a la información de configuración generada por OpenSim

Prueba :

• Abra un visor de SecondLife, por ejemplo Imprudence
• Entre a su servidor de OpenSim y deben estar habilitados los iconos para hablar y sobre el avatar debe aparecer las ondas de sonido cuando hable

Prueba de Voz de OpenSim con FreeSwitch desde Visor Imprudence

Enlaces :

• Guía de Compilación e Instalación Oficial de FreeSwitch
  http://wiki.freeswitch.org/wiki/Installation_Guide#Compiling_and_Installation
• Guía Oficial de Integración de FreeSwitch con OpenSim
  http://opensimulator.org/wiki/Freeswitch_Module
• Imprudence Visor de SecondLife
  http://blog.kokuaviewer.org

Diva Distribution es una version especial de OpenSim (la version libre del servidor de mundos virtuales compatible con Second Life) que adiciona una interface web que permite la administración básica de un servidor desde un navegador, permitiendo acceder a información como el numero de usuarios que están actualmente en el mundo virtual, el numero de regiones, el numero total de usuarios, la cantidad de usuarios activos los últimos 30 días, como también permite el registro de nuevos usuarios, obtener información del inventario.

En este caso estaremos instalado una version completa de Diva la cual contiene el OpenSim y esta pre configurada para crear cuatro regiones por defecto, también existe una version que se puede instalar sobre un servidor de OpenSim que se tenga con anterioridad o también puede ser configurada para administrar toda una Grid de servicios basada en OpenSim.

Interface Web de Diva para OpenSim

Pasos de Instalación :

• Abrir una terminal en el servidor donde se quiere instalar y entrar como super usuario
• Instalar Mono si no se tiene instalado
  sudo apt-get install libmono-microsoft8.0-cil libmono-sqlite2.0-cil mono-gmcs libmono-system-web2.0-cil
• Instalar MySQL si no se tiene instalado
  sudo apt-get install mysql-server
  Asignar la clave de administrador
• Crear la base de datos y el usuario opensim, ejecutando los siguientes comandos :
  mysql -u root -p
  create database opensim;
  grant usage on *.* to opensim@localhost identified by 'opensim';
  grant all privileges on opensim.* to opensim@localhost ;
  \q
• Crear un usuario donde se instalara el software de OpenSim y suministrar la clave y demás datos :
  sudo adduser opensim
• Autenticarse como el usuario recién creado y suministrar la clave :
  su - opensim
• Descargar la distribucion de Diva de la pagina oficial de OpenSim
  esta en la pagina principal al lado derecho en la lista de Downloads
  http://opensimulator.org
  en nuestro caso descargaremos la version Diva distro (0.7.3). Binary, all OSs
• Ejecutar el siguiente comando para descargar dicha version
  wget https://github.com/downloads/diva/d2/diva-r18222-c.zip
• Descomprimir el archivo
  unzip diva-r18222-c.zip
• Cambiar el nombre del directorio a diva
  mv diva-r18222-c diva
• Ir al directorio de archivos binarios
  cd diva/bin
• Configurar el servidor ejecutando el comando
  mono Configure.exe
• Suministrar :
• Nombre de la base de datos : opensim
• Nombre del usuario de la base de datos : opensim
• Clave del usuario de la base de datos
• IP del servidor
• Plataforma en la que ejecutamos el servidor (2 para Linux)
• Nombre administrador de Wifi : wifi
• Apellido administrador de Wifi : admin
• Clave del administrador de Wifi
• Email del administrador de Wifi : opensim@localhost.com
• Modo de creacion de las cuentas
  o (Abierto), c (Controlado)
• Nombre del usuario en GMail para la notificacion
• Clave del usuario de GMail
• Ejecutar la primera vez el servidor de OpenSim para crear la base de datos y las regiones
  mono OpenSim.exe
• Suministrar .
• Nombre del Estado : OpenSim Estate
• Nombre del Administrador : opensim
• Clave del Administrador : admin
• Email del Administrador : opensim@localhost.com
• Asignar el estado OpenSim Estate a las cuatro regiones creadas por Diva
• Al terminar la instalacion se debe observar la consola de administracion del servidor
  Region (root) #
• Entrada al portal web, abrir la dirección en su navegador favorito :

  http://<IpServidor>:9000/wifi

• Descargue su visor de OpenSim favorito y recuerde usar la URL del servidor recién creado

Enlaces de Diva

Acceso al Inventario

Creacion de Usuario desde Web

Creación del Script de Inicio del Servidor :

• Si se quiere que el servidor se inicie de forma automática cada vez que se encienda la maquina se debe crear un script de inicio para el servicio
• Crear el archivo con el script para iniciar el servidor
  sudo vi /etc/init.d/opensim
• Copiar en el archivo los siguientes comandos
  #!/bin/bash
  cd /home/opensim/diva/bin/
  screen -d -S OpenSim.exe -m /usr/bin/mono OpenSim.exe
• Volver ejecutable el archivo
  sudo chmod +x /etc/init.d/opensim
• Habilitar el servicio para que este se inicie automaticamente cuando se ejecuta el servidor
  sudo update-rc.d opensim defaults

Acceso al Servidor desde el visor Imprudence

Enlaces :

• OpenSim
  http://www.opensimulator.org
• Pagina Oficial de Diva Canto
  https://github.com/diva

El script XyyyyzText permite visualizar texto dentro de un prim ademas de permitir la creación de un conjunto de prims como un tablero para la visualización de texto multilinea, el script que realmente son cuatro: un script para modificar la forma del objeto donde se visualizan los caracteres, para que se vean 5 caras sobre un mismo lado, un script para controlar la visualización del texto en cada objeto, un script que permite controlar un conjunto de objetos para visualizar gran cantidad de caracteres y un script de ejemplo para controlar el tablero y actualizar el texto visualizado en el tablero.

Se realizo una copia local de los scripts para mantener una versión que pueda ejecutarse en Second Life y una modificada para ejecutarlos en OpenSimulator, como tambien modificar los scripts para su uso dentro de Pulsar en los tableros de texto.

XyyyyzText en Funcionamiento

Uso de XyyyyzText en Second Life :

• Aunque existen muchos lugares donde se pueden encontrar los scripts, se realizo una copia local para controlar el posible cambio de versiones que pueda suceder, aqui esta nuestra copia :
  http://code.google.com/p/pulsarproject1/source/browse/trunk/virtualword/opensim/PulsarProjectTools/XyyyyzText
  O pueden descargarlos directamen del Wiki de SecondLife
  http://wiki.secondlife.com/wiki/XyyyyzText
• Conectarse a Second Life
• Crear la Celda :
  • Crear un Prim Cubo
  • Crear un nuevo script dentro del cubo y copiar el contenido de :
    XyyyyzText_Cell_Transform.lslp
  • Este script cambia la forma del cubo para poder visualizar las cinco caras en un solo lado
  • Copiar el script :
    XyyyyzText_Cell.lslp
    Dentro del objeto, con esto tenemos una celda que visualiza 10 caracteres
  • Copiar la celda cuantas veces se requiera,
    por ejemplo para visualizar 180 carateres se pueden crear 18 celdas, 3 filas y 6 columnas
• Crear el Control del Tablero :
  
  • Crear un nuevo prim
  • Copiar el script :
    XyyyyzText_BoardControl.lslp
  • Abra el script y vaya a la linea 15 :
    integer linelength = 80;
    Cambie 80 por la longitud de caracteres de la linea
  • Copiar el script de ejemplo que permite actualizar el contenido del tablero con solo escribir el mensaje :
    XyyyyzText_Example.lslp
  • Ahora se deden enlazar todos los elementos en un solo objeto
    Con la tecla SHIFT presionada vaya dando click en cada celda, finalmente de click en el prim del control del tablero y presiones las teclas Ctrl-L, esto enlaza todos los objetos en uno solo y permite que el control del tablero envíe las cadenas a cada celda.
• Uso :
  Simplemente escriba algo en el chat y esto aparecerá en el tablero, si se desea cambiar de linea coloque el carácter |

Uso de XyyyyzText en OpenSimulator :

• El script utiliza texturas que no se encuentran disponibles en OpenSim, por tal motivo se deben descargar de Second Life y subir a nuestro servidor de OpenSim
• Se descargo la lista de texturas utilizadas por el script utilizando una aplicación php que se esta desarrollando para la descarga y subida de texturas, se realizo una copia local en el directorio :
  http://code.google.com/p/pulsarproject1/source/browse/trunk/virtualword/opensim/PulsarProjectTools/#PulsarProjectTools/PulsarXyyyyzText/texturas
• Se subieron al servidor con otro script de php, cada imagen devuelve un nuevo UUID por lo cual se debe crear una lista de estos para modificarla en el script
• Realizar los mismos pasos que se realizaron para la construccion del tablero en SecondLife
• Modificar la lista de texturas en el script :
  XyyyyzText_Cell.lslp
• Nota :
  • Abra los scripts y haga modificaciones para que OpenSim obligue a su actualización y compilación
  • Se pueden utilizar programas de terceros para subir las texturas a OpenSim o subirlas, se debe generar la lista de UUIDs a mano
  • Las texturas estan en formato jp2 el cual es el standard utilizado en Second Life, se necesitan editores que soporten este formato para visualizar las imagenes
  • Se esta tratando de crear herramientas que permitan de una forma facil y rapida crear texturas que funcionen con este script.

Aunque actualmente se están realizando pruebas de funcionamiento de los scripts al parecer todo esta funcionando muy bien y se procederá a crear tableros basados en este script para la publicación de información tipo texto dentro del mundo virtual. Se deben hacer pruebas de migracion del script a otras regiones, pero eso lo haremos mas adelante.

En el análisis de herramientas educativas a ser utilizadas dentro de los mundos virtuales, aparece la necesidad de crear un tablero que permita visualizar cualquier texto en el, lo cual permitiría crear carteles con el numero y nombre del salón de clases, avisos de identificación de lugares, tableros de información que puedan ser actualizados fácilmente por los dueños de los mismos, como también puedan ser actualizados remotamente.

Para el desarrollo de esta herramienta nos topamos con algunos problemas que debemos solucionar de la mejor manera posible, facilitando la actualización de contenidos en dichos tableros, como tambien adicionar gran cantidad funciones que permitan utilizar los tableros de texto de forma variada.

hippoTELL - Ejemplo de Tablero Texto

Estos son algunos de los problemas que debemos enfrentar al momento de diseñar los tableros de texto :

• En el caso de Second Life :
  • No ofrece una función que permita crear escribir directamente sobre un Prim (objeto)
  • No ofrece una función que permita crear dinamicamente texturas con texto e imágenes
  • No permite el uso de texturas vía web lo que permitiría generar la textura fuera de Second Life y cargarla directamente en el tablero.
  • Por cada contenido debemos crear una imagen y subirla al simulador lo que cuesta $10 Lindens por imagen
  • Cada que necesitemos cambiar el contenido del tablero, debemos recurrir a un programa de edición como Paint, Gimp entre otras, para crear el contenido, subirlo al simulador y aplicarlo al tablero.
• En el caso de OpenSim :
  • OpenSim ofrece una función para escribir directamente en los objetos
  • No tiene costo alguno subir texturas al simulador
  • Se podrían crear programas que generen la imagen, la suban y apliquen al tablero directamente.

Entre los requisitos basicos del tablero de texto tenemos :

• Visualizar información de tipo texto
• Posibilidad de crear tableros de varios tamaños
• Actualizar fácilmente el tablero desde el mismo simulador sin incurrir en uso de herramientas externas

Entre los requisitos avanzados propuestos inicialmente tenemos :

• Posibilidad de actualizar el tablero remotamente
• Justificar el contenido dentro del tablero
• Cambiar el color del texto en el tablero
• Posibilidad de actualizar el tablero cada cierto tiempo con información descargada desde la web

Como antecedentes podemos citar :

• Scripts para la visualización de texto en Second Life :
  http://wiki.secondlife.com/wiki/XyyyyzText
• hippoTELL Web-Enabled Noticeboards
  Tablero de 180 caracteres que permite la actualización desde el simulador o desde una interface web
  Permite controlar el contenido, justificación del texto y color de cada linea
  http://www.hippo-technologies.co.uk/products/hippotell/index.php

Como se menciono en entradas anteriores, se selecciono el LSL PLus como el editor de desarrollo de los scripts para los objetos dentro de los mundos virtuales de Second Life y OpenSim, este editor es un plugin para el ambiente de desarrollo Eclipse, por tal motivo se debe contar con una versión antes de comenzar la instalación del plugin,

Requisitos :

• Tener el ambiente de desarrollo Eclispe ya instalado
  en este caso tenemos el :
  Eclipse for PHP Developers
  Version: Helios Release
  Build id: 20100617-1415
  http://eclipse.org/

LSL Plus Editor

Pasos de Instalación :

• Ir a la pagina de sitios de actualización de LSL Plus
  http://lslplus.sourceforge.net/update-site-list.html
• Seleccionar un sitio, por ejemplo

  http://lslplus.sourceforge.net/update-sites/na-east

• Ejecutar el Eclipse
• Ir al menú Help y la opción Install New Software
• En el campo Work With : escribir la URL de lslplus

  http://lslplus.sourceforge.net/update-sites/na-east

• Pulsar el botón Add
• Colocar nombre al Repositorio :
  LSL Plus
• Presionar el botón OK
  Eso carga el descriptor del repositorio
• El repositorio no tiene categorías, por este motivo debemos quitar la opción del checkbox
  Group Items by category
• Seleccionar los componentes a Instalar
  Lslplus
  Lslplus_part_linux_x86 (o el del sistema operativo actualmente usado)
• Presionar el botón Next
• Se muestran los detalles de instalación (no aparece información)
  Presionar el botón Next
• Aparece la licencia
  Seleccionar la opción "I accept the terms of the license aggrements"
• Presionar el botón Finish
• Comienza la descarga del software y los paquetes necesarios para la instalacion
• En medio de la instalación aparece una advertencia,
  presionar el botón OK
• Reiniciar el eclipse
  pulsando el boton Restart Now