A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 1 de 32

Transcripción

1 A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 1 de 32

2 Índice 1 Labhuman RA Móvil Introducción Descripción general Arquitectura general del sistema Componentes del sistema Plataformas Características/funcionalidades Interfaz Gráfica de Usuario/ Pantallas Requisitos mínimos para su correcto funcionamiento en Android Requisitos mínimos Software Requisitos mínimos hardware Dependencias externas Limitaciones / restricciones Condiciones de uso Requisitos mínimos para su correcto funcionamiento en iphone Requisitos mínimos Software Requisitos mínimos hardware Dependencias externas Limitaciones / restricciones Condiciones de uso Instalación sistema de RA Geolocalizada móvil + Image Retrieval en Android Versionado según resolución/dispositivo Pasos de instalación Verificación de la instalación Instalación iphone Incluir la aplicación en la applestore Pasos de instalación a través de la Apple Store Verificación de la instalación Instrucciones de uso Uso en exteriores Uso en interiores HISTORICO DE CAMBIOS: A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 2 de 32

3 1 Labhuman RA Móvil 1.1 Introducción Este documento tiene como objetivo dar una visión general sobre las aplicaciones desarrolladas en el marco de la línea de investigación de Interfaces Naturales, en la rama de dispositivos móviles. En concreto, se explica la funcionalidad y características de Labhuman Realidad Aumentada Geolocalizada en móviles y Labhuman Realidad Aumentada Visual Search en móviles junto con la arquitectura del sistema que se ha desplegado para dar soporte a estas aplicaciones. También se incide en los requisitos necesarios para hacer funcionar estas aplicaciones, así como los pasos de instalación y verificación de las mismas. Por último se anexan documentos técnicos tales como el modelo de base de datos utilizados o instrucciones específicas de compilación en ios. El objetivo es que cualquier persona comprenda la infraestructura montada y sea capaz de poner en marcha el software desarrollado. 1.2 Descripción general La Plataforma de Realidad Aumentada geolocalizada es un sistema de Realidad Aumentada para dispositivos móviles, en concreto para las plataformas Android e iphone, que permite sus usuarios visualizar e interactuar mediante Realidad Aumentada con puntos de interés (POIs) especificados por el cliente. Este sistema permite explorar el mundo, orientarse espacialmente mediante la cámara y GPS, y examinar el contenido extendido asociado a cada uno de los puntos de interés. La manera de interactuar y visualizar el contenido se realiza a través de la cámara en la pantalla, sobre la que se superponen los puntos de interés aumentados. El contenido aumentado se muestra al usuario en función de dónde se encuentre y hacia dónde está enfocando la cámara del dispositivo. Utilizando técnicas de geolocalización, el usuario podrá encontrar los puntos de interés en el mundo a su alrededor, seleccionarlos y acceder a toda la información asociada de ese punto, como imágenes, videos, textos o datos. Para poder acceder a toda la información de los puntos de interés, la plataforma de Realidad Aumentada móvil se conectará a una base de datos específica de la que descargará, por un lado las localizaciones y parámetros de los POIs y, por otro lado, todos los contenidos asociados a esos POIs que deberán mostrarse sobre la pantalla. Adicionalmente, el usuario tendrá a su disposición un mapa de ayuda mediante el cual podrá ver su posición GPS actual, además podrá ver la distancia a la que está de los puntos de interés y la ruta que debería seguir para llegar a ellos. Por último, cabe resaltar que todas las interacciones del usuario con la aplicación quedan registradas, de esta manera es posible saber qué puntos de interés han sido consultados o han producido más interés por parte del usuario, así como si ha consultado contenido extra y de qué tipo. De esta manera, el cliente podrá extraer información de alto valor sobre los gustos y preferencias de los usuarios de la aplicación. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 3 de 32

