Plantas para Home Assistant: um painel visual claro, privado e fácil de manter

Uma planta pode tornar um painel doméstico mais fácil de compreender. Em vez de memorizar a divisão associada a cada nome de dispositivo, encontra um controlo perto do espaço a que pertence. O objetivo é reconhecer e agir com clareza, não admirar um modelo antes de conseguir acender uma luz.

Este guia apresenta um processo baseado numa imagem. 3DHouseMaker não liga diretamente a Home Assistant, não descobre dispositivos e não sincroniza geometria com estados de entidades. Prepara a planta separadamente e configura o painel na sua instalação. Essa distinção evita esperar uma integração que a ferramenta não oferece.

Distinga fundo renderizado e modelo interativo

Uma pesquisa de planta 3D para Home Assistant pode significar imagem renderizada, cena interativa ou painel que se parece com a casa. São projetos diferentes. O cartão picture-elements normal utiliza uma imagem bidimensional com elementos sobrepostos e não uma cena 3D nativa em tempo real.

A documentação de picture-elements explica posicionamento sobre imagens. O exemplo deste guia utiliza chaves documentadas. Soluções de terceiros mais complexas precisam da sua própria avaliação de manutenção e compatibilidade, sem atribuir essas capacidades ao processo básico.

Uma perspetiva pode servir de fundo e continuará a ser uma imagem. Os elementos do painel comunicam informação atual. Mover uma parede na fonte não reposiciona automaticamente controlos nem altera associações a entidades.

Escolha três tarefas para começar

Experimente identificar a luz relevante da sala, consultar temperatura da cozinha e encontrar informação de uma luz do quarto. Mantenha controlos sensíveis e mudanças de automação complexas fora do primeiro ensaio. Um conjunto pequeno permite avaliar compreensão antes de multiplicar elementos.

Registe quem utiliza e onde. Um telemóvel próximo da face e um tablet mural consultado em pé têm condições diferentes. Escolha dados que beneficiam de contexto espacial e deixe outros numa lista ou numa vista de divisão. Não é necessário desenhar todas as entidades sobre a casa.

Se uma divisão tem muitas funções, selecione as úteis para o mapa. A imagem deve ajudar a concluir tarefas, sem obrigar a conhecer cada móvel virtual. A hierarquia de informação importa mais do que a densidade de ícones.

Crie uma cópia simplificada da referência

Parta de uma distribuição cujas posições compreende. Retire cadeias de cotas, títulos e notas técnicas do fundo, conservando a planta medida separadamente. O painel não precisa de revelar dimensões completas de uma habitação privada.

O criador de plantas ajuda numa organização simples. Se existe fonte adequada, o conversor para 3D pode produzir uma aproximação de paredes. Nenhum desses processos cria entidades ou configura o comportamento dos dispositivos.

Mantenha orientação e limites de imagem. Rodar o fundo mais tarde obriga a rever posições. Use nomes familiares ao agregado e não transporte abreviaturas técnicas cujo significado só era claro para quem desenhou.

Compare planta e perspetiva pouco inclinada

A planta oferece espaço visível e posicionamento previsível em todas as divisões. Uma perspetiva suave torna paredes reconhecíveis e pode esconder áreas atrás delas. Compare com as mesmas três tarefas, sem escolher apenas a imagem mais elaborada.

Confira a divisão menor, a cozinha e os percursos estreitos. Se ficam ocultos, perde locais para informação. Uma cobertura reconhecível ou textura rica não acrescenta valor quando retira legibilidade. Comece simples e conserve posições para que atualizar o aspeto não exija reconstruir o painel.

Reserve áreas calmas para controlos

Pavimentos com padrões fortes competem com etiquetas. Retire mobiliário onde existem vários controlos e evite associações visuais ambíguas. Uma luz sobre uma mesa decorativa pode parecer controlar uma luminária de mesa quando corresponde ao teto.

Use nomes inequívocos e contraste no fundo real. O planeador de divisões pode ajudar a escolher peças que explicam o espaço, mas retire as que disputam atenção com informação. Está a preparar um mapa operacional e não uma ilustração imobiliária.

