A.R.E.A. Augmented Reality Expert Assistant
GUIA DEL DESARROLLADOR
Indice
NOMBRE PAG.
INTRODUCCIÓN 3
LICENCIA 3
CREAR UNA CUENTA 3
PANEL DE CONTROL : CREAR UN ASISTENTE
4
PANEL DE CONTROL :
CRER RESPUESTAS Y CONOCIMIENTOS
5 EMULADOR 6 DESCARGA 7 INSTALACIÓN 7 CONFIGURACIÓN 8 PERSONALIZACIÓN :
ELEMENTOS DEL SERVIDOR
9
PERSONALIZACIÓN : ICONO DE APLICACIÓN
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
http://arexpertassistant.es
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
email de registro.
Una vez haya creado y confirmado su cuenta, usted podrá entrar en su panel de control
y crear su primer asistente.
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.
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.
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.
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 directaDescargue la última versión desde: https://sourceforge.net/projects/ar-ea/files/ 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:
svn checkout svn://svn.code.sf.net/p/ar-ea/code/trunk ar-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: http://developer.android.com/sdk/installing/index.html
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”); }
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.
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í.
