Crie seus primeiros pipelines

Um pipeline é um fluxo que recebe uma entrada, processa e produz uma saída. Em termos de primeiro uso, é como uma imagem de câmera vira evento, notificação, imagem armazenada ou ação no Home Assistant.

No Toposync, pipelines de câmera mapeada podem produzir Spatial Events: eventos que carregam câmera, área, posição, estado do objeto, lifecycle e contexto de imagem, em vez de apenas uma mensagem genérica de detecção.

Esta página é apenas uma primeira passada. A referência completa de pipelines fica em Pipelines.

Comece pela câmera

O primeiro pipeline mais fácil normalmente começa por uma câmera. Telas de câmera podem oferecer presets ou assistentes que geram um pipeline para casos comuns.

Use esses assistentes quando disponíveis. Eles mantêm o primeiro grafo mais simples e reduzem erros de configuração.

Presets de câmera

Presets de câmera são o ponto de partida mais seguro para pipelines de eventos de câmera. Eles também codificam o contrato atual do produto: armazenamento, throttle e notificações downstream devem usar payload.subject.id, não o id bruto do tracker.

Preset	Mapeamento	Use quando
Detecção simples de pessoas	Não exige	Você quer um primeiro teste ou uma câmera ainda sem mapeamento.
Spatial Events individuais de pessoas	Exige	Você quer um evento por pessoa acompanhada, com contexto de câmera, área e posição.
Spatial Events agrupados de presença	Exige	Você quer menos notificações durante uma atividade contínua.
Presença por área	Exige	Você quer pessoas ou pets mapeados e agrupados por proximidade na área da câmera.
Veículo parou	Exige	Você quer detecção de veículos com lógica de velocidade/parada.

Escolha o preset simples enquanto a câmera ainda não estiver calibrada. Escolha um preset mapeado quando precisar de áreas, coordenadas de mundo, presença agrupada mais silenciosa ou regras baseadas em velocidade.

Um primeiro grafo simples

Um primeiro pipeline útil pode ser:

1. Ler uma imagem ou frame de stream da câmera.
2. Detectar movimento ou objetos.
3. Restringir o resultado a uma ou mais áreas.
4. Armazenar uma imagem ou recorte útil.
5. Enviar uma notificação ou expor um resultado.

Não comece com muitos ramos, muitas câmeras ou modelos customizados. Valide um resultado simples primeiro.

Use áreas para reduzir ruído

Áreas são uma das melhores formas de tornar pipelines úteis.

Exemplos:

• pessoa em Calçada pode ser normal;
• pessoa em Quintal pode ser importante;
• veículo em Garagem talvez importe apenas se parou;
• movimento perto de Piscina pode precisar de outra regra.

Se o pipeline estiver ruidoso, melhore as áreas antes de adicionar mais lógica.

Mantenha saídas modestas

Para o primeiro teste, escolha uma saída:

• armazenar uma imagem;
• enviar uma notificação;
• mostrar um evento;
• atualizar uma entidade ou automação do Home Assistant depois.

Evite armazenar imagens demais ou rodar muitos fluxos de alta frequência antes de entender uso de armazenamento e CPU.

Quando usar um processing server

Use a instância principal do Toposync para o primeiro fluxo simples. Considere um processing server depois quando:

• o uso de CPU estiver alto;
• você rodar múltiplas câmeras;
• você adicionar modelos de visão;
• o add-on do Home Assistant estiver rodando em hardware de baixa potência;
• você quiser uma máquina mais forte para lidar com câmera ou IA.

Veja Processing server no Linux e macOS quando estiver pronto.

Próximo: Próximos passos.