📘 Manual de uso · Nivel usuario

VIA · Buscador de dispositivos, control maestro y control individual

Este manual explica cómo utilizar el panel principal de VIA (control.html) para buscar gafas en la red, controlar varias a la vez (modo maestro / espejo) y acceder al control remoto individual de cada dispositivo.

1. Objetivo del panel principal (control.html)

La página principal de control de VIA (control.html) está pensada para que el personal del centro (terapeutas, técnicos, monitores) pueda:

• Localizar todas las gafas VIA conectadas a la red del centro.
• Ver información básica de cada dispositivo: nombre, usuario, nivel de batería y vista previa.
• Seleccionar varios dispositivos para controlarlos en grupo mediante un dispositivo Maestro.
• Acceder al control remoto individual de cada gafa en una pestaña aparte.

Este manual se centra en el uso a nivel usuario, sin entrar en detalles técnicos de red o configuración avanzada.

2. Requisitos previos

Antes de utilizar el panel principal y el control individual, asegúrese de lo siguiente:

3. Panel de búsqueda de dispositivos

En la parte superior de control.html aparece un bloque con los campos necesarios para localizar las gafas en la red.

3.1. Campos principales

Prefijo LAN (x.x.x.)

• Es el “inicio” de la dirección de red donde están los dispositivos (ej.: 192.168.1.).
• Botón “Auto”:
  • Intenta detectar automáticamente el prefijo correcto.
  • Es la opción recomendada en la mayoría de casos.

Rango

• Por defecto: 1-254, cubre las direcciones habituales.
• No es necesario cambiarlo salvo indicación técnica.

Puerto

• Por defecto: 8080.
• No se debe modificar salvo que el técnico lo indique.

PIN

• Campo para introducir el código de seguridad si el sistema lo requiere.
• Si su instalación no usa PIN, puede dejarse en blanco.

3.2. Botones de acción

Scan

• Inicia la búsqueda de dispositivos en la red indicada.
• El mensaje “Encontrados: X” se va actualizando con el resultado del escaneo.

Parar

• Detiene el escaneo antes de que termine.

Borrar cookies

• Elimina la lista de dispositivos recordados en el navegador.
• Útil si cambia de centro, de WiFi o quiere empezar un escaneo limpio.

Indicador “Encontrados: X”

• Muestra cuántos dispositivos hay registrados en ese momento (incluidos los ya recordados).

4. Barra de herramientas: vistas previas y selección

Debajo del panel de búsqueda aparece una barra con opciones para trabajar con varios dispositivos a la vez.

4.1. Vistas previas en vivo

Casilla “Vistas previas en vivo”

• Si se activa, las miniaturas de cada dispositivo se actualizan de forma periódica.
• Permite ver una imagen reciente de lo que ve cada gafa.

Desplegable “FPS”

• Define la frecuencia de actualización de las miniaturas (1, 2, 3 o 5 imágenes por segundo).
• Valores entre 2 y 3 FPS suelen ser suficientes para supervisar sin saturar la red.

4.2. Selección de dispositivos

Seleccionar todos / Deseleccionar todos

• Seleccionar todos marca todos los dispositivos como seleccionados.
• Deseleccionar todos quita la selección de todos ellos.

4.3. Apertura de controles

Abrir controles de seleccionados

• Abre una pestaña de control individual por cada dispositivo que tenga la casilla “Sel” marcada.

Abrir controles de todos

• Abre el control individual de todos los dispositivos encontrados, estén o no seleccionados.
• Úselo con precaución si hay muchas gafas conectadas.

5. Lista de dispositivos: interpretación de las tarjetas

Cada dispositivo localizado se muestra como una tarjeta con información básica y accesos rápidos.

5.1. Nombre, etiqueta y usuario

• Nombre del dispositivo: texto principal (ej.: “VIA”, “Zarza-4”).
• Etiqueta: pequeña pastilla (alias) que ayuda a identificar la gafa (ej.: “Sala 1”, “Gafa 03”).
• Usuario: nombre de la persona o sala asignada, si se ha configurado.

5.2. Información de batería

• Indicador visual de batería con porcentaje.
• Puede mostrar estados como “cargando”, “descargando”, “completa”, etc.
• Si aparece “Batería: sin datos”, el dispositivo no está enviando la información en ese momento.

5.3. Miniatura / Vista previa

• Imagen reducida de lo que se ve en la gafa.
• Se actualiza cuando están activadas las “Vistas previas en vivo”.

5.4. Casilla “Sel”

• Permite marcar el dispositivo como seleccionado para:
  • Aplicar acciones masivas desde la barra de herramientas.
  • Definir los destinos del control maestro / espejo.

5.5. Botón “Espejar”

• Convierte esa gafa en Maestro para el panel de “Control espejo”.

5.6. Botón “Abrir control”

