Integración domótica Formula 1, gratuita y de código abierto
Próximo Gran Premio, sesiones en hora local, clasificaciones y resultados para paneles y escenas.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Siga la temporada de Fórmula 1 en Gladys: el próximo Gran Premio con todas sus sesiones en su hora local, los líderes del campeonato, el último ganador y, si lo desea, su piloto y su equipo favoritos. Un widget de panel muestra la cuenta atrás, el fin de semana y la clasificación; los disparadores de escena le avisan antes de una sesión y cuando salen los resultados; las acciones de escena le dan frases listas para enviar.
Los datos proceden de Jolpica-F1, el sucesor libre y gratuito de la API Ergast. Sin cuenta ni clave. Sus comentarios son bienvenidos en el foro de Gladys.
Qué necesita
- Gladys 5.1.0 o posterior.
- Acceso a Internet desde Gladys: la integración lee
api.jolpi.ca.
Configuración
Tras la instalación, guarde la configuración una vez, abra la pestaña Descubrir y añada el dispositivo Fórmula 1. El botón Comprobar vuelve a leer Jolpica-F1 y muestra la temporada, el próximo Gran Premio y sus favoritos tal como la integración los ha entendido.
Idioma
El idioma de los nombres de las funciones, de los nombres de las sesiones y de las frases de las escenas (Gladys no comunica a una integración el idioma de sus usuarios). Los nombres de las funciones se fijan al añadir el dispositivo: para cambiarlos, elimine el dispositivo y vuelva a añadirlo. El widget sigue el idioma de la persona que lo mira. Los nombres de Grandes Premios, circuitos, pilotos y equipos se quedan como los escribe Jolpica-F1, en inglés.
Piloto y equipo favoritos
Opcionales. El piloto: su código de tres letras (VER), su número (16), su apellido (Hamilton) o su
nombre completo. El equipo: su nombre (Ferrari, Red Bull, McLaren). Mayúsculas y acentos no
importan. Cuando se indica uno, el dispositivo recibe tres funciones más (posición en el campeonato,
puntos, último resultado) y el widget una casilla con la posición. Un nombre que no corresponde a nadie de
la temporada actual se indica en el estado de conexión, y Comprobar lista los pilotos y equipos de la
temporada. Después de cambiar un favorito, haga clic en Actualizar en el dispositivo de la pestaña
Descubrir cuando Gladys lo proponga.
El dispositivo Fórmula 1
| Función | Valor |
|---|---|
| Próximo Gran Premio | su nombre; «Temporada … terminada» tras la última carrera |
| Circuito, País | dónde se celebra |
| Salida de la carrera, clasificación | día y hora, en la zona horaria de Gladys |
| Salida del sprint | día y hora, o «Sin sprint» |
| Próxima sesión | la próxima sesión del fin de semana, o la carrera «en curso» |
| Días hasta la carrera | 0 el día de la carrera |
| Ronda | la ronda del próximo Gran Premio |
| Fin de semana de carrera | Encendido del día de los primeros libres al día de la carrera |
| Carrera hoy | Encendido el día de la carrera |
| Líder de pilotos / de constructores | nombre y puntos |
| Último ganador, Último podio | de la última carrera con resultados publicados |
| Piloto favorito: … | posición, puntos, último Gran Premio (0: no clasificado) |
| Equipo favorito: … | posición, puntos, mejor coche en el último Gran Premio (0: ninguno) |
Un Gran Premio sigue siendo el «próximo» hasta tres horas después de su salida. Los valores los actualiza la propia integración (Gladys no consulta este dispositivo) y se vuelven a publicar dos veces al día.
Widget de panel
Añada el widget Fórmula 1 a un panel. Muestra el nombre del próximo Gran Premio, la cuenta atrás hasta la carrera («10 d 5 h», luego horas y minutos el día de la carrera, luego «En curso»), la ronda, la posición de sus favoritos, las sesiones del fin de semana en su hora local (la próxima resaltada), el top 5 del campeonato de pilotos o de constructores (un ajuste del widget) y el podio de la última carrera.
Disparadores de escena
Sesión que empieza
Se activa antes de una sesión de un fin de semana de Gran Premio. Elija las sesiones (libres 1 a 3, clasificación sprint, sprint, clasificación, carrera; vacío: todas) y cuándo: en la salida, o 5, 15, 30 minutos, 1 o 2 horas antes. La escena puede leer el nombre de la sesión, el Gran Premio, el circuito, la hora de inicio, los minutos restantes y la ronda.
Carrera terminada
Se activa cuando se publican los resultados de un Gran Premio en Jolpica-F1, normalmente unas horas después de la bandera a cuadros (la integración comprueba cada 10 minutos después de la carrera). La escena puede leer una frase de resumen («Max Verstappen (Red Bull) gana el Singapore Grand Prix, por delante de …»), el Gran Premio, el ganador y su equipo, el podio, la posición de su piloto favorito y la mejor posición de su equipo favorito (0: no clasificado o no elegido).
Acciones de escena
- Leer el próximo Gran Premio: una frase como «Próximo Gran Premio: United States Grand Prix, ronda 18, Circuit of the Americas, Austin (Estados Unidos). Carrera el domingo, 25 de octubre a las 21:00, dentro de 10 días.», además del nombre, la salida de la carrera y los días restantes (-1 cuando la temporada ha terminado).
- Leer la clasificación: la cabeza del campeonato de pilotos o de constructores (1 a 10 puestos) en una frase, además del líder y sus puntos.
Ejemplos de escenas
- No perderse nunca la salida: disparador «Sesión que empieza», sesiones Clasificación y Carrera, 15 minutos antes → enviar un mensaje con la Sesión, el Gran Premio y la Hora de inicio, y encender la televisión.
- Resumen del domingo por la noche: disparador «Carrera terminada» → enviar la frase de resumen por mensaje.
- Resumen del lunes por la mañana: cada lunes a las 8:00 → «Leer el próximo Gran Premio» y «Leer la clasificación» → enviar las dos frases.
- Ambiente de carrera: disparador «Sesión que empieza», Carrera, en la salida → poner las luces del salón en rojo.
Solución de problemas
- El dispositivo no muestra nada: añádalo desde la pestaña Descubrir y espere un minuto. Consulte el estado de conexión de la integración: indica cuándo no se puede acceder a Jolpica-F1.
- «Piloto favorito no encontrado»: use Comprobar, que lista los pilotos y equipos de la temporada con sus códigos.
- Un disparador no se ha activado: una sesión cuya hora aún no se ha anunciado no activa nada; un disparador perdido mientras Gladys o la integración no están disponibles se envía con retraso durante 10 minutos como máximo y luego se pierde. Justo después de la instalación no se recupera nada.
- Los resultados llegan tarde: Jolpica-F1 lo mantienen voluntarios; los resultados suelen publicarse en pocas horas, a veces al día siguiente. La integración sigue comprobando durante 48 horas después de una carrera.
Límites
- Sin directo: Jolpica-F1 ofrece calendarios, resultados y clasificaciones, no lo que pasa durante una sesión. Las banderas rojas y los coches de seguridad necesitarían datos en directo, que OpenF1 solo da a los usuarios de pago durante una sesión: no hay disparador para ellos.
- Los resultados de los sprints no se siguen, solo los de los Grandes Premios.
- Las lecturas se espacian para respetar los límites de Jolpica-F1 (4 peticiones por segundo, 500 por hora): el calendario una vez al día, resultados y clasificaciones cada 6 horas, y cada 10 minutos después de una carrera hasta su publicación. Las respuestas se guardan en caché en la carpeta de datos de la integración: el dispositivo y el widget siguen funcionando cuando la API no responde.
- Los nombres (Grandes Premios, circuitos, pilotos, equipos) están en inglés, tal como los publica Jolpica-F1.
- Tras la última carrera de la temporada, «Próximo Gran Premio» y «Próxima sesión» indican el final de la temporada, pero las demás funciones de la próxima carrera conservan los valores del último Gran Premio hasta el calendario siguiente.
- Una sesión cuya hora aún no se ha anunciado se sitúa a mediodía UTC: lejos de Europa, su día puede diferir en uno hasta que se publique la hora.
Datos y créditos
Calendario, resultados y clasificaciones: Jolpica-F1 (código bajo Apache 2.0, datos según las condiciones del proyecto). Esta integración no está afiliada a la Fórmula 1, ni a la FIA, ni a Jolpica-F1. Formula 1 y F1 son marcas de Formula One Licensing B.V.
Parámetros de configuración
Estos son los parámetros que Formula 1 te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Funcionamiento | section | No | El calendario, los resultados y las clasificaciones proceden de Jolpica-F1, una API de datos abiertos gratuita: sin cuenta ni clave. Después de guardar, añada el dispositivo Fórmula 1 en la pestaña Descubrir y luego el widget Fórmula 1 a un panel. |
| Idioma de los textos | select | No | Nombres de las funciones, de las sesiones y frases de las escenas. Los nombres se fijan al añadir el dispositivo. |
| Piloto favorito | string | No | Opcional. Código, número o nombre de un piloto de la temporada (VER, 16, Hamilton). El dispositivo muestra entonces su posición, puntos y último resultado. |
| Equipo favorito | string | No | Opcional. Nombre de un equipo de la temporada (Ferrari, McLaren, Red Bull). El dispositivo muestra entonces su posición, puntos y mejor resultado en la última carrera. |
Cómo instalar Formula 1 en Gladys
- En Gladys, abre Integraciones: Formula 1 aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-f1:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-f1.
Formula 1 requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Formula 1 es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación