Lightship VPS

Resumen de VPS Lightship

Con el Sistema de Posicionamiento Visual (VPS) de Niantic, los desarrolladores pueden crear ricas experiencias de AR de localización que superponen contenido virtual al mundo físico. Los contenidos WebAR pueden anclarse a ubicaciones del mundo real , lo que permite a los objetos virtuales interactuar con su entorno físico. Esto hace que la experiencia de la realidad aumentada de resulte más personal, significativa y envolvente, y da a los usuarios nuevas razones para explorar el mundo que les rodea.

**Nota: La localización VPS no se puede previsualizar actualmente en el simulador.

Nota: El VPS y el Navegador Geoespacial (GSB) requieren actualmente una suscripción al plan Pro. Estas funciones de no están disponibles en el plan Básico (Gratuito).

Gestión de ubicaciones

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 de mapa (#2) que puede utilizar para buscar ubicaciones activadas 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 una Ubicación activada por VPS a su proyecto, verá la Ubicación en la tabla "Ubicaciones del Proyecto " en el Navegador Geoespacial (anotada como #1 en la imagen de abajo). Una vez que tenga una Ubicación en la tabla "Ubicaciones del proyecto" puede utilizar el botón "Descargar" (#2) para descargar una versión GLB o OBJ (conmutador mostrado como #3) de la malla 3D y abrirla en aplicaciones de software 3D de terceros, como Blender, o importarla directamente a su proyecto 8th Wall. Cuando haga referencia a Ubicaciones en su código de proyecto tendrá que copiar el campo "Nombre" (#4) de la tabla "Ubicaciones del proyecto".

Si la ubicación que desea utilizar en su proyecto no está disponible como Ubicación VPS, puede crear la ubicación siguiendo las instrucciones de la sección Crear nueva ubicación.

Crear nueva ubicación

1. Click on an open spot on the map to select where you’d like to create a new VPS Location. See VPS Location Requirements to learn more about choosing a good spot to create a VPS Location.

2. Workspaces on Pro or Enterprise plans will have the option to Create Public Location or Create Private Location. Public Locations are accessible to all developers and people using their projects, while Private Locations will only be visible and accessible to your workspace and its projects. Creating a Public Location is the correct choice for most projects; Private Locations are a premium feature for developers that need to create special access-controlled or temporary VPS experiences. Click either the Create Public Location or the Create Private Location button to start the location creation process.

3. Comprobar si hay duplicados: Antes de crear una nueva Ubicación, es necesario que compruebe que su Ubicación no existe ya. Compare your desired Location to others already on the map to ensure that you are not creating a duplicate. If this is not a duplicate Location, you must check the My Location is not a duplicate box and click on the Next button to continue.

4. Add Location Information: Location metadata will be visible to developers using the Geospatial Browser and can be visible to end-users. Remember that Niantic's Trust & Safety team uses the information you provide to determine whether the Location meets our criteria to be made publicly available. Once you have added the following information for the Location you are trying to create, click on the Submit button:

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

5. Your location should immediately be added to your Location Submissions tab in the Geospatial Browser with its type ("Public" or "Private") and the status ("Not Activated"). It will be available for scanning within a few minutes and VPS activation can be requested once it's fully scanned.

Scaniverse for Niantic Developers (iOS Beta)

info

Scaniverse for Niantic Developers is available in Beta on iOS devices. Android support is coming soon.

Actualmente estamos ejecutando una versión beta de Scaniverse para desarrolladores de Niantic, que integra a la perfección el navegador geoespacial (GSB) con la galardonada experiencia de escaneado de Scaniverse. Esta dirección agiliza considerablemente los flujos de trabajo de los desarrolladores en torno a la navegación por el mapa, la adición de ubicaciones y, por supuesto, la exploración de :

• We’ve made the Geospatial Browser (GSB) mobile-friendly so that it can be effectively used within Scaniverse to browse the map, inspect locations, add locations, and request VPS activation
• Hemos sustituido el flujo de inicio de sesión de la aplicación Wayfarer por un simple código QR que vincula Scaniverse con tu cuenta de 8th Wall.
• Hemos adoptado la interfaz de usuario de Scaniverse para facilitar la creación y carga de escaneados.
• Hemos habilitado la localización de pruebas en ubicaciones activadas por VPS dentro de Scaniverse
• Hemos integrado nuestras últimas mejoras en el filtrado de mapas para que le resulte más fácil que nunca encontrar la ubicación o ubicaciones de que está buscando.

Los desarrolladores de 8th Wall con dispositivos iOS pueden probar ya la beta siguiendo las instrucciones que se indican a continuación.

Vinculación de Scaniverse con el navegador geoespacial (GSB)

Prerequisite: Install Scaniverse from the iOS App Store. Support for Android devices is coming soon.

1. Accede a tu cuenta de 8th Wall desde tu ordenador. Abra el Explorador geoespacial (GSB), seleccione cualquier ubicación en el mapa y, a continuación, seleccione Ver detalles. En la esquina inferior derecha de la tarjeta de detalles de la ubicación , pulse Generar código QR. Aparecerá un código QR.

2. Escanea el código QR con tu aplicación Cámara. Abre la aplicación Cámara de tu teléfono y apunta al código QR.

3. Pulse sobre el enlace Scaniverse que aparece. This will link Scaniverse with your 8th Wall developer account. This only needs to be done once.

   info

   Make sure to allow www.8thwall.com to use your current location when prompted; this is required for proper operation of the GSB interface.

4. Una vez que haya vinculado Scaniverse a GSB, podrá volver a la pantalla GSB en cualquier momento pulsando el botón GSB en la cinta inferior de la aplicación Scaniverse. Tenga en cuenta que puede desvincular Scaniverse de GSB en cualquier momento accediendo al menú Configuración y desactivando la opción **Modo desarrollador de Niantic **.

5. Todos los escaneos que hayas realizado fuera del Modo Desarrollador de Niantic seguirán siendo accesibles cuando vincule/desvincule Scaniverse con GSB.

Navegar por el mapa GSB en Scaniverse

1. Pulsando sobre el icono Persona podrá seleccionar su 8º Espacio de Trabajo en la Pared.

2. Si pulsa el botón cargar podrá seleccionar la ubicación de los escaneos que desea cargar. Tenga en cuenta que sólo los escaneos que se originan desde el Modo Desarrollador de Niantic (utilizando las opciones Añadir Escaneos o Escaneo de Prueba) pueden ser cargados a Niantic para propósitos de desarrollo VPS.

3. Si pulsa el botón Plus podrá crear nuevas ubicaciones y realizar exploraciones de prueba.

4. Al pulsar el botón Capas se activará la vista por satélite del mapa.

5. Al tocar el botón Reticule, el mapa se centrará en su ubicación.

6. Si pulsa el botón Brújula, el mapa volverá a su orientación por defecto, norte arriba.

7. El botón Controles le permitirá aplicar filtros a las localidades que aparecen en el mapa en función de su tamaño, categoría o estado de activación.

8. El botón Lupa le permitirá buscar en el mapa.

9. Al pulsar el botón X se cerrará el GSB y volverá a la pantalla de inicio de Scaniverse.

10. Al seleccionar una ubicación en el mapa aparecerá una pantalla de Previsualización, que puede pulsarse para obtener más detalles en .

11. Si ha seleccionado una localización activada por VPS, puede pulsar el botón Probar VPS para verificar que la localización funciona.

12. Para crear una exploración y añadirla a una ubicación concreta, pulse el botón Añadir exploraciones de la ubicación correspondiente en . Tenga en cuenta que debe estar cerca de la ubicación para que la opción Añadir exploraciones esté disponible.

Crear y cargar escaneos

1. El botón Grabar se utiliza para iniciar y detener el proceso de escaneado.

2. El botón Pausa puede utilizarse para suspender temporalmente el proceso de escaneado si se desea.

3. La pantalla Tiempo indica la duración de la exploración actual. Se requiere una duración mínima de 15 segundos para que un escaneo sea viable para su carga con fines de desarrollo VPS. Lo ideal es una exploración de 30-60 segundos (las exploraciones de más de 60 segundos se dividen en varias partes para procesarlas en ).

4. Si pulsa el botón X volverá a la pantalla de inicio de Scaniverse.

5. Cuando haya completado un escaneo, podrá inspeccionar una Malla de Revisión de la escena que capturó.

6. Si está satisfecho con su escaneado, puede cargarlo inmediatamente pulsando el botón **Cargar escaneado de **.

7. También puede elegir Descargar más tarde si desea utilizar una conexión WiFi (recomendado).

8. Si no está satisfecho con su escaneado, puede descartarlo pulsando el botón Borrar.

Instalación de Niantic Wayfarer

Para escanear nuevas ubicaciones VPS o añadir escaneos a ubicaciones previamente activadas, necesitarás instalar la aplicación Niantic Wayfarer en tu teléfono. Consulte a continuación las instrucciones de instalación y uso .

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.

Utilizar Niantic Wayfarer

Puedes añadir exploraciones a Ubicaciones públicas así como crear Exploraciones de prueba 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 Mapa, seleccione una Ubicación VPS para añadir una exploración a una Ubicación pública (1), o seleccione Exploración para añadir una exploración de prueba a su espacio 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 finalizado el escaneado, seleccione público o de prueba 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 una Ubicación activada por VPS. Un edificio entero, sin embargo, no lo haría. Una cara o un puerta/entrada a un edificio podría funcionar. We recommend sticking with smaller areas to start (e.g. a desk, statue, or 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 el área que se va a explorar y los alrededores del objeto explorado para determinar si hay algún obstáculo y para seleccionar una ruta de exploración. Es necesario planificar la ruta que pretende utilizar para la exploración 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. Mantén tu teléfono lo más cerca posible de tu costado para evitar el desenfoque. Camine alrededor del objeto que está escaneando en en lugar de quedarse parado en un lugar y mover el teléfono.

3. Camine a un ritmo de paseo lento y natural. Muévase lenta y suavemente durante la exploración. Los cambios bruscos de dirección son un no-no definitivo. Muévase lenta y suavemente con los pies en el suelo. Si escanea en en un entorno oscuro, es aún más importante moverse lenta y suavemente. Mueva el teléfono con usted mientras se mueve (piense en caminar como un cangrejo).

4. VPS La ubicación debe ser siempre el punto central. Para que podamos construir el mapa, es importante centrarse en la Localización VPS y capturar la órbita completa de 360° de la misma. Si no es seguro o no es posible obtener una cobertura de 360°, capta 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 capturemos el entorno que rodea la Localización y dispongamos de una variedad de escaneos diferentes. Es importante variar la distancia y los ángulos al explorar la Ubicación.

Vídeo de la técnica recomendada de escaneado de ubicaciones VPS:

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 la Localización esté demasiado lejos (>10m o 35ft) o sea demasiado grande para enfocarla con su cámara .

3. Evite escanear mientras da un paseo casual o hace footing. Es importante mantener la ubicación como punto central 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 de .

6. Evite escanear si su teléfono se calienta demasiado. Si la temperatura del dispositivo aumenta demasiado, el rendimiento de se reducirá considerablemente, lo que afectará negativamente a la exploración.

7. Evite subir escaneos que parezcan incompletos o poco representativos de lo que intenta escanear en .

Escaneos de prueba

Los escaneos de prueba son una malla única, disponible para un solo espacio de trabajo, para desarrollar y probar experiencias de VPS. Aunque las exploraciones de prueba son una gran solución para desarrollar y probar experiencias VPS mientras se nomina o activa una Ubicación pública, no están autorizadas para su uso en proyectos publicados de .

Los escaneos de prueba se crean con 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 escaneo de prueba solo estará disponible en el espacio de trabajo de 8th Wall seleccionado en el momento de escanear y subir. 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 de prueba deben durar 60 segundos o menos; cada 60 segundos se genera una nueva malla, por lo que el escaneo durante 120 segundos dará como resultado 2 escaneos de prueba. Todas las exploraciones de prueba son unaligned.

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

Si el escaneo de prueba no se procesa, es posible que tenga que volver a escanear. Póngase en contacto con support@lightship.dev para obtener más información.

Tipos de ubicación

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

Tipo	Icono	Descripción
Público		Las ubicaciones "públicas" han sido aprobadas por el equipo de confianza y seguridad de Niantic y han cumplido los criterios de seguridad y accesibilidad pública requeridos. Estas Ubicaciones pueden utilizarse en proyectos publicados.
Pendiente		"Pendientes" Las ubicaciones están siendo revisadas por el equipo de Confianza y Seguridad de Niantic para determinar si cumplen los criterios requeridos de seguridad y accesibilidad pública. **Las ubicaciones pendientes pueden escanearse y activarse mientras se espera a que finalice la revisión.
Rechazado		Las Ubicaciones "Rechazadas" pueden no haber superado la revisión de Confianza y Seguridad de Niantic, ser un duplicado de una Ubicación existente o previamente rechazada, o no estar permitidas por Niantic por otro motivo. Estas Ubicaciones no pueden añadirse a los proyectos.
Prueba		"Solo podrás acceder a las ubicaciones de prueba desde tu espacio de trabajo si escaneas la ubicación con la aplicación Wayfarer de Niantic. Las ubicaciones de las pruebas están pensadas para su uso durante el desarrollo y no pueden incluirse en un proyecto publicado.

Para preguntas o problemas relacionados con la creación de Ubicaciones VPS, o para comprobar el estado de las Ubicaciones existentes y ya existentes, póngase en contacto con support@lightship.dev

Ubicación Estado

En el Navegador Geoespacial, verá cinco estados diferentes para las Ubicaciones VPS:

Estado	Icono	Descripción
No activado		Las ubicaciones con el estado "No activado" no han recibido ninguna exploración. Deben enviarse un mínimo de 10 escaneos viables para la ubicación antes de que pueda solicitar la activación. Después de enviar un escaneado, el estado de la ubicación cambiará a "Escaneando".
Escaneando		Las ubicaciones con el estado "Escaneando" han recibido al menos un escaneado. Deben enviarse un mínimo de 10 escaneos viables para la ubicación antes de que pueda solicitar la activación.
Procesando		Las ubicaciones con el estado "En proceso" han recibido una solicitud de activación y mostrarán el estado "En proceso" hasta que el proceso de activación haya finalizado. Normalmente, una solicitud de activación se completa en 4 horas. Recibirá un correo electrónico cuando se complete el proceso.
Activo		Las ubicaciones con un estado "Activo" están disponibles para ser utilizadas en proyectos para crear contenido WebAR utilizando VPS para Web.
Fallado		Las ubicaciones con el estado "Fallido" han encontrado 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. Desafortunadamente esto significa que esta Ubicación no puede ser usada para crear contenido WebAR usando VPS. Le animamos a que busque una nueva ubicación para su proyecto del 8º Muro.

Si tiene preguntas o problemas relacionados con la exploración de ubicaciones, la activación o el estado, póngase en contacto con support@lightship.dev

Requisitos de localización

When choosing any location for use with VPS, please consider the following:

• VPS works best at locations that are distinct and consistent in appearance (e.g. a sandy beach or a crowded patio space with moveable furniture will not work well).
• Locations that are dominated by reflective or transparent features (e.g. windows and mirrors) are not recommended.
• The larger the experience, the more scanning you will need to do to capture the space; the maximum recommended size for a VPS experience today is 400 m^2 (20 x 20 m), though larger experiences can be supported with careful scanning.

Public Location Requirements

Public Locations are accessible to all developers and people using their projects and apps. When adding a new Public Location, please consider the following guidelines:

• Public Locations should be permanent physical, tangible, and identifiable places or objects.
• Public Locations should be safe and publicly accessible by pedestrians.
• Make sure to include accurate information in the title, description, and photo to help your users find the location.

Private Location Requirements

Private Locations are a premium feature for developers that need to create special access-controlled or temporary VPS experiences. They are only visible and accessible to the workspace that created them. When creating a new Private Location, please consider the following:

• Private Locations are only discoverable by the workspace that created them, so they can only be scanned and localized against by members and users of that workspace's projects.
• Private Locations are a good choice if you are building a special access-controlled experience (e.g. on your or your client's private property).
• Private Locations are also an option if you're building an experience in a public location that temporarily has a different appearance (e.g. a concert, museum exhibition, or other special event).

Ubicación Cantidades

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

Ubicación Eventos

8th Wall emite eventos en distintas fases del ciclo de vida de la ubicación del proyecto (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

Ubicación Calidad

Una vez que se ha activado el VPS de una ubicación, Niantic proporciona una calificación de calidad en el navegador geoespacial. Los detalles de la ubicación muestran Calidad regular o Calidad buena.

La calidad de localización se refiere a la capacidad de localización de la ubicación en cualquier momento. Las ubicaciones con varios escaneos en todo tipo de iluminación tienden a tener una mayor calidad. Las ubicaciones con un mínimo de escaneos requeridos o una mayoría de escaneos en un tipo de iluminación tienden a tener una calidad inferior.

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

Ubicación Alineación

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: Todos los escaneos de prueba están desalineados.

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

Desarrollo de experiencias VPS a medida

Las escenas VPS a medida están diseñadas para una única ubicación y utilizan una malla de referencia del navegador geoespacial para alinear el contenido de RA.

Parte 1: Añadir ubicación a la escena

1. Abra el navegador geoespacial (icono de mapa 🗺 a la izquierda)
2. Encuentre una ubicación activada por VPS (o nomine/active la suya)
3. Añadir la ubicación al proyecto

Parte 2: Utilizar Location GLB como referencia para una animación AR personalizada

4. Descargue el GLB de referencia de la parte derecha de la fila.
5. Use esto en su software de modelado 3D (Blender, Maya, A-Frame, etc) para posicionar el contenido AR relativo al origen de la malla.

*IMPORTANTE El origen de este modelo 3D es el origen de la Localización. NO RESTABLEZCA EL ORIGEN O SU CONTENIDO NO ESTARÁ ALINEADO.

OPCIONALMENTE: Si la malla descargada del navegador geoespacial no tiene la calidad suficiente para utilizarla en una animación, física u oclusor, puede considerar realizar un escaneado con una aplicación de terceros como Scaniverse y alinear esa malla de alta calidad con la descargada del navegador geoespacial .

6. Importar animación GLB en Cloud Editor y añadir a escena
7. Añada el componente named-location a la página <a-entity> de su activo. El atributo "name" se refiere al "nombre" de la ubicación del proyecto en el navegador geoespacial.

¡Tachán! 🪄 Tu animación debe aparecer alineada con la Localización en el mundo real.

Parte 3: Añadir oclusión y sombras

1. En tu escena, añade <a-entity named-location="name: LOCATIONNAME"><a-entity>
2. Añade tres <a-entity> dentro de este elemento como sus hijos. Estas serán tu malla oclusora, malla sombra y animación VPS.
3. En el primer <a-entity>, añade xrextras-hider-material y gltf-model="#vps-mesh". "#vps-mesh" debería referirse a una versión de su GLB de referencia a la que se le han eliminado las texturas y se ha diezmado la geometría.
4. En el segundo <a-entity>, añade shadow-shader, gltf-model="#vps-mesh", y shadow="cast: false". El sombreador de sombra aplica un material de sombra a la malla de referencia con un desplazamiento de polígonos para evitar la lucha Z. Puedes elegir si quieres que la malla vps proyecte una sombra sobre el mundo real con shadow="cast: true".
5. En el tercer <a-entity>, añade gltf-model="#vps-anim", reflections="type: realtime", play-vps-animation y shadow="receive:false". play-vps-animation espera hasta que el vps-coaching-overlay haya desaparecido antes de reproducir la animación VPS.

Instalación de desarrollo de escritorio remoto

A menudo resulta útil utilizar el inspector de A-Frame para posicionar el contenido de forma remota en el escritorio. Para configurar la escena de este proyecto para el desarrollo de escritorio remoto, desactive los siguientes componentes añadiendo una letra al principio (es decir, "Znamed-location"):

• xrweb -> Zxrweb
• xrextras-loading -> Zxrextras-loading
• named-location -> Znamed-location
• xrextras-hider-material -> Zxrextras-hider-material

Ahora puede abrir el A-Frame Inspector (Mac: ctrl + opt + i, PC: ctrl + alt + i) y posicionar el contenido relativo a la malla VPS importada desde el Navegador Geoespacial. Recuerde: se trata de un inspector. Deberá copiar los valores de transformación en su código.

Opcionalmente, puede reposicionar temporalmente el <a-entity named-location> al centro de la escena para ayudar con la velocidad de iteración. NOTA: reajuste <a-entity named-location> a position="0 0 0" para asegurarse de que el contenido de VPS se alinea correctamente.

Instalación de desarrollo móvil remoto

A menudo es útil utilizar el inspector A-Frame para simular VPS de forma remota en su dispositivo móvil. Para configurar la escena de este proyecto para el desarrollo móvil remoto, desactive los siguientes componentes añadiendo una letra al principio (es decir, "Znamed-location"):

• named-location -> Znamed-location
• xrextras-hider-material -> Zxrextras-hider-material

A continuación, tendrá que desactivar VPS y activar la escala absoluta. Esto garantizará que la malla de referencia tenga el tamaño correcto para una simulación precisa:

xrweb="enableVps: false; scale: absolute;"

Debe reposicionar temporalmente el <a-entity named-location> al centro de la escena para ayudar con la velocidad de iteración. Intenta alinear la base de tu malla de referencia con y="0" (el suelo). NOTA: Antes de desplegar su proyecto VPS, restablezca <a-entity named-location> a position="0 0 0" para asegurarse de que el contenido VPS está alineado correctamente.

Desarrollo de experiencias VPS procedimentales

Las escenas VPS procedimentales están diseñadas para utilizar cualquier Ubicación detectada (en contraposición a Ubicaciones de Proyecto específicas). Una vez detectada, la malla de la Ubicación está a su disposición para generar experiencias VPS generadas procedimentalmente.

El motor de 8th Wall emite dos eventos relacionados con el procedimiento:

• xrmeshfound: se emite cuando se encuentra una malla por primera vez, ya sea después del inicio o después de un recenter()
• xrmeshlost: emitido cuando se llama a recenter().

Después de detectar una malla, el motor de 8th Wall continuará rastreando contra esa malla hasta que se llame a recenter().

PREGUNTAS FRECUENTES SOBRE VPS

¿Qué es Lightship VPS?

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

¿Cómo funciona el VPS?

Cuando un dispositivo hace una llamada al servicio VPS, éste recibe una imagen de consulta del dispositivo del usuario junto con su ubicación aproximada (a partir del GPS) como datos de entrada e intenta localizarlo utilizando el mapa o mapas que existan en esa ubicación. Si la localización se realiza correctamente, el servicio devuelve la posición y orientación (pose) del dispositivo correspondientes a la marca de tiempo de la imagen que se transmitió . Dado que existe 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 en 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 movimiento del dispositivo mientras espera la respuesta del servidor a la consulta VPS.

¿Qué es un escaneo?

Los escaneos AR de jugadores, desarrolladores y topógrafos son el ingrediente fundamental utilizado para crear el Niantic Map: El mapa 3D del mundo de Niantic. Los escaneos AR se registran y cargan utilizando el marco de escaneado AR de Niantic, que es un módulo utilizado dentro de Pokemon Go, Ingress y la aplicación Wayfarer. Cada exploración de AR 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. Niantic utiliza los escáneres de realidad aumentada para crear mapas y mallas de lugares del mundo real en .

¿Qué es un mapa?

En la jerga de VPS, un mapa es el artefacto de datos que se utiliza para localizar su dispositivo cuando se llama a la API de VPS . Un mapa puede considerarse como una función que toma una imagen de consulta como entrada y devuelve posición y orientación (pose) como salida. El mapa que corresponde a un lugar determinado se crea a partir de las exploraciones 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 físico u objeto, y son útiles para comprender cómo es un lugar , como referencia para la creación de contenidos de realidad aumentada, y para crear efectos de física y oclusión. Al igual que los mapas de , las mallas que corresponden a un lugar determinado se crean a partir de las exploraciones que se cargaron en ese lugar. Las mallas son legibles tanto por humanos como por máquinas.

¿Dónde puedo utilizar VPS?

VPS está disponible en más de 150.000 lugares del mundo real, y cada día se añaden más lugares. En para que una ubicación esté disponible en VPS, debe cargarse una cantidad suficiente de datos de escaneado AR en esa ubicación y debe completarse el proceso de activación de VPS. Los desarrolladores pueden añadir nuevas ubicaciones a el mapa y solicitar la activación de VPS de ubicaciones totalmente escaneadas mediante el navegador geoespacial.

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

Para que una ubicación pueda optar a la activación del VPS, debe tener cargados al menos 10 escaneos que superen los controles de calidad mínimos de , y la diferencia de tiempo entre el escaneo 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 mallas resultantes tengan calidad suficiente y capturen variaciones suficientes para que los usuarios puedan localizarlos con fiabilidad. El proceso de activación de VPS se ejecuta en la infraestructura de mapeado de RA de Niantic y conlleva muchos pasos complejos . Del conjunto de exploraciones elegibles en la ubicación, un algoritmo selecciona la mayoría de las exploraciones para utilizarlas para construir mapas y mallas, y el puñado restante para validarlas y medir la calidad de la localización . El proceso de activación de una ubicación se ejecuta en los servidores de Niantic y normalmente tarda entre 1 y 2 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 las exploraciones cargadas se fusionan para incorporar la mayor cantidad de información posible. El producto final, que los desarrolladores utilizan en para crear contenidos y los usuarios para localizarlos, se compone de exploraciones de muchas fuentes diferentes de . Los datos de escaneado se mezclan para crear una representación más completa del lugar, por lo que no existe una relación unívoca entre los escaneados que se cargan en un lugar y los mapas y mallas que se crean una vez que se activa el VPS.

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

En algunos casos, es posible que los desarrolladores deseen añadir exploraciones adicionales a un lugar previamente activado en para mejorar la calidad y la cobertura de los mapas y mallas del lugar. En para que una Ubicación pueda ser "reactivada", debe haber tenido al menos 5 escaneos adicionales cargados desde la última vez que fue activada. Cabe destacar que aún no es posible añadir nuevas exploraciones a un mapa fusionado existente, sino que el proceso de reactivación requiere la construcción de un nuevo mapa fusionado que incorpore las nuevas exploraciones en el contexto de las ya 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 en con al menos 5 horas de diferencia 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 aplicación 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 de se completa en 2 horas. Los promotores también tienen la opción de solicitar a 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 las probabilidades de éxito de las experiencias con VPS, lo mejor es cargar muchas exploraciones de RA que cubran una amplia gama de condiciones diferentes de (por ejemplo, diferentes horas del día, diferentes condiciones meteorológicas, etc.). Por ejemplo, si está construyendo una experiencia en un lugar en el que llueve mucho, contar con algunos escaneos de un día lluvioso es muy útil.

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

El escaneado de AR y el VPS no requieren LiDAR.