4 Adicionalmente, se ha incorporado la tecnología de reconocimiento de imágenes mediante visión por computador. La aplicación es capaz de reconocer imágenes de una base de datos remota, y asociar contenido extra a esos elementos reconocidos mediante visión. Esta tecnología se puede combinar en una misma aplicación junto con la RA geolocalizada o utilizarla de manera independiente. 1.3 Arquitectura general del sistema En la figura a continuación se muestra un diagrama de la arquitectura del sistema de Realidad Aumentada móvil, tanto Geolocalizada como Visual Search. La arquitectura está dividida en 6 componentes diferentes, en concreto: 1. Aplicación Labhuman RA Geolocalizada Móvil + Visual Search ios 2. Aplicación Labhuman RA Geolocalizada Móvil + Visual Search Android 3. Interfaz de Servicios Web de Contenido 4. Base de datos de contenido 5. Servicio de Reconocimiento de imágenes 6. Base de datos de patrones. Cada uno de estos componentes es necesario para el correcto funcionamiento de las aplicaciones finales instaladas en los dispositivos. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 4 de 32

5 1.4 Componentes del sistema En este apartado se comenta brevemente la funcionalidad básica de cada uno de los componentes de la arquitectura del sistema. Aplicación de RA geolocalizada + Image Retrieval iphone y Android. Las aplicaciones móviles finales que los usuarios utilizarán para posicionarse, consultar POIs y reconocer imágenes. Servicios POIs. Esta interfaz de servicios abstrae el acceso a la base de datos por parte de las aplicaciones móviles. De esta manera si la base de datos cambia no es necesario modificar cada una de las aplicaciones implantadas en los smartphones (evitando las reinstalaciones por parte de los usuarios) En el Anexo II se puede ver la especificación de las llamadas del servicio web que utilizan las aplicaciones móviles para conectarse a este servicio. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 5 de 32

