Cómo ejecutar un ejemplo de aplicación XR de GitHub

Inicio rápido

Este inicio rápido te llevará a través de los pasos para crear un simple juego de RA basado en la geo-posición y potenciado por la Plataforma del Universo Esferoide.

Crear una cuenta en la Plataforma del Universo Esferoide

Antes de crear tu aplicación, necesitas crear una cuenta en la Plataforma del Universo Esferoide.

Si ya tienes una cuenta en la Plataforma del Universo Esferoide, puedes saltarte este paso.

Acceda al IDE de Spheroid Demiurge

Ahora tienes acceso a todos los servicios de la Plataforma, incluyendo el Demiurge Esferoide IDE.

Accede al IDE de Spheroid Demiurge, usando el mismo correo electrónico y contraseña que usaste para registrarte en la Plataforma.

Crea tu aplicación

Abre la pestaña "Aplicaciones" y haz clic en el botón "Crear".

Introduce el nombre de la aplicación, deja la marca en la casilla "Crear una capa correspondiente a esta aplicación" y haz clic en el botón "Crear aplicación". La aplicación se creará junto con la capa en la que más tarde se publicará la aplicación.

Si la aplicación no se crea inmediatamente y aparece el error "No se puede crear una aplicación porque la aplicación con el nombre 'xxx' ya existe", significa que el nombre que has elegido ya está ocupado, así que prueba con otro.

Descargue el código fuente

Ya hemos preparado para ti el código fuente que necesitarás para crear una aplicación de demostración. Descargue un archivo zip de nuestro repositorio.

Entonces extrae el contenido de la carpeta "'SpheroidScript-master\examples\CoinQuest\src'" del archivo zip. ¡Ya estás listo para subir el código fuente de tu aplicación!

Sube el código fuente al IDE de Spheroid Demiurge

Ahora, lo que necesitas hacer es subir los archivos extraídos con el código fuente al IDE manteniendo la estructura del árbol sin cambios. Así que en la raíz de tu aplicación necesitas tener tres carpetas llamadas "assets", "client" y "server", así como el archivo "app.json".

Actualmente, no se puede subir un zip completo o una carpeta al IDE, pero se pueden subir varios archivos a la vez con un solo arrastrar y soltar.

Abre la pestaña "IDE" y selecciona tu aplicación en la lista desplegable.

Crea la carpeta "assets": haz clic con el botón derecho del ratón en el nombre de la aplicación y selecciona la opción "Create a folder", luego, cuando aparezca el diálogo, introduce "assets" y haz clic en "OK".

Repita estos pasos para las carpetas "client" y "server". Esto es lo que verás cuando termines:

Para cada carpeta, haga clic con el botón izquierdo del ratón en la carpeta para expandirla. El texto "Arrastrar y soltar archivos aquí para subir" aparecerá a la derecha. Arrastre y suelte los archivos con el código fuente de la carpeta correspondiente en su PC local.

Luego, haz clic con el botón izquierdo del ratón en la carpeta raíz (con el mismo nombre que tu aplicación) para expandirla y arrastra y suelta el archivo "app.json".

Ya has terminado! Ahora puedes proceder a publicar la aplicación.

Publicar tu aplicación

Publica tu aplicación. Haz clic en el botón "Publicar" en el menú superior y, cuando aparezca el diálogo, mantén la configuración predeterminada y haz clic en el botón "Publicar" en la parte inferior derecha del diálogo.

Si la publicación ha tenido éxito, verá cuatro mensajes de información en la pestaña "Construir" en el panel inferior. Felicidades, has publicado tu aplicación!

Si no ves los cuatro mensajes de información, o en su lugar ves mensajes de error, comprueba que has seguido los pasos anteriores con precisión y, si es así, escríbenos un problema, y te ayudaremos a resolverlo.

Lanza tu aplicación en tu teléfono móvil

Ahora que tienes tu aplicación construida y publicada, es hora de ejecutarla en tu teléfono móvil.

Descarga la aplicación móvil XRHub para Android siguiendo el enlace de Google Play o escaneando el código QR

Actualmente, XRHub funciona en los dispositivos Android que sólo soportan ARCore. La versión iOS de la aplicación será lanzada pronto.

Lanza la aplicación XRHub en tu teléfono.

Toca el botón de menú en la parte inferior central, luego toca el ícono de la cuenta e ingresa a la aplicación usando el mismo correo electrónico y la misma contraseña que usaste para registrarte en la Plataforma.

Cuando estés autorizado, pasa a través de la lista de mundos para encontrar el mundo en el que tu aplicación ha sido publicada (el mundo se llama "capa" en el IDE). Ten en cuenta que si no estás conectado, no verás el mundo, porque los mundos creados por los desarrolladores son privados. En los últimos tutoriales aprenderás a añadir probadores a tu mundo de capas, también conocido como "layer".

Cuando hayas encontrado tu mundo, toca el botón "Lanzar", y verás las monedas en la pantalla. Felicidades, has ejecutado con éxito tu aplicación en el XRHub! Recoge algunas monedas y mira cómo cambia el valor del contador después de tocar cada moneda. Mira los registros de la aplicación en tiempo real en el IDE en las pestañas "Cliente" y "Servidor" en el panel inferior.

Solución de problemas

Si ha encontrado algún problema, por favor háganoslo saber enviando un asunto, nos aseguraremos de ayudarle a encontrar la solución. No dude en ponerse en contacto con nosotros, ya que sus problemas y nuestras respuestas ayudarán a mejorar nuestra plataforma y serán valiosas para otros desarrolladores.

¿Y ahora qué?

Este inicio rápido ha cubierto la base mínima para empezar a desarrollar aplicaciones de RA impulsadas por la plataforma del Universo Esferoide.

En los próximos tutoriales, veremos más de cerca lo que hemos hecho explorando el código fuente de la aplicación. Nos familiarizaremos con el Script Spheroid, el lenguaje de la plataforma. Hablaremos de la estructura del proyecto y discutiremos algunos conceptos clave, por ejemplo, la división del código en una parte del lado del cliente y una parte del lado del servidor. Por último, aprenderemos los fundamentos de la persistencia de datos en una base de datos en la nube utilizando el Spheroid SQL.

Hasta el próximo tutorial, ya puedes empezar a explorar Spheroid Script por ti mismo usando la documentación.