Eventos
Introdução
A principal característica do Camlytics Service que o destaca da multidão de sistemas de vigilância por vídeo é sua capacidade de analisar fluxos de câmeras de vídeo em tempo real, gerar diferentes tipos de eventos e enviá-los para o banco de dados na nuvem para armazenamento.
Evento é uma entidade básica que permite ao Camlytics construir seus relatórios de ocupação em tempo real, gráficos, fornecer acesso à API e muito mais.
Todos os eventos são gerados quando objetos rastreados interagem com gatilhos - linha, zona ou cena. Linhas e zonas são configuradas durante a calibração do Camlytics Service. Você pode adicionar várias linhas ou zonas na mesma cena da câmera.
O período padrão (tempo de armazenamento) dos eventos na conta da Nuvem é de 3 meses. Se desejar armazenar eventos por um período mais longo, você precisa comprar as unidades de armazenamento adicional para cada um de seus canais.
Perfil de detecção
O primeiro passo na configuração do Camlytics Service é escolher o perfil de detecção apropriado. O perfil define quais tipos de objetos serão detectados e como a contagem é realizada. Sua escolha impacta diretamente na precisão e relevância dos resultados analíticos.

Perfis recomendados
- Veículos e pessoas com IA – Use isso quando precisar detectar tanto pessoas quanto veículos.
- Pessoas com IA (superior) – Mais adequado para ângulos de câmera superiores (visão de cima para baixo) para contar pessoas.
- Pessoas com IA (inclinado) – Projetado para câmeras montadas em um ângulo, ideal para contagem de pessoas.
- Rostos com IA – Permite a detecção de gênero e idade por meio de análise facial.
Perfis sem IA
Câmera superior / Câmera inclinada (incluindo opções de alta e baixa sensibilidade) – Estes são perfis leves que não usam redes neurais. São adequados para contagem básica de objetos baseada em movimento, mas não classificam objetos. Por exemplo, uma pessoa e um carro serão tratados da mesma forma. Esses perfis são menos intensivos em recursos e ideais quando você precisa apenas de dados gerais de fluxo de objetos, não de classificação detalhada ou análises avançadas.
Se necessário, você também pode desativar completamente a análise para um canal marcando a opção "Eventos do canal desativados". Isso pode ser útil se a câmera for usada apenas para streaming ou gravação, sem análises.
Além disso, você pode ajustar o limiar de detecção (nível de confiança humano). Valores mais altos reduzem falsos positivos, mas podem resultar em detecções perdidas.
Recomendamos testar vários perfis com sua configuração de câmera para encontrar o melhor equilíbrio entre precisão e desempenho.
Calibração (apenas para perfis sem IA)
A calibração é necessária apenas ao usar perfis de detecção sem IA. Esses perfis dependem de rastreamento tradicional baseado em movimento, portanto, uma calibração precisa é essencial para detecção de objetos confiável, contagem e mapas de calor.
Para acessar as configurações de calibração, vá para Calibração no menu do canal.

Na seção de Calibração, você verá uma régua sobreposta em uma captura de vídeo. Esta régua deve ser ajustada para corresponder ao tamanho real de um objeto típico em sua cena. Escolha um objeto de tamanho médio que deseja rastrear (geralmente uma pessoa) e dimensione a régua para ajustá-lo com precisão.
- Para perfis de câmera superior, a régua deve corresponder a uma pessoa vista de cima.
- Se os tamanhos dos objetos variarem significativamente na cena, é melhor calibrar com base no objeto menor.
- A calibração adequada garante que as caixas de rastreamento verdes correspondam de perto ao tamanho dos objetos reais.
Exemplos de boa calibração
- Caixas de rastreamento verdes alinham-se com as dimensões reais do objeto.
- O rastreamento é suave e consistente.

Exemplos de má calibração
- Régua ajustada muito grande ou muito pequena.
- As caixas de rastreamento são muito grandes ou pequenas, levando a resultados ruins e análises instáveis.


Para perfis de câmera inclinada, também é crítico definir o marcador corretamente, pois afeta a compreensão do sistema sobre os tamanhos mínimo e máximo de objetos para detecção.

Uma vez concluída a calibração, você pode prosseguir para definir a Área de Interesse, linhas de detecção e zonas.
Área de Interesse
A Área de Interesse define a região do vídeo onde a análise estará ativa e os objetos serão detectados. Por padrão, ela cobre toda a visão da câmera, mas na maioria dos casos, deve ser reduzida.

- Para perfis de IA (por exemplo, pessoas com IA, veículos e pessoas com IA, rostos com IA), a AOI ajuda a reduzir o ruído visual limitando a detecção às partes relevantes da cena, melhorando a precisão e reduzindo a carga de processamento.
- Para perfis sem IA (por exemplo, câmera superior, câmera inclinada), a AOI é crítica — permite excluir movimentos indesejados, como portas automáticas, elevadores, árvores em movimento ou reflexos. Sem uma AOI configurada corretamente, a detecção e contagem podem ser severamente afetadas por disparos falsos.
Você pode ajustar a área livremente adicionando ou removendo nós via duplo clique na borda da AOI.
Disparadores (Zonas, Linhas e SpeedLines)
Disparadores são elementos essenciais que definem que tipos de movimento e atividade o sistema deve detectar e responder. Eles permitem rastrear o fluxo de objetos, contar eventos, medir a velocidade e gerar respostas automatizadas.
Há três tipos de disparadores:
Linhas