Peça a outra pessoa para dizer que dispositivo espera de cada ícone. Uma interpretação diferente é informação de projeto. Quem conhece a configuração de memória tende a ignorar ambiguidades que surgem imediatamente para outro utilizador.

Calcule coordenadas percentuais

Imagine um fundo com 1.200 píxeis de largura e 800 de altura. Um centro escolhido em x = 300 e y = 240 corresponde a 25 % desde a esquerda e 30 % desde cima: 300 ÷ 1.200 × 100 e 240 ÷ 800 × 100.

O estilo documentado usa posições percentuais e a transformação padrão centra o elemento no ponto. Por isso a conta representa o centro do ícone e não o canto superior esquerdo. Confirme no cartão real: a aritmética não garante, sozinha, uma composição legível.

Guarde uma tabela com divisão, entidade, informação e posição. Se o fundo muda, consegue perceber por que o controlo estava ali. Também ajuda a encontrar um ícone visualmente bem colocado e associado à entidade errada.

Comece com um cartão ilustrativo mínimo

Substitua imagem e entidade por recursos da sua instalação. O nome de exemplo não cria um dispositivo nem obriga a renomear o existente. A configuração mostra um ícone de estado e posição, sem incluir credenciais ou estabelecer uma integração.

type: picture-elements
image: /local/house-dashboard.png
elements:
  - type: state-icon
    entity: light.living_room
    style:
      left: 25%
      top: 30%

Confira a entidade antes de a usar e acrescente um item de cada vez. Assim mantém a causa de um problema identificável. Para ações, consulte documentação atual e decida se tocar deve mostrar informação ou mudar um estado.

Explique o comportamento ao agregado. Uma imagem não diz automaticamente o que acontece depois do toque. Posição, nome e ação devem formar um conjunto compreensível e ser revistos com quem vai utilizar o painel.

Reveja alojamento e privacidade do fundo

A rota /local/ do exemplo tem uma consequência importante. A documentação HTTP de Home Assistant informa que ficheiros servidos da pasta www não estão protegidos pela autenticação do sistema. Quem consegue alcançar e conhece o URL pode aceder ao ficheiro.

Não coloque ali uma planta privada detalhada apenas porque o painel pede autenticação. Prepare imagem sem morada, códigos, alarmes ou outros detalhes sensíveis. Confirme alojamento e acesso remoto efetivo antes de enviar o fundo para a instalação.

Um nome difícil de adivinhar não é controlo de acesso. Se precisa de manter a imagem restrita, utilize um método protegido adequado e verifique o comportamento. Não copie uma configuração alheia supondo que a autenticação do painel cobre todos os recursos.

Proteja configuração e capturas

Não inclua palavras-passe ou tokens em YAML, imagens ou capturas partilhadas. Retire nomes de conta e informação pessoal desnecessária. Uma planta pode revelar acessos e detalhes do agregado que uma lista convencional de luzes não mostra.

A orientação de segurança de Home Assistant recomenda palavras-passe únicas fortes, autenticação multifator e atualizações. Siga documentação suportada para acesso remoto. Para discutir desenho, use uma maqueta anónima com divisões e entidades fictícias.

Separe esse exemplo da configuração real. Quem ajuda com contraste ou posicionamento normalmente não precisa de detalhes completos da propriedade. Partilhar menos informação pode preservar a utilidade da conversa sem expor conteúdo dispensável.

Ensaie primeiro no ecrã menor

Um mapa completo pode funcionar no computador e tornar-se ilegível no telemóvel. Coordenadas percentuais conservam posição relativa, não garantem texto legível ou interação confortável. Tente as três tarefas sem ampliar a imagem.

Procure sobreposições, etiquetas sobre paredes e divisões pequenas demais para reconhecer. Reveja condições de luz e modos de apresentação utilizados. Se o conjunto deixa de funcionar, simplifique a visão geral e prepare vistas por divisão.