6 Base de datos de contenido. Este sistema se respalda en una base de datos específica que mantiene información sobre los Puntos de interés y su contenido de manera estructurada para su correcto funcionamiento. Este contenido puede ser de tipo videos, audio, textos, galería de imágenes, posición GPS, modelos 3D y también una categoría de Extras, para toda la información que no caiga en el resto de categorías (como teléfono, número de referencia o entradas de este tipo. En el Anexo I se puede ver el modelo de datos de esta base de datos. Servicio de reconocimiento de imágenes remoto vía TCP. Servicio capaz de identificar un patrón en la imagen que le llega desde los clientes móviles. Devuelve el identificador de la imagen encontrada y su pose en el frame. Base de datos de patrones identificables. Base de datos de patrones comprimida para poder hacer una búsqueda rápida. Almacena los patrones que serán reconocibles. Esta base de datos se genera con la misma aplicación que la base de datos del proyecto RA MrMarkerless, para más referencias ver el manual de MrMarkerless. 1.5 Plataformas Como se ha comentado anteriormente, estos desarrollos se han hecho para varias plataformas, en concreto se ha desarrollado para ios y Android. Las versiones soportadas son las siguientes: ios 3.2 / 4.3 en los dispositivos iphone 3GS e iphone 4. Android 2.2 en adelante. El sistema se ha probado en los siguientes dispositivos: HTC Desire HTC Desire HD Samsung Galaxy Tab iphone 3GS iphone Características/funcionalidades Las características implementadas en el sistema de RA Geolocalizada móvil son las siguientes: Visualización modo Realidad Aumentada (elementos 2D y 3D). En la vista de realidad aumentada se pueden visualizar los elementos del entorno tanto como planos 2D con imágenes, como modelos 3D que están asociados a los Puntos de Interés. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 6 de 32

7 Visualización Guiado RA. Cuando un Punto de Interés está seleccionado podemos visualizar una pantalla que nos guía mediante una flecha hasta ese lugar. Además nos indica la distancia hasta el punto de interés. Visualización modo Mapa. La aplicación también tiene una vista de Mapa, de manera que podemos ver nuestra posición y la posición encima del mapa de los Puntos de Interés a nuestro alrededor. Interacción con puntos de interés. Todos los puntos de interés, se visualicen desde la pantalla de Realidad Aumentada o desde el Mapa son interactuables. Se pueden seleccionar y consultar, y al hacer click sobre ellos, el sistema proporciona más información. Visualización de contenidos ampliados. Cada uno de los puntos de interés tiene información asociada que está almacenada en una base de datos. Cuando un usuario quiere consultar más información sobre un POI, el sistema se descarga esta información y la muestra al usuario. Esta información puede ser de varios tipos, desde textos y descripciones, galerías de imágenes, video, y mucho más. Geoposicionamiento y tracking de usuarios. El sistema va recogiendo información de las interacciones de los usuarios con la aplicación. De esta manera es posible saber que POIs ha visitado o dónde ha ido el usuario de la aplicación. Trazado de rutas desde posición actual hasta los puntos de interés. La aplicación calcula la ruta más rápida entre la posición actual del usuario y el punto al que quiere ir. Recopilación de datos sobre la interacción del usuario con la aplicación. Cada vez que un usuario hace click en un Punto de Interés o consulta su contenido, esta interacción es recogida por el sistema para posteriormente poder analizar esa información. Las características implementadas en el sistema de RA Visual Search móvil son las siguientes: Identificación de patrones: El sistema es capaz de identificar patrones captados por la cámara del dispositivo móvil. Obtención de su posición en el frame. El sistema es capaz de saber la posición y orientación exacta de un patrón dentro de la imagen capturada por el dispositivo móvil. Búsqueda del patrón en una base de datos de imágenes. El dispositivo móvil podrá reconocer e identificar cualquier patrón dentro de una gran base de datos de imágenes. Interacción con los patrones identificados. Una vez identificado el patrón el usuario puede interactuar con el dispositivo para consulta contenido asociado a ese patrón. Consulta de contenido asociado a las imágenes. El sistema relaciona una imagen con un Punto de Interés, por lo que es posible consultar todo el contenido asociado a ese POI de la misma manera que a través del mapa o la vista de Realidad Aumentada, A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 7 de 32

8 1.7 Interfaz Gráfica de Usuario/ Pantallas Este apartado muestra el diseño de la interfaz de usuario que se ha realizado para dispositivos Android e iphone, haciendo hincapié en las distintas pantallas. Pantalla Splash Es panta muestra la conectividad del dispositivo tanto con la conexión a internet como el GPS, una vez se tiene conectividad se pasa la pantalla informativa. Pantalla Splash Pantalla informativa En esta pantalla se selecciona el modo de vista de los puntos de interés, se puede seleccionar el mapa o la vista de realidad aumentada. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 8 de 32

9 Pantalla Informativa Pantalla mapa Esta pantalla muestra los puntos de interés marcados como pins, los cuales al ser seleccionados muestra información sobre el POI. Esta vista tiene en la parte superior derecha, una brújula que indica la orientación del usuario. También podemos ver en la parte inferior de la pantalla en azul un botón que abre una tabla con todos los puntos de interés, los cuales son seleccionables. En la parte inferior izquierda se puede observar información sobre la conectividad y el margen de error de la localización del usuario. Además en la parte inferior derecha hay un botón que dará paso a la configuración. Finalmente, una vez seleccionado un punto de interés al presionar un pin, existen dos botones, el de la izquierda modelando unas huellas sirve para calcular la ruta entre la posición actual del usuario y el punto de interés seleccionado. El botón de la derecha indica con una i sirve para abrir la ventana de información extra. También se puede consultar el contenido del POI pulsando sobre la imagen. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 9 de 32

10 Pantalla Mapa Vista de Realidad Aumentada En la vista de RA podemos observar los POIs geolocalizados representados por un objeto 2D o 3D característico e identificativo para cada uno de ellos. Al pulsar en uno, se reconoce cuál es, de modo que tras una segunda pulsación sobre el mismo se accederá a la información ampliada de dicho POI. Del mismo modo, desde la lista desplegable de POIs que se observa en la parte inferior de la pantalla también se puede acceder a la información ampliada ya mencionada. Además de las funcionalidades anteriores, existe un radar en la parte superior de la pantalla, que indica la localización de los puntos alrededor del usuario. Por último, en la parte inferior izquierda se observa el botón de configuración, además de dos iconos que representan si la conexión de datos y el GPS se encuentran activados, así como el error de precisión en cada momento. También existe la posibilidad de hacer un reconocimiento de imagen a través del botón de Visual Search. Al apretar este botón una imagen es enviada al servidor de reconocimiento de A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 10 de 32

11 imágenes y si el resultado es satisfactorio se consulta ese Punto de Interés identificado mediante visión. Pantalla Realidad Aumentada Información ampliada Como en el caso anterior, una vez seleccionado un POI en la vista de RA, es decir, tras haber pulsado una vez sobre él, existe la posibilidad de acceder a información ampliada sobre el mismo realizando una segunda pulsación. También, como ya se ha visto, desde la lista desplegable es posible acceder a la misma información ampliada que si se pulsa sobre el objeto. Por otra parte desde la vista de mapa también se puede acceder a la información ampliada seleccionando un punto de interés. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 11 de 32

12 Pantalla de Contenido Guiado en la vista de RA Partiendo de la funcionalidad explicada en la imagen anterior, una vez seleccionado un POI podremos llegar a él a través del guiado que provee la aplicación. Para ello, tan sólo sería necesario inclinar el dispositivo para que apareciese el indicador de dirección que se observa en esta imagen. La distancia restante hasta el POI seleccionado será visible en todo momento. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 12 de 32

13 Configuración Pantalla de Guiado Realidad Aumentada En la pantalla de configuración se puede indicar el radio máximo del que se obtendrán los puntos de interés, el máximo número de POIs a cargar y se puede visualizar el log de interacción del usuario. Pantalla de Configuración A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 13 de 32

14 A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 14 de 32

15 2 Requisitos mínimos para su correcto funcionamiento en Android En este apartado se explica cuáles son los requisitos mínimos, tanto hardware como software, necesarios para el correcto funcionamiento del sistema en Android. También se detallan las dependencias de código de terceros y las limitaciones y condiciones de uso del sistema. 2.1 Requisitos mínimos Software Los requisitos mínimos de software para el correcto funcionamiento de la aplicación son, básicamente, los relacionados con el SO. En este caso, la aplicación ha sido desarrollada para la versión Android 2.2, con lo que no es posible instalarla en dispositivos con una versión anterior. A partir de Android 2.2 la compatibilidad está asegurada, de modo que no deben existir problemas de funcionamiento. Aun así, no es raro encontrar algunos fallos debido a las modificaciones que hacen los fabricantes de los dispositivos para adaptar el SO a su hardware. 2.2 Requisitos mínimos hardware Como ya se ha comentado en el caso de los requisitos de software, los fabricantes adaptan y realizan ligeras modificaciones del SO para adaptarlo a sus dispositivos. Por tanto, la aplicación puede tener fallos inesperados en función del fabricante, si bien por el momento no se han detectado. El sistema de RA geolocalizada móvil e Image Retrieval han sido testeados en smartphones HTC y en tablets Samsung. 2.3 Dependencias externas En ocasiones, para implementar ciertas funcionalidades a las aplicaciones se recurre a librerías desarrolladas por terceros y puestas a disposición de los desarrolladores en internet. Esto se hace con la finalidad de simplificar la labor del desarrollador para realizar ciertas funciones, de modo que no tenga que programar a bajo nivel. En el caso de Android, Google ya dispone de muchas librerías desarrolladas, en la mayoría de los casos para acceder a otros servicios de internet que ellos mismos proveen, como YouTube, Flickr, Google Maps... En nuestro caso, siguiendo con las ya mencionadas librerías de Google, hemos hecho uso de la librería de Google Maps para la vista de mapa del sistema de RA geolocalizada, que nos permite cargar mapas y situar puntos sobre él, entre otras pequeñas funcionalidades, así como calcular rutas en formato KML. Por otro lado, para la vista de realidad aumentada se hace uso de JPCT-AE, que nos permite superponer elementos 2D/3D sobre la imagen que provee la cámara del dispositivo, de modo A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 15 de 32

16 que se combinan las imágenes del entorno con elementos virtuales que proporcionan información extra al usuario. Además de ello permite la interacción con dichos elementos en pantalla, pudiéndose pulsar sobre ellos y permitiendo la identificación interna de los mismos, para posteriormente realizar la función que se indique. En nuestro caso, la primera pulsación nos indica el objeto pulsado, y una segunda pulsación sobre el mismo objeto nos redirige a una pantalla con información ampliada. Por último, para que los POIs mostrados tanto en la vista de mapa como en la de realidad aumentada se carguen de forma dinámica, en función de la localización del usuario (característica principal de los sistemas geolocalizados), es necesaria la comunicación con el servidor de contenido. Para ello se ha utilizado la librería KSOAP 2, que permite la conexión con los distintos web services, de modo que el dispositivo Android reciba en formato JSON la información requerida sobre los POIs cercanos. Image Retrieval tiene como dependencia externa KSOAP 2, que como en el caso anterior tiene como objetivo la comunicación con el web service para la obtención de información sobre la imagen reconocida. También, como parte principal del funcionamiento, es imprescindible el tratamiento de imagen que realiza el servidor para su posterior reconocimiento. 2.4 Limitaciones / restricciones Podemos dividir las limitaciones que presenta el sistema desarrollado en dos partes diferenciadas: por un lado las propias de los dispositivos que afectan al funcionamiento del sistema en cuestión y por otra las restricciones que plantean las librerías de terceros que se han utilizado. En cuanto a las limitaciones de los dispositivos, nos centramos únicamente en las que de un modo u otro afectan al funcionamiento de nuestro sistema. Estas son, básicamente, la precisión del GPS y la velocidad de la conexión de datos. La velocidad de la conexión de datos afecta a la descarga de los datos procedentes del servidor, que poblarán la aplicación de todo su contenido. Actualmente, dependiendo del operador y la tarifa contratada, las velocidades oscilan entre 64kbps y 7.2Mbps, dependiendo además de otros factores como el alcance de la red a la que se conecta el usuario. Por tanto, esta velocidad de descarga es un factor crítico para el buen funcionamiento de la aplicación. El otro factor dependiente del dispositivo, no menos crítico que el anterior, es el GPS. En concreto, habría que hablar más específicamente de la precisión del GPS, ya que, a grandes rasgos, será la medida de error que sufrirán los elementos geolocalizados al situarlos tanto en el mapa como en la vista de realidad aumentada. Este error se acentúa sobre todo en espacios cerrados, ya que para el buen funcionamiento del GPS es necesario que el usuario se encuentre en un lugar a cielo abierto, pudiendo variar de un caso a otro desde 5 metros de error de precisión a más de 100. Por otro lado, las librerías de terceros utilizadas son principalmente dos: KSOAP 2 para la conexión con el web service y JPCT-AE para la inclusión de un motor gráfico en la vista de RA, aunque únicamente la segunda impone restricciones en la implementación. Ha de tenerse en cuenta que JPCT-AE es una librería de uso libre puesta a disposición de los desarrolladores fundamentalmente para desarrollar juegos para Android, lo que le confiere de por sí algunas restricciones. En el caso del sistema de RA geolocalizada móvil, dicho motor ha tenido que adaptarse al caso de uso definido en este proyecto. Las limitaciones de JPCT-AE se refieren, en términos generales, a aspectos como la imposibilidad de incluir textos en los objetos 2D y 3D, el A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 16 de 32

17 formato de los modelos 3D (han de ser.3ds), el número máximo de polígonos permitido para los modelos (2000 aproximadamente) y el formato de las texturas (png o jpg). 2.5 Condiciones de uso En base a las limitaciones del dispositivo explicadas en el apartado anterior, las condiciones de uso óptimas serían aquellas que consiguieran que el sistema de RA geolocalizada fuera lo más rápido y preciso posible. Para ello, como ya ha quedado patente, sería deseable que la conexión de datos fuera lo más rápida posible, siendo la conexión a una red Wifi la mejor opción, aunque no siempre sea posible. Además, para el correcto funcionamiento del GPS, la aplicación debe usarse preferiblemente a nivel de calle. Del mismo modo, Image Retrieval también se ve perjudicado si la conexión de datos es lenta, puesto que ha de producirse el envío del buffer de la imagen tomada para el reconocimiento de un objeto, además de recibir, a posteriori, la información asociada a dicho objeto (únicamente si es reconocido). A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 17 de 32

18 3 Requisitos mínimos para su correcto funcionamiento en iphone En este apartado se explica cuáles son los requisitos mínimos, tanto hardware como software, necesarios para el correcto funcionamiento del sistema en iphone. También se detallan las dependencias de código de terceros y las limitaciones y condiciones de uso del sistema. 3.1 Requisitos mínimos Software Actualmente funciona para la versión 3.2 con algunos errores, así que sería recomendable instalar la última actualización de ios 4 que es la 4.3. Aun no se ha probado con ios 5 pero se supone que por compatibilidad hacia delante esta versión será soportada. 3.2 Requisitos mínimos hardware Se ha probado que funciona en los dispositivos 3GS y 4, se desconoce si funcionara con el 4 S, aunque se supone que la compatibilidad adelante está garantizada por Apple y funcionará correctamente en el 4S, sin embargo en versiones anteriores al 3 GS no puede funcionar ya que los dispositivos no cuentan con magnetómetro y la aplicación pierde el sentido ya que habría que descarta la vista de realidad aumentada y la brújula del mapa. 3.3 Dependencias externas Oolong Engine: Es un motor 3D escrito con C++ con alguna ayuda de Objective C para la plataforma ios. Este motor es de libre de utilización y modificación que actualmente está prácticamente descontinuado y no da soporte. La web del proyecto es WaveFront OBJ File Loader Class: Es un cargador de modelos 3D desde Blender en formato.obj, que se ha complementado con el motor3d para poder cargar modelos. Tiene una licencia del MIT por lo tanto es de libre utilización. La web del proyecto es Grayscale conversión: Es una algoritmo de conversión en escala de grises proporcionado por un programador escrito en NEON-ARM. La web del proyecto es A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 18 de 32

19 3.4 Limitaciones / restricciones Modelos de no más de 450 polígonos: Modelos.obj creados con Bender La textura debe estar girada 90 grados a la derecha. Parámetros óptimos al generar un.obj con Blender: A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 19 de 32

20 3.5 Condiciones de uso Proteger del sol la cámara cuando se utilice la visión de RA. Utilizar en sitios donde la brújula no se vea afectada por campos magnéticos. Utilizar con una conexión Wifi o 3G buena. El GPS y o la geolocalización por Wifi son las dos formas de geolocalización con menos margen de error, la geolocalizacion con 3G suele proporcional márgenes de errores muy grandes, por lo que se recomienda no utilizar o confiar en la aplicación en interiores con solo el 3G conectado, el margen de error puede ser muy grande ya que no se tiene acceso al GPS o a la geolocalización por Wifi. Los interiores dan problemas con el magnetómetro y la conexión 3G, además de que la localización por GPS no suele funcionar. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 20 de 32

21 4 Instalación sistema de RA Geolocalizada móvil + Image Retrieval en Android 4.1 Versionado según resolución/dispositivo La gran variedad de dispositivos que hacen uso del SO Android, de muy diversos fabricantes, provoca que la uniformidad en los desarrollos no siempre sea posible. Desde el punto de vista de la versión de Android, es importante señalar que no existe compatibilidad para las aplicaciones desarrolladas para una versión determinada si la versión del SO es anterior. Sin embargo, como se comentaba en el apartado de requisitos de software, el sistema de realidad aumentada geolocalizada móvil e image retrieval están desarrollados para Android 2.2, por lo que la gran mayoría de los dispositivos actuales podrían hacer uso de ellas. Aparte de eso, tampoco existe uniformidad en las resoluciones de pantalla que cada móvil o tablet con Android incorpora. Por tanto, resulta necesario realizar una adaptación, básicamente de la interfaz gráfica. En nuestro caso, el desarrollo inicial se produjo para una resolución de 800x480, adaptándola posteriormente a los 1024x600 de un tablet. 4.2 Pasos de instalación Existen dos modos de instalación de aplicaciones en dispositivos Android. Google provee una de ellas para todos aquellos desarrolladores que pagan una pequeña cuota, si bien existen alternativas del mismo tipo en las que a priori no ha de pagarse nada, aunque suelen ser menos conocidas. Se trata de Android Market, una tienda online en la que se encuentran disponibles multitud de aplicaciones, tanto gratuitas como de pago. Para instalarlas desde esta plataforma, tan sólo es necesario acceder a ella y pulsar en el botón de instalar. Si no hay ningún problema, la descarga e instalación es automática. La otra posibilidad es que el desarrollador cree, a partir del proyecto de Eclipse, el archivo.apk. Este archivo.apk es el ejecutable, de modo que simplemente con que el usuario disponga de él en la memoria de su teléfono/tablet y lo ejecute se instalará. 4.3 Verificación de la instalación Para verificar que la instalación ha sido correcta, se deben seguir los siguientes pasos: A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 21 de 32

22 1. En primer lugar, entrar al menú de aplicaciones del dispositivo y buscar Cloud Destination/Image Retrieval. 2. Al pulsar sobre cada una de ellas deben iniciarse sin problemas, entrando en el caso de Cloud Destination a una pantalla de selección (Mapa/AR) y en Image Retrieval a una vista en la que se observa lo que la cámara está obteniendo. 3. Una vez hayamos realizado los pasos anteriores, deberemos comprobar: a. En el caso de Image Retrieval, realizar una fotografía de un objeto identificable por el sistema, tras lo cual devolverá información asociada a él. Si no lo reconociese devolvería un mensaje temporal en pantalla en el que se indicaría este hecho, que podría ser debido a no disponer de conexión. b. En Cloud Destination, el correcto funcionamiento sería aquel en el que al entrar tanto a la sección de Mapa como a la de RA, cargase los POIs para mostrarlos al usuario. De lo contrario el problema podría ser que el dispositivo no está conectado a la red, o bien que se encuentra fuera de un radio de acción del sistema en el que haya puntos geolocalizados. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 22 de 32

23 5 Instalación iphone Para instalar la aplicación en local será necesario descargar el código del SVN, con el nombre de proyecto CloudDestination. Además el proceso de instalación a través del Xcode requiere una configuración previa importante ya que Apple exige ser desarrollador oficial para poder instalar las aplicaciones en un iphone/ipad, se ha de tener en cuenta que solo existe la posibilidad de instalación utilizando el Xcode dentro del sistema operativo de Mac. Una vez descargado, para instalar el software a través de Xcode se necesita descargar el certificado de desarrollador de la página Para configurar este certificado es necesario darse de alta en la página anterior y proporcionar el número de serie del iphone/ipad en el cual se desea instalar las aplicaciones con dicho certificado. Una vez creado y descargado el certificado Xcode reconoce automáticamente el código y el iphone conectado a través de USB, probablemente nos pregunte al conectar el dispositivo si queremos utilizarlo para desarrollo, se debe responder afirmativamente. En caso de que la configuración del proyecto se perdiera, aunque en la práctica estará en el proyecto, se puede encontrar en el anexo III la configuración necesaria para la compilación correcta del proyecto. Finalmente con todo esto ya nos permitirá instalar la aplicación en el dispositivo, a través de Xcode pulsando el botón de build & run y la aplicación quedará instalada en el dispositivo. 5.1 Incluir la aplicación en la applestore Actualmente la aplicación no se encuentra disponible en la AppStore, en caso de que se decidiera incluirla en la Store se ha de seguir un proceso complejo. Se necesita una cuenta de Apple de desarrollador, hacer la petición de publicación, corregir los posibles problemas que nos indicarían desde Apple y una vez los errores fueran corregidos la aplicación sería publicada automáticamente. Para más información se puede consultar el manual que se proporciona desde Apple en Pasos de instalación a través de la Apple Store Se debe acceder a la AppStore, para acceder se necesita una cuenta de itunes. Una vez dentro de la Store buscar la aplicación por su nombre o el nombre de la compañía que lo publicar y presionar el botón instalar. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 23 de 32

24 Al abrir la aplicación por primera vez se debe permitir a la aplicación consultar la geolocalización del dispositivo. 5.3 Verificación de la instalación Debe funcionar sin ningún tipo de configuración especial, lo único necesario es haber seguido los pasos de instalación y disponer de una conexión a Internet vía wifi o 3G, además sería importante para un correcto funcionamiento de la aplicación que el GPS estuviera activado. Para verificar que la instalación ha sido correcta, se deben seguir los siguientes pasos: 1. Encender el iphone y buscar Cloud Destination/Image Retrieval. 2. Al pulsar sobre cada una de ellas deben iniciarse sin problemas, entrando en el caso de Cloud Destination a una pantalla de selección (Mapa/AR) y en Image Retrieval a una vista en la que se observa lo que la cámara está obteniendo. 3. Una vez hayamos realizado los pasos anteriores, deberemos comprobar: a. En el caso de Image Retrieval, realizar una fotografía de un objeto identificable por el sistema, tras lo cual devolverá información asociada a él. Si no lo reconociese devolvería un mensaje temporal en pantalla en el que se indicaría este hecho, que podría ser debido a no disponer de conexión. b. En Cloud Destination, el correcto funcionamiento sería aquel en el que al entrar tanto a la sección de Mapa como a la de RA, cargase los POIs para mostrarlos al usuario. De lo contrario el problema podría ser que el dispositivo no está conectado a la red, o bien que se encuentra fuera de un radio de acción del sistema en el que haya puntos geolocalizados. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 24 de 32

25 6 Instrucciones de uso 6.1 Uso en exteriores Para utilizar la aplicación la aplicación en exteriores se recomienda tener una buena conexión 3G, para poder descargar y consultar la información de los puntos de interés. Además se debe tener en cuenta que la aplicación funciona como un GPS por lo tanto depende de los satélites de navegación GPS, por lo tanto en calles estrechas la aplicación puede no acertar correctamente la localización del usuario, además la aplicación pueden afectarle los campos magnéticos, con lo que tampoco será recomendable colocarse cerca de edificios, dentro de autobuses, aunque no se ha observado ningún comportamiento extraño en estos casos. 6.2 Uso en interiores El uso de interiores es poco recomendable ya que el magnetómetro no suele funcionar muy bien debido a posibles campos magnéticos, además es recomendable estar conectado a una wifi ya que en interiores la geolocalización por GPS no funcionara y la geolocalización por 3G suele tener bastante margen de error. A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 25 de 32

26 ANEXO I A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 26 de 32

27 ANEXO II Interfaz de servicios web. GetPOIs(float lat, float lon, int maxradio, int providerid) *si providerid = 0, devolverá POIs de todos los providers existentes. Datos que devuelve: Array pois [ POI( float Latitud, float Longitud, int PoiID, string Titulo, string Direccion, string Modelo3DAndroid, string Modelo3DiPhone string Icono, string ImRepresentativa, int ProviderID, float Distancia) ] GetPOIFromID(int POIID) Datos que devuelve: (exactamente lo mismo que GetPOI pero el array solo contendrá 1 elemento) Array pois [ POI( float Latitud, float Longitud, int PoiID, string Titulo, string Direccion, string Modelo3DAndroid, string Modelo3DiPhone string Icono, string ImRepresentativa, int ProviderID, float Distancia) ] GetPOIIDFromIMID(int imid) Devuelve el ID del Punto de Interés en la base de datos a raíz del ID que retorna el servico de image retrieval. Datos que devuelve: int PoiID A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 27 de 4

28 Nombre Cliente Nombre Proyecto GetPoiContent(int PoiID) Datos que devuelve: String Descripcion String Link Array Images [ ( int ImagenID, string RutaThumbnail, string RutaOriginal)] Array Videos [ ( int VideoID, string RutaThumbnail, string RutaOrigina, string Formato )] Array Extra [ ( string Titulo, string Valor) ] GetImageInfo(int imid) Datos que devuelve: String Titulo String Sutor Date Fecha GetVideoInfo(int VideoID) Datos que devuelve: String Titulo String Autor TimeStamp Fecha TimeStamp Duracion GetProviderList() Datos que devuelve: Array providers [ (int ProviderID, string Nombre) ] A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 28 de 32

29 Nombre Cliente Nombre Proyecto GetMediaFormatList() Datos que devuelve: Array formats [ (int FormatoID, string Nombre) ] A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 29 de 32

30 Nombre Cliente Nombre Proyecto ANEXO III Este proyecto tiene unos parámetros compilación especiales, ya que hay ficheros que contiene código en ensamblador, llamadas a funciones en C/C++... que requieren un compilación y linkado especial, se procede a enumerar los diferentes parámetros no estándar que deben incluirse en el proyecto al compilar: Para poder compilar código en ensamblador: - Architectures - Optimized (armv7) - Linking -> OpenMP Linker Flags - "-fopenmp" - LLVM GCC Language -> Other C Flags "-mfpu=neon" - LLVM GCC Language -> Other C++ Flags "-mfpu=neon" Para poder compilar librería y código c/c++ - Compiler Version -> C/C++ Compiler Version LLVM GCC LLVM GCC Language -> C Language Dialect "C99 [-std=c99] Poner el certificado referente al desarrollador o empresa: - Code Signing Identity - iphone Developer... A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 30 de 32

31 Nombre Cliente Nombre Proyecto A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 31 de 32

32 Nombre Cliente Nombre Proyecto 7 HISTORICO DE CAMBIOS: Nº Descripción Fecha del Cambio Responsable del Cambio 1 Documento Inicial Paula Carrasco A5-P7-GES. Plantilla de Documento. Rev2-22/11/2010 Página 32 de 32