Publicar y compartir

Previsualizar antes de publicar

La pestaña Previsualizar recorre el borrador entero tal como lo verá el visitante: los mismos hotspots, el mismo minimapa, el mismo modo VR, sin publicar nada ni tocar lo ya publicado. La barra superior avisa de lo que impediría publicar.

Es además donde se ajustan las llegadas sin esfuerzo: como la previsualización sabe de dónde vienes, cuando entras en una sala mirando a una pared basta girar hasta lo que quieres que se vea y pulsar «Guardar como llegada desde…». Ajustar un recorrido de trece salas deja de ser rellenar formularios y pasa a ser un paseo.

Publicar en la plataforma

Publicar congela una versión inmutable del tour en el almacenamiento y la sirve en /t/{slug}. El borrador sigue siendo editable; los visitantes no ven los cambios hasta la siguiente publicación. Puedes despublicar o republicar cualquier versión anterior desde la pestaña Versiones.

Opciones de visibilidad (§protección de acceso):

Público: indexable, aparece en el sitemap.
No listado: solo con enlace.
Protegido por contraseña.
Solo usuarios de la organización: requiere iniciar sesión.
Restringido a dominios de embebido: allowlist de dominios (frame-ancestors + Referer).

Además: fecha de publicación programada y fecha de expiración.