• Abre el control remoto individual de esa gafa en una nueva pestaña.
• La URL tendrá el formato http://IP:PUERTO/, por ejemplo http://192.168.1.133:8080/.

5.7. Clic en la tarjeta

• Hacer clic en la tarjeta (fuera de botones y casillas) también abre el control individual de ese dispositivo.

6. Control espejo (Maestro)

El panel de Control espejo aparece en el lado derecho de control.html cuando se elige un Maestro con el botón “Espejar”.

6.1. Elección del Maestro

1. Escanee la red con “Scan”.
2. Marque con “Sel” las gafas que serán destinos del control colectivo.
3. Elija una gafa de referencia y pulse “Espejar” en su tarjeta.

Esa gafa pasa a ser el Maestro y el panel de Control espejo se rellenará con los controles disponibles.

6.2. Grupos de controles

El contenido del panel depende de la configuración de VIA, pero suele incluir:

• Botones (acciones puntuales: play, pausa, cambiar escena…).
• Interruptores (modo silencio, mostrar/ocultar elementos, etc.).
• Deslizadores de audio (volúmenes, EQ, etc.).
• Otros deslizadores (brillo, intensidad, parámetros varios).
• Campos de texto (nombres de sesión, IDs, códigos, etc.).

Todas las acciones lanzadas desde el panel de Control espejo se envían al Maestro y a los dispositivos seleccionados (destinos).

6.3. Botón “Refrescar”

• Vuelve a leer la lista de controles disponibles desde el Maestro.
• Útil si se ha cambiado de modo en la aplicación de las gafas.

7. Acceso al control remoto individual desde control.html

El control remoto individual es una página específica de cada gafa, que permite gestionar todas sus funciones de forma aislada (PIN, credenciales, inicio/parada de experiencias, audio, wearable, vista previa…).

7.1. Formas de acceder

• Desde la tarjeta de la gafa:
  • Haciendo clic en el botón “Abrir control”.
  • Haciendo clic en cualquier parte de la tarjeta (excepto en botones y casillas).
• Desde la barra de herramientas:
  • “Abrir controles de seleccionados”: abre el control individual de todas las gafas con “Sel” marcado.
  • “Abrir controles de todos”: abre el control de todas las gafas listadas.

7.2. Qué ocurre al abrir el control individual

• El navegador abre una nueva pestaña con la dirección del dispositivo: http://IP:PUERTO/.
• En esa pestaña verá el título similar a:
  VIA · NombreDispositivo - NombreUsuario · Control Remoto.
• Desde ahí podrá realizar un control detallado de una única gafa, tal y como se explica en el apartado siguiente.

8. Manual de uso del control remoto individual

El control remoto individual es la interfaz que gobierna una sola gafa VIA. A continuación se describe el uso de cada bloque de la página.

8.1. Cabecera e información general

En la parte superior verá un texto similar a:

VIA · Zarza-4 – — · Control Remoto IP 192.168.1.133 · Puerto 8080

• Nombre de dispositivo: etiqueta principal de la gafa (ej.: “Zarza-4”).
• Nombre de usuario: persona, sala o grupo asociado (si se ha configurado).
• IP y Puerto: identifican el dispositivo en la red (no es necesario modificarlos desde aquí).

8.2. Bloque “PIN y credenciales”

Este bloque es desplegable y sirve para gestionar seguridad e identificación básica del dispositivo.

PIN

• Introduzca el PIN en el campo correspondiente.
• Pulse “Guardar” para almacenarlo en el navegador y reutilizarlo sin volver a escribirlo.

Etiqueta del dispositivo

• Campo “Etiqueta del dispositivo” para definir una descripción clara (ej.: “Sala 2 · Gafa A”).
• Botón “Guardar etiqueta”:
  • Envía la nueva etiqueta al dispositivo.
  • Actualiza la cabecera y el título del navegador.

Nombre de usuario

• Campo “Nombre de usuario” para asignar una persona, sala o grupo.
• Botón “Guardar nombre”:
  • Actualiza el nombre de usuario en el dispositivo.
  • Se reflejará también en el panel principal (control.html) en la tarjeta correspondiente.

Contraseña

• Campo “Contraseña” para definir o actualizar la contraseña asociada al dispositivo.
• Botón “Guardar contraseña” para aplicar el cambio.

En la parte inferior de este bloque aparece un mensaje de estado (OK, error, sin conexión) que se actualiza con cada acción realizada en la página.

8.3. Bloque “Control” (Sendero / Raíces)

Agrupa los botones principales para manejar la experiencia específica (en el ejemplo, “Sendero” y “Raíces”):

• ✅ Mostrar SENDERO / ✅ Mostrar Raices
  • Cargan o muestran la escena correspondiente en la gafa.
• 🌱 Iniciar Sendero / 🪴 Iniciar Raices
  • Inician la experiencia seleccionada en esta gafa.
