GUIA DEL DESARROLLADOR

Transcripción

1 A.R.E.A. Augmented Reality Expert Assistant GUIA DEL DESARROLLADOR 0.5.0

2 Indice NOMBRE PAG. INTRODUCCIÓN 3 LICENCIA 3 CREAR UNA CUENTA 3 PANEL DE CONTROL : CREAR UN ASISTENTE PANEL DE CONTROL : CRER RESPUESTAS Y CONOCIMIENTOS 4 5 EMULADOR 6 DESCARGA 7 INSTALACIÓN 7 CONFIGURACIÓN 8 PERSONALIZACIÓN : ELEMENTOS DEL SERVIDOR PERSONALIZACIÓN : ICONO DE APLICACIÓN 9 10

3 Introducción AREA es un asistente experto que te permite ofrecer a tus clientes y audiencia información sobre tu marca, localidad, evento y mas, todo en una única aplicación para móviles. AREA te ofrece un panel de control completo en dond puede crear por completo tu asistente, una vez creado, extiendes el código, configuras tu asistente y compilas para obtener tu asistente finalizado y listo para instalar en tu dispositivo mobil. Su asistente puede ofrecer a su audiencia varios tipos de respuesta: GPS, Realidad Aumentada (GPS), PDF, sonido, url o imagen. Licencia Este proyecto está siendo desarrollado por Josué Candela Perdomo y Juan Francisco Gonzalez Ramos bajo la licencia MIT License (X11), si quiere más información sobre ella, podrá encontrar el texto de la licencia aquí. Crear una cuenta Antes de crear su asistente deberá crearse una cuenta en nuestro servidor, una vez se haya registrado, deberá confirmar su cuenta mediante el link que le enviaremos junto al de registro. Una vez haya creado y confirmado su cuenta, usted podrá entrar en su panel de control y crear su primer asistente.

4 Panel del control : Crear un asistente Use su nombre de usuario y contraseña para entrar a su panel de control, la primera pantalla que verá será su listado de asistentes, donde podrá emular, editar y borrar sus asistentes (usando los iconos). Puedes ver los conocimientos de uno de tus asistentes clickeando sobre su nombre. Lista de asistentes Una vez allí, deberás clickear el botón Crear nuevo asistente donde podrás configurar las propiedades básicas de tu asistente al igual que algunos elementos de diseño. Edición del asistente

5 Panel de control : Crear respuestas y conocimientos Ahora que ya ha creado su asistente, ya puede comenzar a insertar conocimientos de interés en su asistente, le recomendamos comenzar creando respuestas concretas como localizaciones (GPS), ficheros (PDF), links, sonidos, etc... Para posteriormente englobar estas respuestas en categorías de conocimientos que permitan encontrarlas. Por ejemplo, si organiza un evento en el que participan varias marcas que expondrán sus productos en sus stands, puede hacer que cada stand sea una respuesta tipo localización en su asistente, le convendría crear una categoría de conocimiento llamada "Stands", con los keywords "marcas, productos, stands" que contuviese todas las respuestas de todos los stands del evento. Ejemplo de conocimiento

6 Emulador Para propósitos de testeo le recomendamos hacer uso del emulador, que se encuentra disponible en su panel de control. Emulador mostrando una respuesta Mapa El emulador le permite comprobar los conocimientos y respuestas de su asistentes pero obviamente tiene algunas desventajas: Las respuestas tipo realidad aumentada no pueden ser probadas, pero puede comprobar sus puntos GPS usando la vista de Mapa. Algunas páginas web no se mostrarán correctamente en el emulador. Esto es causado porque el emulador se ejecuta en un iframe y algunos sitios no lo permiten. De todas formas, estos sitios se mostraránn correctamente en su dispositivo.

7 Descarga Una vez tenga listo el conocimiento de su asistente puede descargar el proyecto para crear el ejecutable (por ejemplo.apk para Android). Dispone de dos opciones para descargar el proyecto: Descarga directa Descargue la última versión desde: SVN Checkout Puede estar al tanto de nuestras últimas actualizacion haciendo uso del SVM, para ello, le recomendamos hacer uso del software open source TortoiseSVN. Independientemente del software SVN que utilice, puede descargar el código de la siguiente forma: svncheckoutsvn://svn.code.sf.net/p/ar-ea/code/trunkar-ea-code Instalación (Requisitos) Para compilar correctamente el proyecto deberá usar Eclipse IDE. Si quiere compilar su aplicación para dispositivos Android o emulador, deberá instalar Android SDK Tools y ADT Plugin para Eclipse Puede seguir los siguientes tutoriales para instalarlos correctamente:

8 Configuración Si ha sido capaz de ejecutar correctamente el proyecto y ver nuestro asistente por defecto, es tiempo de configurar su proyecto para cargar la información de su asistente. Localice el ID de su asistente en el panel de control, en la pantalla de edición de asistente. Assistant ID Modifique el fichero /assets/www/index.html de su proyecto, necesitará cambiar los parámetros de la función de conexión llamada AREA.init, usando su nombre de usuario y contraseña que usa para acceder a su panel de control, como tercer parámetro deberá usar el ID de su asistente. function ondeviceready() { AREA.init( userid, userpass, assistantid ); }

9 Personalización : Elementos del servidor Uno de las ventajas de AREA es que puede disponer de algunos de los elementos de diseño en la nube, the esta forma usted podrá cambiar estos elementos de diseño en su panel de control y éstos se actualizarán en todos sus clientes a la vez. Puede ver las opciones de personalización en la pantalla de edición del asistente: Assistant s customisation panel Los elementos personalizables son: Animación de espera, Formato GIF Animación de habla, Formato GIF Logo de aplicación, Formato PNG Los formatos de los ficheros deben ser respetados o pueden no mostrarse correctamente en su aplicación.

10 Personalización : Icono de aplicación Puede cambiar el icono de su aplicación reemplazando directamente las imágenes /res/drawable-* pero le recomendamos usar el Wizard que ofrece Eclipse para la creación de iconos que puede encontrar de la siguiente forma: 1. Botón derecho en el proyecto. 2. Seleccione New y después other. 3. En la sección type filter text escriba android icon set. 4. Seleccione Android Icon Set entre los resultados y pulse Next. Podrá crear completamente su set de iconos desde ahí.