Tras publicar obtienes: URL pública con deep links (#s=escena&y=120&p=-5&f=70), código QR, código de embebido responsive y metadatos Open Graph con imagen de la vista inicial.

La galería pública de andarama.com

En la instancia alojada, un tour público puede pedir además una página propia en la galería, andarama.com/explorar/{slug}/, pensada para que los buscadores la encuentren por el nombre del lugar. Al publicar, activa «Mostrar en la galería pública de andarama.com» y rellena:

Título de la ficha, con el nombre del lugar («Catedral de La Laguna: recorrido virtual 360»).
Descripción: un párrafo de entre 300 y 600 caracteres, en un solo idioma.
Lugar y país, y las coordenadas si las sabes (si el tour ya tiene mapa, se rellenan solas).
Atribuciones, si las fotografías no son tuyas.

La ficha lleva el visor embebido, el botón de pantalla completa, la portada capturada al publicar como imagen social, datos estructurados de lugar (TouristAttraction o Place, con geo) y entra en el sitemap-tours.xml con su portada. Si cambias la visibilidad a algo que no sea público, la ficha se apaga sola; los textos se conservan por si la vuelves a encender. El índice, andarama.com/explorar/, se filtra por país.

API postMessage del visor embebido

// controlar el visor desde la página que lo embebe
iframe.contentWindow.postMessage({ andarama: "goTo", scene: "aula" }, "*");
iframe.contentWindow.postMessage({ andarama: "setView", view: { yaw: 1.2 } }, "*");
iframe.contentWindow.postMessage({ andarama: "setLang", lang: "en" }, "*");
iframe.contentWindow.postMessage({ andarama: "getState" }, "*");
// escuchar eventos
addEventListener("message", (e) => {
  if (e.data?.andarama === "sceneChange") console.log(e.data.scene);
});

Cómo se ve el enlace al compartirlo

En Ajustes del tour › Compartir el enlace se controla la tarjeta que aparece al pegar la dirección en WhatsApp, X, Teams, Slack o el aula virtual, con una vista previa de cómo quedará:

Campo	Para qué
Título de la tarjeta	Si se deja vacío, el título del tour
Texto de la tarjeta	Dos líneas: las redes recortan
Nombre del sitio	La organización («Museo de la Ciudad»)
Imagen	1200 × 630 px. Sin ella, casi ninguna red muestra tarjeta grande
Texto alternativo	Accesibilidad de esa imagen
Tipo de tarjeta	Imagen grande o pequeña (X/Twitter)
Cuenta de X del sitio	`@ull`
Idioma declarado	`es_ES`
No indexar	Añade `robots noindex`, útil en tours internos

Se traducen como cualquier otro texto del tour, así que la tarjeta sale en el idioma con el que se abra el enlace. Los mismos metadatos viajan dentro del paquete exportado, de modo que un tour subido a otro alojamiento se comparte igual de bien.

Exportar paquete estático

Exportar genera en tu navegador un ZIP autocontenido (index.html + visor + tour.json + tiles + medios) sin ninguna dependencia externa: funciona por FTP en cualquier hosting, con python3 -m http.server, en GitHub Pages o Cloudflare Pages sin configuración. No lleva backend, ni CDN, ni llamadas a la plataforma: una vez subido, el tour vive por su cuenta.

Eso sí, hay que servirlo, no abrirlo: el paquete estándar no funciona haciendo doble clic en index.html (file://), porque el navegador bloquea desde el sistema de ficheros tanto los módulos JavaScript como los panoramas. Para verlo en local, python3 -m http.server en la carpeta y abrir http://localhost:8000.

Opciones:

Idiomas incluidos y resolución máxima de tiles (para reducir peso).
Incluir/excluir descargas de PDF e imágenes.
Analítica: endpoint propio configurable o desactivada.
Service worker offline: PWA instalable, ideal para museos y kioscos sin red.
HTML único: un solo index.html con el visor y los medios en base64, que sí se abre con doble clic. Solo admite escenas equirectangulares: los tiles multirresolución no se pueden incrustar porque el visor calcula sus URL nivel a nivel, así que con un tour teselado la opción aparece desactivada. Al abrirse por file:// no hay WebXR (no es contexto seguro) y la VR queda en modo cardboard.
SCORM 1.2 / 2004: paquete para LMS con reporte de finalización y puntuación.
Kiosko: autopilot + reinicio por inactividad + bloqueo de salida.

El ZIP incluye además un LEEME.md con las instrucciones de subida y un .htaccess con los tipos MIME (.webp, .avif, .glb, .webmanifest) y las cabeceras de caché que necesitan los alojamientos compartidos con Apache. El paquete funciona igual dentro de un subdirectorio (https://midominio.es/tours/mi-tour/): todas las rutas son relativas.

Realidad virtual en el paquete exportado

El paquete lleva el mismo motor que el tour publicado, así que el botón Modo VR funciona también desde el ZIP, con una condición: hay que servirlo por HTTPS. WebXR solo existe en contextos seguros; abriendo el index.html con doble clic (file://) el tour se ve, pero el modo inmersivo cae al respaldo cardboard. Cualquier alojamiento con certificado —incluidos GitHub Pages, Cloudflare Pages o Netlify, gratuitos— sirve. Véase la guía de realidad virtual.

También puedes automatizar la publicación desde CI con un token de API (POST /api/v1/projects/{id}/publish) y recibir webhooks de publicación.

Modo quiosco

Para una pantalla en una sala, una feria o un vestíbulo: el tour se explica solo y cualquiera puede tomar el mando.

Encadena todos los recorridos, uno detrás de otro. No se queda en el primero.
En cada parada se entra como entraría un visitante: por el paso que une las dos escenas y con la orientación de llegada de ese paso. Se espera los segundos indicados en la parada y, antes de cambiar de escena, mira hacia la puerta por la que va a salir, de modo que se entienda de dónde a dónde se va.
Al terminar vuelve a la escena inicial y espera: aparece «El recorrido ha terminado» con el botón Verlo otra vez. Solo se repite sin parar si algún recorrido tiene marcado Repetir en bucle (en el grafo, modo Autopilot).
Quien toca la pantalla se queda al mando: aparece «Estás explorando por tu cuenta» y un botón para volver al recorrido. Si nadie toca nada durante un minuto, el quiosco vuelve a la escena inicial; con el bucle puesto, además arranca de nuevo solo.
La lista de recorridos está siempre abajo: se pulsa uno y empieza ese.

Cómo se consigue

Hay tres caminos, y los tres llevan al mismo sitio:

Al publicar, en Cómo se abre el enlace, eligiendo «Modo quiosco». La dirección de siempre (/t/tu-tour) arranca ya en bucle, que es lo que hace falta cuando el televisor de la entrada solo sabe abrir una URL fija. Volver a publicar sin tocar nada conserva el modo; para deshacerlo se elige «Recorrido normal».
Con el enlace de quiosco, que está siempre a mano en Compartir y en la pantalla final de publicar: es la misma dirección con ?kiosk=1. Sirve para poner una pantalla en bucle sin cambiar cómo abre el enlace todo el mundo. Funciona en los dos sentidos: ?kiosk=0 saca el recorrido suelto de un tour publicado en quiosco, por si quieres compartirlo con alguien.
Al exportar (Exportar › Modo quiosco), si lo que quieres es un paquete que funcione sin conexión ni servidor.