• ❌ Terminar
  • Finaliza la experiencia actual y suele devolver al menú principal.
• ☑️ Deseleccionar
  • Marca este dispositivo como no seleccionado en el panel principal (útil para acciones colectivas).
• 🧭 Recentrar
  • Recalibra la orientación de la escena según hacia dónde esté mirando el usuario.

8.4. Bloque “Player & Audio control”

Permite controlar la reproducción y los niveles de audio de la experiencia.

Controles de reproducción

• ▶️ Play: reanuda la reproducción.
• ⏸️ Pausa: pausa el contenido.
• ⏮️ Anterior: vuelve al contenido anterior.
• ⏭️ Siguiente: avanza al siguiente contenido.

Deslizadores de volumen (PAD y VIDEO)

• 🔊 PAD: controla la música de fondo o ambiente.
• 🔊 VIDEO: controla el audio principal del vídeo (voz, sonidos clave).
• Mientras se mueve un deslizador:
  • El valor numérico (ej.: 8.5) se actualiza en tiempo real.
  • Al soltar, el nuevo valor se envía al dispositivo.
• El mensaje de estado indica si la operación ha sido correcta.

Campos de texto y “Guardar todo”

• Campo de texto (por ejemplo, “entradaPrincipal”) con botón “Guardar” para enviar ese valor concreto.
• Botón “Guardar todo” para guardar de una vez todos los textos de este bloque.

8.5. Bloque “Wearable” (Hyperate)

Este bloque integra las gafas con un wearable (por ejemplo, banda de frecuencia cardiaca) a través de Hyperate.

Estado en tiempo real

• Línea con icono de corazón ❤️ y un valor que representa la constante en tiempo real (por ejemplo, ritmo cardiaco).

Enlace “Bluetooth web API”

• Abre la página de Hyperate en otra pestaña para emparejar el wearable mediante Bluetooth desde el navegador.

Mostrar / Ocultar

• Casilla “Mostrar/Ocultar” para activar o desactivar la visualización del módulo de constantes en la experiencia.

Hyperate Token e Hyperate ID

• Hyperate Token: código de conexión con Hyperate.
• Hyperate ID: identificador de sesión o dispositivo en Hyperate.
• Cada fila tiene un botón “Guardar” para enviar ese valor.
• El botón “Guardar todo” aplica todos los cambios de texto del bloque de una vez.

8.6. Bloque “Vista previa”

• Muestra una captura reducida de lo que se está viendo en la gafa.
• Se actualiza automáticamente cada pocos instantes (por ejemplo, 3 veces por segundo).
• Sirve para supervisar la experiencia sin necesidad de ver directamente la pantalla de la gafa.

8.7. Flujo recomendado de uso (sesión individual)

1. Comprobar que ordenador/móvil y gafa están en la misma WiFi y que la app VIA está abierta.
2. Abrir el control individual desde control.html (botón “Abrir control” o clic en la tarjeta).
3. Revisar y ajustar:
   • PIN y credenciales (nombre de dispositivo, usuario).
   • Volumen de PAD y VIDEO.
4. Preparar la escena con “Mostrar SENDERO” o “Mostrar Raices”.
5. Iniciar la experiencia con “Iniciar Sendero” / “Iniciar Raices”.
6. Durante la sesión:
   • Ajustar audio según la comodidad del usuario.
   • Usar “Recentrar” si la escena aparece desalineada.
   • Supervisar mediante la vista previa.
7. Finalizar con “❌ Terminar” cuando quiera dar por concluida la sesión en esa gafa.

8.8. Mensajes de error habituales

• “Sin conexión”:
  • Compruebe la WiFi, que la gafa esté encendida y que la app VIA siga abierta.
• “Error XXX” (404, 500…):
  • Indica un problema técnico de comunicación. Si persiste, será necesaria intervención técnica.

9. Consejos prácticos de uso

9.1. Antes de una sesión grupal

• Encienda todas las gafas y abra VIA en cada una.
• Desde el ordenador, abra control.html.
• Use “Auto” en el prefijo LAN y lance un “Scan”.
• Compruebe que aparecen todas las gafas que vaya a utilizar.

9.2. Gestión mixta: colectivo + individual

• Use el panel de Control espejo para acciones comunes a varias gafas (iniciar, pausar, volumen de grupo…).
• Abra el control individual de una gafa concreta cuando necesite:
  • Ajustar solo esa gafa.
  • Revisar cómodamente la vista previa de un usuario concreto.
  • Configurar credenciales, wearable o detalles específicos.

9.3. Cambio de centro o red

• Si cambia de red WiFi:
  • Conéctese a la nueva red en el ordenador/móvil y en las gafas.
  • Pulse “Borrar cookies” en control.html para limpiar dispositivos antiguos.
  • Haga un nuevo “Scan”.