Lightship VPS

Resumen de VPS Lightship

Con el Sistema de Posicionamiento Visual (VPS) de 8th Wall, los desarrolladores tienen ahora la capacidad de determinar la posición y orientación de un usuario con una precisión centimétrica, en cuestión de segundos. Con la plataforma 8th Wall, puede utilizar VPS en sus proyectos WebAR para crear experiencias web AR basadas en la localización que conecten el mundo real con el digital. El contenido WebAR puede anclarse a ubicaciones , permitiendo que los objetos virtuales interactúen con el espacio en el que se encuentran. Esto hace que la experiencia de realidad aumentada parezca más personal, más significativa, más real, y da a los usuarios nuevas razones para explorar el mundo que les rodea.

Gestión de Wayspots

Puede acceder al Navegador Geoespacial desde su proyecto seleccionando el icono del mapa en el menú de la izquierda (marcado como nº 1 en la imagen de abajo). En esta página encontrará una vista del mapa (nº 2) que puede utilizar para buscar Wayspots Niantic activados por VPS. Al seleccionar una ubicación activada por VPS, se mostrará la malla 3D de la ubicación (#3) para que pueda verificar que ha seleccionado la ubicación correcta y añadirla a su proyecto (#4).

Cuando añada un Wayspot activado por VPS a su proyecto, verá un Wayspot en la tabla "Wayspots del proyecto" del Navegador Geoespacial (anotado como nº 1 en la imagen de abajo). Una vez que tenga un Wayspot en la tabla "Wayspots del proyecto", puede utilizar el botón "Descargar" (nº 2) para descargar una versión GLB u OBJ (mostrado como nº 3) de la malla 3D y abrirla en aplicaciones de software 3D de terceros, como Blender, o importarla directamente a su proyecto de 8th Wall. Cuando haga referencia a Wayspots en el código de su proyecto , tendrás que copiar el campo "Nombre" (nº 4) de la tabla "Wayspots del proyecto".

Si la ubicación que le gustaría utilizar en su proyecto no está disponible como Wayspot, puede enviar ubicaciones de Wayspot a Niantic siguiendo las instrucciones de la sección Crear un nuevo Wayspot.

Crear un nuevo Wayspot

1. Seleccione una ubicación en el mapa donde quiera crear un nuevo Wayspot. (consulte Requisitos de Wayspot para saber más sobre cómo elegir una buena ubicación para crear un Wayspot).

2. Crear Wayspot: Pulse el botón "Crear Wayspot" para iniciar el proceso de creación de un nuevo Wayspot.

3. Comprobar si hay duplicados: Antes de crear un nuevo Wayspot, debee comprobar que su Wayspot no existe ya. Compare la ubicación de tu Wayspot deseado con otros que ya estén en el mapa para asegurarte de que no está creando un duplicado. Si no se trata de un Wayspot duplicado, debe marcar la casilla "Mi Wayspot no es un duplicado" y hacer clic en el botón "Siguiente" para continuar.

4. Agregar información sobre Wayspot: Los metadatos Wayspot serán visibles para los desarrolladores que utilicen el Navegador Geoespacial y podrán ser visibles para los usuarios finales. Recuerde que el equipo de Confianza y Seguridad de Niantic utiliza la información que facilite para determinar si el Wayspot cumple nuestros criterios para hacerse público . Una vez que haya añadido la siguiente información para el Wayspot que intenta crear, haga clic en el botón "Enviar":

• Título (125 caracteres)
• Descripción (250 caracteres)
• Categoría (1 o más)
• Imagen (si está disponible)

5. Su Wayspot debería añadirse inmediatamente a su pestaña de Envíos de Wayspot en el Navegador Geoespacial como "Pendiente" y con el estado "No activado". Puede seguir escaneando y activar este punto de acceso mientras se procesa su solicitud de hacer "Público" este Wayspot. Puede obtener más información sobre los tipos y estados de Wayspot en la sección Tipos de Wayspot de la documentación.

Instalación de Niantic Wayfarer

iOS

La aplicación Niantic Wayfarer requiere iOS 12 o posterior y un iPhone 8 o posterior. No es necesario un dispositivo con capacidad LiDAR.

Para instalar la aplicación Niantic Wayfarer, vaya a Testflight for Niantic Wayfarer (8th.io/wayfarer-ios) en su dispositivo iOS.

Android (Beta)

La aplicación Niantic Wayfarer requiere el paquete ARCore.

Para instalar la aplicación Niantic Wayfarer, vaya a Niantic Wayfarer (8th.io/wayfarer-android) en su dispositivo Android.

Utilizar Niantic Wayfarer

Puede añadir exploraciones a Wayspots públicos, así como crear Exploraciones privadas con la aplicación Niantic Wayfarer.

Una vez que haya instalado la aplicación, inicie sesión con sus credenciales de 8th Wall pulsando el botón Iniciar sesión con 8th Wall.

Si tiene acceso a varias áreas de trabajo, seleccione un área de trabajo pulsando el desplegable Espacio de trabajo de la octava pared en la página de perfil.

Página de acceso	Página de perfil

En la página del Mapa, seleccione un Wayspot para añadir un escaneado a un Wayspot público (1), o seleccione Escaneado para añadir un escaneado privado a su área de trabajo (2).

Realice un escaneado de la zona utilizando la [técnica de escaneado] recomendada (#técnica-de-escaneado).

Mapa de la página	Página de escaneado

Una vez completado el escaneado, seleccione público o privado y, a continuación, súbalo.

Tipo de exploración	Subir escaneado

Procesar los escaneos puede llevar entre 15 y 30 minutos. Una vez procesadas, las exploraciones aparecerán en el navegador geoespacial.

Las cuestiones relacionadas con el escaneado o el procesamiento deben dirigirse a support@lightship.dev.

Puede encontrar más información sobre cómo utilizar la aplicación Wayfarer en la documentación de Lightship.

Técnica de escaneado

Las ubicaciones activadas por VPS escaneadas no deben tener más de 10 metros de diámetro alrededor de la ubicación. Por ejemplo, una estatua típica funcionaría como un Wayspot activado por VPS. Un edificio entero, sin embargo, no lo haría. Una cara o un puerta/entrada a un edificio podría funcionar. Para empezar, le recomendamos que se limite a zonas más pequeñas (por ejemplo, un escritorio, una estatua o un mural).

Antes de escanear, sea consciente de su entorno y asegúrese de que tiene derecho a acceder al lugar que está escaneando.

1. Compruebe la zona que va a escanear y los alrededores del objeto escaneado para determinar si hay algún obstáculo y para seleccionar una ruta de escaneado. Es necesario planificar la ruta que pretende utilizar para escanear antes de iniciar el procedimiento.
2. Asegúrese de que du cámara está enfocada. Las sacudidas de la cámara pueden afectar negativamente a la reconstrucción 3D. Mantenga su teléfono lo más cerca posible a sí mismo para evitar el desenfoque. Camine alrededor del objeto que está escaneando en lugar de quedarse en un sitio y mover el teléfono.
3. Camine a un ritmo de paseo lento y natural. Muévase lenta y suavemente durante la exploración. No se recomiendan los cambios bruscos de dirección. Muévase lenta y suavemente con los pies en el suelo. Si escanea en en un entorno oscuro, es aún más importante que se muevas lenta y suavemente. Mueva el teléfono contigo mientras se mueve (piense en caminar como un cangrejo).
4. El Wayspot debe ser siempre el punto central. Para que podamos construir el mapa, es importante que se centre en el Wayspot y capte la órbita completa de 360° del mismo. Si no es seguro o no es posible obtener una cobertura de 360°, capte todo lo que puedas.
5. Varíe la distancia/ángulo (0-10 m o 0-35 pies). Para que el mapa 3D funcione bien en diferentes escenarios de , es importante que captemos el entorno que rodea al Wayspot y tengamos una variedad de escaneos diferentes. Es importante que varíe la distancia y los ángulos mientras explora la zona de paso.

Vídeo de la técnica de escaneo de Wayspot recomendada:

Cosas que debe evitar al escanear

1. Evite escanear cuando el entorno no sea seguro, por ejemplo, en medio de la carretera, o en un parque infantil con niños.
2. Evite escanear cuando el Wayspot esté demasiado lejos (>10 m o 35 pies) o sea demasiado grande para enfocarlo con su cámara .
3. Evite escanear mientras da un paseo casual o hace footing. Es importante que mantenga el Wayspot como centro de atención en todo momento.
4. Evite apuntar con el teléfono a objetos muy brillantes, como una luz fluorescente o el sol.
5. Evite no moverse o moverse demasiado rápido mientras explora. Los movimientos bruscos provocarán desplazamientos en la reconstrucción.
6. Evite escanear si su teléfono se calienta demasiado. Si la temperatura del aparato aumenta demasiado, el rendimiento del aparato se reducirá mucho, lo que afectará negativamente al escaneado.
7. Evite subir escaneos que parezcan incompletos o no representativos de lo que intenta escanear.

Escaneos privados

Los escaneos privados son una malla única, disponible solo para un espacio de trabajo, para desarrollar y probar experiencias VPS. Aunque los escaneos privados son una gran solución para desarrollar y probar experiencias VPS mientras se nomina o activa un Wayspot público, no están autorizados para su uso en proyectos publicados.

Los escaneos privados se crean utilizando la aplicación Niantic Wayfarer. Asegúrase de que ha iniciado sesión en Wayfarer utilizando las credenciales de 8th Wall y de que ha seleccionado el área de trabajo correcta en la página de perfil. El escaneado privado solo estará disponible en el área de trabajo seleccionada de 8th Wall en el momento del escaneado y de la carga. Los escaneos no se pueden mover a un área de trabajo o cuenta Lightship diferente.

En la aplicación Wayfarer, seleccione Escanear y haga un escaneado de la zona.

Los escaneos privados deben durar 60 segundos o menos; cada 60 segundos se genera una nueva malla, por lo que escanear durante 120 segundos dará como resultado 2 escaneos privados. Todos los escaneos privados son sin alinear.

Una vez procesada, puede previsualizar la malla y añadirla a su proyecto desde la pestaña Escaneos privados del navegador geoespacial.

Si su escaneado privado no se procesa, puede que tenga que volver a escanear. Póngase en contacto con support@lightship.dev para obtener más información.

Tipos de Wayspot

En el Navegador Geoespacial, verás cuatro tipos diferentes de Wayspots:

Tipo	Icono	Descripción
Público		Los Wayspots "públicos" han sido aprobados por el equipo de Confianza y Seguridad de Niantic y han cumplido los criterios exigidos de seguridad y accesibilidad pública. Estos Wayspots pueden utilizarse en proyectos publicados.
Pendiente		Los Wayspots "pendientes" están siendo revisados por el equipo de Confianza y Seguridad de Niantic para determinar si cumplen los criterios requeridos de seguridad y accesibilidad pública. Este proceso puede tardar hasta 2 días laborables. Los Wayspots pendientes pueden escanearse y activarse mientras se espera a que finalice la revisión.
Rechazado		Los Wayspots "rechazados" pueden no haber superado la revisión de Confianza y Seguridad de Niantic, ser un duplicado de un Wayspot existente o rechazado anteriormente, o no estar permitidos por Niantic por otro motivo. Estos puntos Wayspots no pueden añadirse a los proyectos.
Privado		Los Waystpots "privados" solo son accesibles a su área de trabajo escaneando la ubicación con la app Wayfarer de Niantic. Las Wayspots privados están pensadas para su uso durante el desarrollo y no pueden incluirse en un proyecto publicado.

Para preguntas o cuestiones relacionadas con la creación de zonas de paso, o con el estado de las existentes, póngase en contacto con support@lightship.dev

Estado del Wayspots

En el Navegador Geoespacial, verás cinco estados diferentes para los Wayspots:

Estado	Icono	Descripción
No activado		Los Wayspots con el estado "no activado" no han sido objeto de ninguna exploración. Deben enviarse un mínimo de 10 escaneos viables para la ubicación antes de que puedas solicitar la activación. Después de enviar un escaneado, el estado del Wayspots cambiará a "escaneando".
Escaneando		Los puntos de paso con el estado "Escaneando" han recibido al menos un escaneado de la ubicación. Deben enviarse un mínimo de 10 escaneos viables para la ubicación antes de que pueda solicitar la activación.
Procesando		Los puntos de paso con el estado "procesando" han recibido una solicitud de activación y mostrarán el estado "procesando" hasta que finalice el proceso de activación. Normalmente, una solicitud de activación se completa en 4 horas. Recibirá un correo electrónico cuando se complete el proceso.
Activo		Los Wayspots con en estado "activo" están disponibles para ser utilizados en proyectos para crear contenido WebAR utilizando VPS para Web.
Fallado		Los puntos de paso con el estado "Fallado" tuvieron un problema durante el proceso de activación. Esto puede deberse a varios factores, como la inadecuación de la ubicación para el VPS, escaneos insuficientes o datos corruptos. Desgraciadamente, esto significa que este Wayspot no puede utilizarse para crear contenido WebAR utilizando VPS. Le animamos a que encuentre un nuevo Wayspot para utilizarlo en su proyecto del 8th Wall.

Para preguntas o problemas relacionados con el escaneado, la activación o el estado de Wayspot, póngase en contacto con support@lightship.dev

Requisitos de Wayspot

Los Wayspots olo se aprobarán y se pondrán a disposición del públic si cumplen los siguientes criterios:

• Son un lugar u objeto físico, tangible e identificable de carácter permanente, o un objeto que señaliza un área.
• Sean seguros y accesibles públicamente para los peatones (en interiores o exteriores).
• Contiene información precisa en el título, la descripción y la foto.

Los Wayspots funcionan mejor en VPS, cuando además cumplen los siguientes criterios:

• Tienen un punto focal claro que se ajusta a una esfera de 10 m de diámetro.
• Tienen rasgos de aspecto definido y coherente. (Ej. Una playa de arena o un patio abarrotado con muebles móviles no funcionará bien)
• Tienen elementos mínimos que son reflectantes o transparentes.

Cantidades de Wayspots

No hay límite en el número de Wayspots que pueden asociarse a un proyecto de 8th Wall. Los Wayspot se localizan en el servidor a través del servicio VPS.

Eventos de Wayspot

8th Wall emite eventos en distintas fases del ciclo de vida del Proyecto Wayspot (por ejemplo, escaneado, encontrado, actualizado, perdido, etc.). Consulte la referencia de la API para obtener instrucciones específicas sobre el manejo de estos eventos en su aplicación web:

• Eventos AFrame
• Eventos PlayCanvas
• Eventos enviados por XrController

Calidad del Wayspot

Después de activar un Wayspot VPS, Niantic proporciona una clasificación de calidad en el navegador Geoespacial. Los detalles del Wayspot muestran Calidad Regular o Buena Calidad.

La calidad del Wayspot se refiere a la capacidad del Wayspot para localizar en cualquier momento. Los Wayspot con varios escaneos en todo tipo de iluminación suelen tener mayor calidad. Los Wayspot con un mínimo de escaneos requeridos o una mayoría de escaneos de un tipo de iluminación tienden a tener una calidad inferior.

La clasificación de calidad es un proceso automatizado y puede no reflejar el rendimiento real del Wayspot. La mejor forma de determinar la calidad es probarlo usted mismo.

Alineación de Wayspots

El aviso de no alineado puede ocurrir por varias razones y significa que no se puede garantizar la localización con la malla. Aunque la malla puede funcionar bien para la localización, la advertencia indica que la malla es experimental y debe utilizarse bajo su propia responsabilidad.

Nota: todas las exploraciones privadas están sin alinear.

Habilitación del Lightship VPS

Para activar el VPS en su proyecto WebAR, tendrá que establecer enableVPS en true.

Para los proyectos A-Frame, establezca enableVps: true en el componente xrweb en la página <a-scene>

En los proyectos que sin AFrame establezca enableVps: true en la llamada a XR8.XrController.configure() antes de arrancar el motor.

Ejemplo - AFrame

<a-scene
  coaching-overlay
  landing-page
  xrextras-loading
  xrextras-runtime-error
  ...
  xrweb="enableVps: true;">

Ejemplo - Sin AFrame

XR8.XrController.configure({enableVps: true})
// A continuación, arranque el motor de 8th Wall

PREGUNTAS FRECUENTES SOBRE VPS

¿Qué es Lightship VPS?

Lightship VPS (Sistema de Posicionamiento Visual) es un servicio en la nube que permite a las aplicaciones localizar el dispositivo de un usuario en ubicaciones del mundo real, permitiendo a los usuarios interactuar con contenidos de RA persistentes y potenciando nuevas experiencias inmersivas. El VPS determina la posición y orientación (pose) del dispositivo mediante haciendo referencia a los datos del mapa que existen en la nube de Niantic.

¿Cómo funciona el VPS?

Cuando un dispositivo hace una llamada al servicio VPS, el servicio toma una imagen de consulta del dispositivo del usuario junto con su ubicación GPS como entradas e intenta localizarlo utilizando el o los mapas que existen en esa ubicación. Si la localización tiene éxito, el servicio devuelve la posición y orientación (pose) del dispositivo correspondiente con la marca de tiempo de la imagen que se transmitió. Como hay un retardo entre el momento en que se captura una imagen de consulta VPS y el momento en que se recibe una respuesta del servicio VPS, el dispositivo necesita disponer de un sistema de seguimiento del movimiento para mantenerse localizado con precisión mientras se mueve. Cuando el servicio VPS devuelve una estimación de pose al dispositivo, la diferencia de pose del sistema de seguimiento del dispositivo se añade a la respuesta de localización para que VPS pueda "seguir el ritmo" de cómo se movió el dispositivo durante la solicitud.

¿Qué es un escaneo?

Los escaneos de RA de jugadores, desarrolladores y topógrafos son el ingrediente fundamental que Niantic utiliza para construir su mapa de Ra del mundo. Los escaneos de RA se registran y cargan utilizando el marco escaneo RA de Niantic, que es un módulo utilizado en Pokemon Go, Ingress y la aplicación Wayfarer, y que ahora los desarrolladores pueden integrar con ARDK 2.5. Cada escanep de RA consiste en una serie de fotogramas de vídeo con datos de apoyo procedentes de acelerómetros y sensores GPS que construyen un modelo 3D del mundo a partir de múltiples imágenes 2D. Los escaneos de RA son utilizados por Niantic para construir mapas y mallas de ubicaciones del mundo real.

¿Qué es un mapa?

En lenguaje VPS, un mapa es el artefacto de datos que se utiliza para localizar su dispositivo cuando se llama a la API VPS. Un mapa puede concebirse como una función que toma una imagen como entrada y devuelve posición y orientación como salida. El mapa que corresponde a un lugar determinado se crea a partir de los escaneos de que se cargaron en ese lugar. Los mapas VPS no son legibles por humanos.

¿Qué es una malla?

En lenguaje VPS, una malla es un modelo 3D de un lugar u objeto del mundo real. Las mallas proporcionan una representación detallada de un espacio u objeto físico, y son útiles para comprender el aspecto de una ubicación y como referencia para la autoría de contenidos de RA. Las mallas también pueden ser utilizadas por algunas aplicaciones de con fines de seguimiento. Al igual que los mapas, las mallas que corresponden a un lugar determinado son creadas a partir de los escaneos que se cargaron en ese lugar. Las mallas son legibles tanto por humanos como por máquinas .

¿Dónde puedo utilizar VPS?

El VPS está disponible en más de 100.0000 lugares del mundo real, y cada día se añaden más lugares. Para que una ubicación esté disponible en VPS, debe cargarse una cantidad suficiente de datos de escaneado RA en esa ubicación y debe completarse el proceso de activación de VPS.

¿Cómo funciona la activación del VPS?

Para que una ubicación pueda optar a la activación del VPS, debe tener al menos 10 escaneados subidos que superen los controles de calidad mínimos, y la diferencia de tiempo entre el escaneado más antiguo y el más reciente en la ubicación debe ser de al menos 5 horas. Estos requisitos garantizan que los mapas y las mallas resultantes sean de suficiente calidad y capten suficiente variación como para que los usuarios puedan localizar con fiabilidad. El proceso de activación del VPS se ejecuta en la infraestructura de mapeado de RA de Niantic e implica muchos pasos complejos. Del conjunto de exploraciones elegibles en el Wayspot, un algoritmo selecciona la mayoría de las exploraciones para utilizarlas en la construcción de mapas y mallas, y el resto para validarlas y medir la calidad de la localización. El proceso de activación suele tardar unas horas en completarse.

¿Puedo encontrar mis escaneos una vez realizada la activación del VPS?

Durante el proceso de activación, los mapas y mallas creados a partir de los escaneados cargados se fusionan en para incorporar la mayor cantidad de información posible. El producto final, que es utilizado por los desarrolladores para crear contenidos y por los usuarios para localizarlos, consiste en escaneos de muchas fuentes diferentes. Los datos de los escaneos se mezclan para crear una representación más completa del lugar, por lo que no existe una relación unívoca entre los escaneos que se cargan en un lugar y los mapas y mallas que se crean una vez activado el VPS.

¿Puedo añadir más exploraciones a una ubicación que ya está activada?

En algunos casos, los desarrolladores pueden desear añadir escaneados adicionales a un lugar que ya estaba activado para mejorar la calidad y la cobertura de los mapas y las mallas del lugar. Para que un punto de acceso sea elegible para la "reactivación", debe haber tenido al menos 5 escaneos adicionales cargados desde la última vez que se activó. Es importante destacar que todavía no es posible añadir nuevas exploraciones a un mapa fusionado existente, sino que el proceso de reactivación requiere que se construya un nuevo mapa fusionado que incorpore las nuevas exploraciones en el contexto de las existentes.

¿Cómo solicito la activación del VPS de una nueva ubicación?

Una vez que una ubicación tiene suficientes escaneos cargados para cumplir los requisitos de activación del VPS (al menos 10 escaneos totales con al menos una diferencia de tiempo de 5 horas entre el escaneo más antiguo y el más reciente), los desarrolladores pueden solicitar la activación del VPS seleccionando la ubicación en la App Wayfarer o en el Navegador Geoespacial y pulsando el botón "activar". Esto añadirá la ubicación a la cola de activación. Normalmente, una solicitud de activación se completa en 4 horas. Los desarrolladores también tienen la opción de solicitar la reactivación de una ubicación existente una vez que se hayan cargado 5 escaneos adicionales.

¿Funciona el VPS de noche o con mal tiempo?

El VPS funciona mejor cuando hay buena visibilidad. Para maximizar la probabilidad de éxito de las experiencias VPS, lo mejor es subir muchos escaneos de RA que cubran una amplia gama de condiciones diferentes (por ejemplo, diferentes horas del día, diferentes condiciones meteorológicas, etc.). Si está construyendo una experiencia en un lugar en el que llueve mucho, tener algunas exploraciones de un día de lluvia es muy útil.

¿El escaneado AR y el VPS requieren teléfonos con sensores LiDAR?

El escaneado de RA y el VPS no requieren LiDAR.