[Integración externa] Fully Kiosk Browser

¡Hola a todos :waving_hand:

Acabo de lanzar la v1.0.0 de mi integración externa para Fully Kiosk Browser, la aplicación que convierte una tableta Android en una pantalla de quiosco (panel mural, terminal de recepción, etc.). Permite descubrir sus tabletas y controlarlas directamente desde Gladys, sin cuenta en la nube.

Repo GitHub: GitHub - vincentBesseau/gladys-fullykiosk: External Gladys Assistant integration to discover Fully Kiosk Browser tablets via MQTT and control them through their local HTTP REST API. · GitHub

¿Qué hace?

Dos formas de descubrir sus tabletas, según su edición de Fully Kiosk:

  • Vía MQTT (licencia Fully Kiosk PLUS requerida): pasivo, la integración lee los informes JSON deviceInfo que Fully Kiosk ya publica solo. Puede ejecutar y gestionar su propio broker Mosquitto (nada que instalar, credenciales generadas automáticamente) o conectarse a un broker MQTT que ya tenga.
  • Añadir por IP (edición gratuita): una acción consulta directamente la API REST de la tableta para añadirla y guardar su contraseña en un solo paso - no se requiere ningún broker. Si solo usa este modo, una configuración « Desactivar MQTT » evita ejecutar un broker innecesariamente.

En ambos casos, el control se realiza a través de la API REST local de la tableta (http://<ip>:2323/?cmd=...), protegida por la contraseña de administración remota definida en Fully Kiosk.

Funcionalidades por tableta

Funcionalidad Efecto
Pantalla Enciende/apaga la pantalla de la tableta
Bloqueo de quiosco Activa/desactiva el modo quiosco (bloqueo) de Fully Kiosk
Protector de pantalla Inicia/detiene el protector de pantalla
Página actual (lectura) La URL/la aplicación actualmente en primer plano
Cargar una URL Carga inmediatamente la URL escrita
Síntesis de voz Hace que la tableta diga un texto
Reiniciar la app Reinicia la aplicación Fully Kiosk
Recargar la URL de inicio Recarga la URL de inicio configurada
Reiniciar el dispositivo Reinicio completo (requiere Device Owner/root Android)
Vaciar la caché Vacía la caché del navegador
Salir de la app Cierra la aplicación Fully Kiosk
Batería / En carga (lectura) Cuando la tableta los envía

Y varias acciones de configuración:

  • Añadir una tableta por IP — IP + contraseña API REST, no se necesita MQTT.
  • Definir la contraseña API REST de una tableta — para una tableta ya descubierta a través de MQTT: lista desplegable de las tabletas añadidas, no es necesario escribir una IP.
  • Mostrar las credenciales del broker dedicado — dirección, identificador, contraseña y tema MQTT para ingresar en Fully Kiosk (modo broker dedicado).
  • Actualizar la lista de tabletas — fuerza una nueva publicación de las tabletas conocidas en el lado MQTT.

Instalación

En Gladys, añada la integración apuntando a este repositorio: GitHub - vincentBesseau/gladys-fullykiosk: External Gladys Assistant integration to discover Fully Kiosk Browser tablets via MQTT and control them through their local HTTP REST API. · GitHub. Los detalles completos de los pasos de configuración (elección del modo broker, activación de MQTT o Administración remota en el lado de Fully Kiosk…) están en el docs/fr.md del repositorio.

Límites conocidos

  • 100% red local: nada funciona si la tableta (o el broker MQTT, en modo MQTT) es inalcanzable.
  • El informe MQTT está reservado para la licencia Fully Kiosk PLUS - de ahí la acción « Añadir una tableta por IP » para la edición gratuita.
  • No hay retorno en tiempo real: el panel de control solo refleja el estado real después del próximo informe MQTT programado (o una consulta manual, cada ~10 min).
  • « Reiniciar el dispositivo » y algunos comandos requieren que la tableta sea Device Owner (o root), de lo contrario Fully Kiosk rechaza el comando.

Detalles completos (y algunos quirks de Fully Kiosk documentados de paso) en el repositorio. Codificado con la ayuda de Claude Code, licencia Apache-2.0.

No duden en probarlo - comentarios e issues bienvenidos en el repositorio GitHub :slightly_smiling_face:

2 Me gusta