Instalación ^
La instalación puede ser un poco mas complicada de lo que lo suelen ser los tipicos programas de windows en los que solo tienes que hacer click en "siguiente y siguiente". Pero siguiendo uno a uno los pasos, no es para tanto.
En primer lugar, el programa esta desarrollado en java, por lo que para funcionar, necesita tener la maquina virtual de java. Por lo tanto tienes que tener instalado un JDK o JRE. Lo puedes descargar aquí
En segundo lugar, poniendonos ya manos a la obra con el SendNab, cogeremos el archivo rar y lo descomprimiremos donde queramos que quede instalado. Por ejemplo, en "C:\archivos de programa\SendNab" en windows.
Tras esto, empezamos a configurar la aplicacion editando el archivo de configuracion "sendNab.conf" que tiene que encontrarse obligatoriamente en el mismo directorio que el archivo "SendNab.jar".
Una vez abierto, nos situamos en la linea 2. Aquí deberia encontrarse el parametro con nombre "configuracion.miSeriaNumber".
Tienes que sustituir su valor por tu numero de serie.
A continuacion, del mismo modo en la linea 3, sustituye por tu token el valor del parametro "configuracion.miToken".
Y eso es toda la instalación. El resto ya lo considero manual de usuario.
Manual de Usuario ^
El manual de usuario abarca la configuración de las ordenes que se van a utilizar, como indicar el nabaztag destinatario, así como la creacion de los accesos directos.
Las ordenes son los bloques numerados que se suceden dentro del archivo de configuracion "sendNab.conf". Tienen una estructura definida en función del tipo de orden a pesar de que varios parametros se repiten en todos los tipos de orden.
En primer lugar, el parametro mas importante, es el numero de orden, ya que es lo que le dira al programa que orden queremos hacer. Aparece en cada bloque del así: #[numOrden]# y tambien al inicio de los nombres de los parametros del bloque.
Lo segundo que se repite son los parametros de las ordenes, que son los siguientes:
- descripcion: Es un parametro meramente descriptivo, para ayudar al usuario a identificar la orden. El programa no lo usa.
- url: En este parametro se indica la url que se va a enviar al servidor de los Nabaztag tal cual. Para ayudar al usuario, estan disponibles las constante TOKEN y SERIAL que el programa sustituye automaticamente por los valores propios del usuario configurados en las lineas 2 y 3, para aquellas ordenes que vayan diriginas al nuestro propio Nabaztag.
- accion: Este parametro indica el tipo de orden que es. En funcion de los posibles valores que detallo a continuacion, la orden
se comporta de un modo u otro.
enviarUrl ^
Este tipo de orden se usa cuando se quiere enviar la url tal cual se introduce como valor en el parametro "url". Es el tipo de orden mas simple, y la que mas funcionalidad puede dar, ya que se puede enviar cualquier tipo de orden con ella codificandola correctamente. De echo, las demas ordenes no son mas que simplificaciones de esta para dar mayores facilidades al usuario. Para componer la url no tienes mas que pasarte por la pagina oficial de la API y formarla como te explican. Sino, tambien puedes cogerla de algun generador de url o panel de control que haya echo la gente.
Ejemplo para dormir al Nabaztag
#[2]#
Ejemplo para suene la emisora de radio Smile FM
2.descripcion = Apagar
2.accion = enviarUrl
2.url = http://api.nabaztag.com/vl/FR/api.jsp?token=TOKEN&sn=SERIAL&action=13
#[4]#
4.descripcion = Smile FM
4.accion = enviarUrl
4.url = http://api.nabaztag.com/vl/FR/api_stream.jsp?token=TOKEN&sn=SERIAL&urlList=http://richard2.serverroom.us:4912enviarUrlTextoGenerado ^
Este tipo de orden se usa cuando se quiere enviar un mensaje de texto al Nabaztag. Para poder enviarlo directamente en la url haria falta codificarlo apropiadamente, pero mediante esta orden, el programa se encarga de ello. Mediante esta orden, no hay mas que poner en el parametro texto la frase que se quiere enviar, y el programa te lo codifica y envia automaticamente.
#[12]#
12.descripcion = envio de un texto
12.accion = enviarUrlTextoGenerado
12.texto = esto es el texto a enviardarHora ^
Este tipo de orden se usa para que el conejo te de la hora, independientemente de la hora que sea. la hora la toma del ordenador donde se ejecuta el programa, asi que este deberia estar en hora para que el mensaje sea correcto.
#[7]#
7.descripcion = decir la hora
7.accion = darHora
7.url = http://api.nabaztag.com/vl/FR/api.jsp?token=TOKEN&sn=SERIAL&tts=#&ttlive=5darHoraFecha ^
Este tipo de orden se usa para que el conejo te de la hora y fecha actual, los datos los toma del ordenador donde se ejecuta el programa, asi que este deberia estar en hora para que el mensaje sea correcto.
#[8]#
8.descripcion = decir la hora y la fecha
8.accion = darHoraFecha
8.url = http://api.nabaztag.com/vl/FR/api.jsp?token=TOKEN&sn=SERIAL&tts=#&ttlive=5buzon ^
Este tipo de orden consulta los mensajes que tienes sin archivar y te hace que el nabaztag te diga un pequeño informe.
#[9]#
9.descripcion = como esta el buzon
9.accion = buzon
9.url = http://api.nabaztag.com/vl/FR/api.jsp?token=TOKEN&sn=SERIAL&tts=#&ttlive=5moverOrejas ^
Este tipo de orden consulta la posicion de las orejas de tu Nabaztag y situa las orejas de todos los destinatarios que indiques en la misma posicion. Es como el servicio de la web en el que vinculas dos conejos, solo que en este caso, puedes vincular el numero nabaztags que quieras.
#[3]#
3.descripcion = situar las orejas de tus amigos como las tuyas
3.accion = moverOrejas
3.url = http://api.nabaztag.com/vl/FR/api.jsp?token=TOKEN&sn=SERIAL&posleft=#&posright=#
3.destinatario.1.nombre = conejo 1
3.destinatario.1.sn = 111111111111111
3.destinatario.1.token = 111111111111111
3.destinatario.2.nombre = conejo 2
3.destinatario.2.sn = 222222222222222
3.destinatario.2.token = 2222222222222
3.destinatario.3.nombre = conejo n
3.destinatario.3.sn = nnnnnnnnnnnnnnn
3.destinatario.3.token = nnnnnnnnnnnnnnnnnn
- Destinatarios ^
Hasta donde se ha explicado hasta ahora, solo se puede enviar la orden a un solo nabaztag, que generalmente es el propio. Bueno, expecto en la orden de "moverOrejas" que lo he adelantado un poco porque sino la orden en sí no tiene sentido. Pues bien, el programa tambien tiene la opción de enviar cualquiera de las ordenes que hemos visto a el numero de nabaztags que quieras a la vez.
Para conseguir esto, no hay mas que añadir a cualquiera de las ordenes la lista con los datos de los nabaztag destinatarios a los que deseamos que llegue la orden. La lista seria del siguiente modo:
numeroDeOrden.destinatario.numeroDestinatario.nombre = nombreNabaztagDestinatario
numeroDeOrden.destinatario.numeroDestinatario.sn = numeroDeSerieNabaztagDestinatario
numeroDeOrden.destinatario.numeroDestinatario.token = TokenNabaztagDestinatario
Este bloque se repetiria tantas veces como destinatarios se quiera indicar. Cuando el programa realice la orden, esta se enviara secuencialmente a todos los destinatarios de la lista.
Ejemplo en el que se envia un texto de prueba a una serie de destinatarios
#[12]#
12.descripcion = envio de un texto
12.accion = enviarUrlTextoGenerado
12.texto = esto es el texto a enviar
12.destinatario.1.nombre = conejo 1
12.destinatario.1.sn = 111111111111111
12.destinatario.1.token = 111111111111111
12.destinatario.2.nombre = conejo 2
12.destinatario.2.sn = 222222222222222
12.destinatario.2.token = 2222222222222
12.destinatario.3.nombre = conejo 3
12.destinatario.3.sn = 33333333333333
12.destinatario.3.token = 3333333333333333333En este otro ejemplo, sin embargo, lo que se envia es la fecha y hora
#[8]#
8.descripcion = decir la hora y la fecha
8.accion = darHoraFecha
8.url = http://api.nabaztag.com/vl/FR/api.jsp?token=TOKEN&sn=SERIAL&tts=#&ttlive=5
8.destinatario.1.nombre = conejo 1
8.destinatario.1.sn = 11111111111111
8.destinatario.1.token = 111111111111111
8.destinatario.2.nombre = conejo 2
8.destinatario.2.sn = 2222222222222
8.destinatario.2.token = 2222222222222
- Como ejecutar el programa mediante accesos directos en windows ^
Despues de tanto configurar por aqui y por alla, por fín ha llegado el momento de comprobar si funciona o no. El programa, originariamente fue pensado para lanzarse desde la linea de comandos, y de echo así funciona. Pero despues encontre otra manera de utilizarlo en window de manera mas amigable mediante un acceso directo, pudiendo incluso ponerle un bonito icono a cada orden.
En primer lugar empezaremos explicando como se lanza desde la la linea de comandos, ya que a pesar de ser mas tosco, puede ser interesante para ciertos casos, como para añadir una orden a un proceso bath, el programador de tareas de windows, o cualquier otro programa automatica que se os ocurra.
Bien, para ejecutar el programa solo hay que teclear lo siguiente: javaw sendNab.jar numOrden
El numero de orden es el numero que indica cual de las ordenes que sen han definido previamente en el archivo "sendNab.conf" se va a ejecutar.En segundo lugar explicaremos paso a paso como crear un acceso directo. Basicamente es lo mismo, pero replanteado para que no haya que entrar en la linea de comandos.
Para empezar situandonos en el escritorio, por ejemplo, hacemos click derecho del raton y en el menu contextual seleccionamos nuevo->acceso directo. Donde dice Escriba la ubicacion del elemento pulsamos el boton de examinar, y buscamos la instalacion de java, en concreto el archivo javaw.exe. Por ejemplo en un lugar como:
"C:\Archivos de programa\jre1.5.0_01\bin\javaw.exe"
Despues, cuando te pide un nombre para el acceso directo, ponle un nombre representativo para ti de la orden que vas a ejecutar cuando hagas click en el acceso directo.Por ultimo queda el ultimo detalle. Hacemos click derecho sobre el acceso directo recien creado, y damos a propiedades. Asegurandonos de que nos encontramos en la pestaña acceso directo rellenamos los campos del siguiente modo.
- Destino: C:\Archivos de programa\jre1.5.0_01\bin\javaw.exe -j sendNab.jar numOrden
- Iniciar en: C:\Archivos de programa\sendNab o cualquier otra ruta donde hayas instalado el programa y este el archivo sendNab.jar
Y por fín ya esta. Ya solo queda hacer doble click en el icono y ver si funciona correctamente. Si le quieres cambiar el icono, no tienes mas que darle al boton Cambiar Icono que tienes justo un poco mas abajo de los campos que acabas de rellenar.
Codigo fuente y su documentación ^
Para que cualquiera pueda ver como esta construido o incluso cambiarlo a voluntad, he incluido dentro del archivo sendNab.jar tanto el codigo fuente como su documentación
Para poder verlo no teneis mas que descomprimirlo, ya que es como un archivo zip y echarle una ojeada. Si os da pereze poneros a descomprimir el archivo, tambien puedes consultar la documentacion en esta dirección