
Un plano muestra la puerta cerrada cuando su sensor inalámbrico deja de reportar. La imagen se ve ordenada, pero la conclusión es incorrecta. Una visualización útil debe distinguir una condición observada de una observación ausente, tanto en un plano 2D como en una casa 3D.
Empezá por la entidad, no por el color
Asociá el componente con un ID estable como light.office, no con su nombre amigable. Los nombres pueden cambiar o repetirse. Por cada asociación, definí dominio esperado, estados admitidos, atributos, unidades y criterio de disponibilidad.
Home Assistant conserva estado y atributos en un objeto. Su documentación de estados distingue unknown y unavailable de los estados ordinarios. El primero indica un valor no conocido; el segundo, que la entidad no puede proporcionarlo en ese momento. Ninguno equivale a off ni a un cero medido.
Definí un contrato pequeño para la vista
Para temperatura, transportá juntos valor, unidad y calidad. Un modelo de presentación ilustrativo puede ser:
{
"componentId": "room-office",
"entityId": "sensor.office_temperature",
"value": 21.5,
"unit": "°C",
"quality": "valid"
}
Si la entidad deja de estar disponible, conservá el valor anterior únicamente con una indicación clara de “Última lectura”. No enviés 0 como relleno al renderer: cero grados es una condición real, no una marca de dato ausente.
Convertí explícitamente si la integración usa otra unidad. No apliqués el mismo rango de colores a °C y °F. Para una puerta, verificá el significado del dominio y su clase de dispositivo: una entrada numérica, una cerradura y un sensor de apertura no deben compartir una conversión booleana a ciegas.
Un valor estable puede seguir vigente
Home Assistant diferencia el momento en que cambió el estado del momento en que se actualizó o reportó. No usés solo “último cambio” para declarar vencida una temperatura estable. También importa cómo reporta la integración: algunos equipos publican únicamente cuando cambia el valor.
Elegí el criterio de disponibilidad según la integración, no mediante una edad universal. Un sensor a batería puede reportar poco; un medidor de energía muestreado con frecuencia requiere otra expectativa. Si el origen ya indica que la entidad no está disponible, respetá esa condición en vez de inferir salud porque se abrió una conexión recientemente.
Separá observación y comandos
Una vista de solo lectura puede mostrar estados sin ofrecer control. Si después se aprueba controlar, usá otra ruta autorizada y distinguí solicitud, aceptación y resultado observado. Cambiar el dibujo inmediatamente después de pulsar un botón no demuestra que se encendió la lámpara física.
No coloqués tokens Home Assistant en JavaScript público ni conectés el LAB abierto a una vivienda privada. Una integración futura necesita un límite de servidor revisado y permisos adecuados. Esta guía no publica una conexión real a un edificio.
Probá los casos incómodos
Comprobá off, on, unknown, unavailable, entidad ausente, texto de estado inesperado y cambio de unidad. Probá modificar solo un atributo mientras el estado principal permanece igual. Mostrá texto además de color para reconocer una lectura no disponible sin depender del tono.
En una escena 3D, asociá habitación o equipo con un ID estable y mové la tarjeta sin desplazar su ancla física. La guía de anotaciones explica esa separación. El render de una casa aporta valor cuando conserva correctamente el significado de sus estados.