Linhas são usadas para contar objetos que cruzam uma linha virtual no vídeo. Você pode configurar:
- Deteção de um sentido ou de dois sentidos
- Lógica de entrada/saída
- Filtros de tipo de objeto (por exemplo, apenas pessoas ou veículos em perfis de IA)
Linhas são ideais para entradas, portões, corredores ou qualquer monitoramento de fluxo direcional.
Você também pode ativar a detecção de Seguir de Perto ao marcar a opção Seguir de Perto para uma linha. Esse evento é acionado quando dois objetos cruzam a mesma linha dentro de um curto intervalo (tipicamente menos de 1 segundo).
A detecção de Seguir de Perto é especialmente útil para cenários de controle de acesso, como monitorar pontos de entrada de escritório para detectar quando alguém segue outra pessoa por um portão ou porta segura sem autorização adequada. Funciona melhor com câmeras aéreas e perfis de contagem de pessoas.
Zonas
Zonas detectam objetos que entram, se movem ou permanecem em áreas específicas do quadro de vídeo.

Cada zona possui dois eventos embutidos — Zone joined e Motion started
— que estão sempre ativos e não requerem configuração.
Além disso, as zonas suportam dois tipos de eventos opcionais e configuráveis:
Object dwell– acionado quando um objeto permanece dentro da zona por mais tempo do que um tempo de permanência especificado (em segundos)Crowd appear– acionado quando um número mínimo definido de objetos está presente na zona por uma duração definida
Esses disparadores avançados são úteis para detectar permanência, filas, superlotação ou comportamento ocioso incomum em áreas críticas.
SpeedLines
SpeedLines permitem tanto a medição de velocidade quanto a contagem baseada em trajetória.

- Medir a velocidade com que os objetos se movem entre duas linhas
- Definir limites para detectar movimentos excessivamente rápidos ou lentos
- Ideal para monitoramento de tráfego, alertas de excesso de velocidade ou identificação de comportamento anormal de pedestres
Além da análise de velocidade, SpeedLines também podem ser usados para contar objetos que se movem ao longo de caminhos específicos.
Por exemplo:
- Em um cruzamento, você pode contar veículos virando à direita separadamente daqueles que seguem em frente em uma estrada perpendicular
- Útil em análise de tráfego, segmentação de fluxo ou mapeamento de comportamento em ambientes complexos
SpeedLines são poderosos quando você precisa entender a rapidez e a direção em que pessoas ou veículos estão se movendo.
Todos os disparadores podem ser sobrepostos e combinados dentro de uma única cena. Você pode nomeá-los, exportar dados de eventos, conectá-los a APIs ou webhooks, e usá-los para alertas em tempo real ou análises históricas.
Tipos de Eventos
Existem vários tipos de eventos que fazem a multiplicidade de relatórios funcionar. Cada evento único é gerado por um objeto único que possui o ID e detalhes de classificação (Humano/Veículo/etc.).
Você pode encontrar a tabela de tipos de eventos abaixo.
| Nome | Disparador | Descrição | Tem ID de objeto | Classificação de objeto |
|---|---|---|---|---|
| Line crossed | Linha | Acionado quando uma linha é cruzada por um objeto de qualquer tipo. | Sim | Sim |
| Tailgating | Linha | Acionado quando dois objetos cruzam a mesma linha com pequeno atraso (até 1 segundo). Útil para monitoramento de segurança de acesso. Geralmente usado com contagem de pessoas. Leia mais em nossos casos de uso. | Sim | Sim |
| Zone joined | Zona | Acionado quando um objeto entra na zona. | Sim | Sim |
| Motion started | Zona | Indica o início de movimento em uma zona. Acionado pelo objeto que entra na zona.
Se o objeto acabou de aparecer, os eventos Zone joined e Motion started acontecerão simultaneamente. |
Sim | Sim |
| Object dwell | Zona | Acionado quando um objeto que esteve em uma zona por tempo suficiente (configurável durante a calibração). | Sim | Sim |
| Crowd appear | Zona | Acionado quando objetos suficientes estiveram em uma zona por tempo suficiente (configurável durante a calibração). | Não | Não |
| Camera obstructed | Cena | Indica que a câmera foi obstruída parcialmente ou completamente por luz, objeto grande, etc. ou a câmera foi deslocada. Analógico ao evento "Sabotagem". | Não | Não |
Página de eventos
Eventos página permite visualizar todos os eventos armazenados em sua conta na Nuvem. Você pode filtrar por localização, canal, nome do gatilho, horário, tipo, classe (Veículo/Humano/etc.). Quando os eventos filtrados são exibidos, você pode exportá-los para uma planilha .csv.
Você também pode obter um instantâneo de cada um dos eventos. Todos os instantâneos são armazenados em uma máquina local com o Camlytics Service em execução e são obtidos de lá ao clicar no botão "Obter instantâneo".