Mantenha uma lista convencional como alternativa para quem não interpreta bem o mapa. Uma pessoa deve conseguir utilizar a instalação sem precisar de reconhecer uma perspetiva espacial. A imagem é uma ajuda e não deve ser a única forma compreensível de concluir uma tarefa.

Pense em utilização rápida e distraída

Imagine chegar com sacos e olhar brevemente para o tablet mural. Nomes e orientação familiar devem permitir identificar a divisão. Se é necessário inspecionar um sofá detalhado para perceber o local, simplifique o fundo e dê mais espaço à informação operacional.

Mantenha consistência entre divisões quando faz sentido. Uma localização previsível reduz aprendizagem, enquanto uma distribuição escolhida apenas por espaços vazios pode produzir relações difíceis de memorizar. Confira a compreensão em vez de assumir que simetria visual resolve tudo.

Considere informação ausente e mudanças de entidades

Veja como o painel comunica indisponibilidade, renomeação e remoção. Um brilho pintado permanentemente no fundo não deve sugerir que a luz está ligada agora. O estado atual precisa de vir da entidade, e não de uma decoração estática.

Para ações com consequências relevantes, escolha interação e revisão adequadas. Não amplie um ensaio de planta para alarmes ou portas apenas porque cabe mais um ícone. Capacidade de colocar um elemento não determina utilidade nem adequação dessa ação.

Valide comportamento e interpretação

Peça ao utilizador para explicar o que espera antes de tocar. Compare a resposta com a configuração real. Um controlo corretamente colocado pode continuar ambíguo se nome e ação não correspondem à expectativa. Corrija a relação que falha e repita a tarefa.

Confira compreensão sem depender apenas de cor. O fundo ajuda a localizar, e o controlo deve comunicar o estado claramente. Conserve alternativa simples para situações em que dimensão de ecrã, perceção ou familiaridade com o mapa dificultam utilização.

Não mude nome, posição e conjunto de entidades simultaneamente durante um teste. Alterar uma escolha de cada vez permite reconhecer a melhoria observada, em vez de preferir uma versão apenas pela aparência.

Reveja o recorte antes de reutilizar posições

Uma atualização do fundo pode manter as divisões e alterar a proporção ocupada por cada uma. Se recorta margens ou muda a perspetiva, as posições percentuais anteriores podem deixar de corresponder aos mesmos pontos. Não reutilize a tabela apenas porque o nome do ficheiro continua igual.

Compare a imagem antiga e a nova com os controlos visíveis. Confira cada entidade importante e não só a que serviu de exemplo. Um ícone pode permanecer dentro da casa e passar para outra divisão, criando uma associação plausível mas errada. O controlo deve continuar ligado ao espaço e ao dispositivo pretendidos.

Conserve uma versão simples que funcione

Antes de acrescentar detalhe, guarde o fundo e a configuração que completavam as tarefas iniciais. Essa base permite comparar uma melhoria e recuperar o funcionamento se uma alteração tornar a leitura difícil. Não é necessário guardar apenas a imagem: a relação entre ficheiro, posições e entidades faz parte do estado útil.

Quando pede ajuda, prepare uma cópia de demonstração com nomes fictícios e sem credenciais. Explique a tarefa que falha e o ecrã utilizado, em vez de partilhar toda a instalação. Uma pergunta específica permite rever legibilidade e comportamento sem expor recursos que não são necessários para a discussão.

Confira a nova versão com alguém que utiliza o painel habitualmente. A manutenção está concluída quando a configuração continua compreensível no contexto real, e não apenas quando o fundo atualizado aparece no ecrã.

Guarde fundo e controlos coordenados

Conserve fonte editável, imagem exportada e tabela de posições juntas, com data e resumo. Se divide ou muda nome de uma divisão, reveja etiquetas e entidades, não apenas o desenho. A guia de gestão de plantas explica preservação da base e histórico curto.

Registe ecrãs e tarefas revistos. Um painel eficaz não precisa de se comportar como um jogo: precisa de tornar controlos compreensíveis, preservar informação privada e manter-se simples de atualizar. Comece por poucos elementos e acrescente complexidade quando resolve uma necessidade demonstrada.