Cluebase VMS user manual (Portuguese)
Introdução
Cluebase VMS (sistema de gerenciamento de vídeo) é uma solução de software abrangente projetada para conectar câmeras de vigilância por vídeo a uma infraestrutura de servidor. Ele permite uma ampla variedade de recursos, como gravação de vídeo, transmissão ao vivo, análise de vídeo de IA, integração de controle de acesso, conexão com alarmes de incêndio, gerenciamento de dispositivos IoT e muitos outros recursos avançados voltados para as necessidades modernas de segurança e automação. O sistema suporta implantações “no local, híbridas” e “na nuvem”, tornando-o adequado tanto para pequenas instalações quanto para grandes ambientes corporativos distribuídos.
Cluebase VMS foi projetado com flexibilidade e escalabilidade. Opera como uma solução de plataforma aberta, garantindo compatibilidade com uma ampla variedade de hardware e sistemas de terceiros. Quer você implante uma instalação em um único edifício ou gerencie uma rede com vários locais, câmeras e sensores, o Cluebase VMS oferece as ferramentas necessárias para monitoramento confiável, resposta rápida e automação inteligente.
O Cluebase VMS é distribuído como um produto comercial sob um Contrato de Licença de Usuário Final (EULA), que descreve direitos de uso, termos de distribuição e condições de licenciamento.
Cluebase VMS foi projetado como uma plataforma de gerenciamento de vídeo modular e escalonável executada em um ambiente de orquestração Docker Compose. A arquitetura separa as principais funções do sistema em contêineres individuais, permitindo implantação eficiente, atualizações fáceis e independência de plataforma.
Todas as funcionalidades de back-end são contidas e orquestradas usando Docker Compose. Cada componente é isolado para estabilidade, escalabilidade e portabilidade:
Contêiner de backend - Lida com a lógica de API, autenticação e lógica do sistema. Comunica-se com o banco de dados, o frontend e os aplicativos cliente.
Contêiner de banco de dados - Armazena todos os dados de configuração, logs, histórico de eventos, contas de usuário e estados do sistema.
Contêiner de frontend - Fornece a interface de usuário baseada na web.
Contêiner de processamento de IA - Executa tarefas de análise de vídeo, como detecção de objetos, classificação e análise comportamental. Usa aceleração de GPU quando disponível.
Contêiner de servidor RTSP - Atua como servidor de origem RTSP para câmeras retransmitidas.
Servidor de transmissão ao vivo - Lida com fluxos WS, WebRTC ou HLS para visualização em tempo real, visualização multiusuário e compatibilidade móvel.
Portas usadas pelo Cluebase VMS: 80, 554, 2001, 8550-8599, 3000-3999, 443, 20000-40000
Requisitos de hardware e software
Requisitos mínimos de servidor: Quad-core ARM ou Intel/AMD (32 ou 64 bits), 4 GB de RAM, 2 GB de HDD/SSD.
O cliente desktop requer um computador PC ou Mac com Intel/AMD de 32 ou 64 bits, Apple Silicon ou outra CPU ARM com pelo menos 2 núcleos de 1,5 GHz cada.
Navegadores suportados: Google Chrome v.92+, Mozilla Firefox v.90+, Safari v.14+
A calculadora de hardware está disponível para calcular com precisão os recursos necessários para o VMS.
Sistemas operacionais compatíveis:
- Versões desktop e servidor do Ubuntu 18.04 ou posteriores; para uso de GPU, recomendamos Ubuntu 22.04.
- Windows 11 ou posterior com WSL, Windows Server 2016 ou posterior com WSL.
⚠️ Observe que a rede deve ser configurada com um endereço IP estático. Se você alterar o endereço IP, será necessário parar o servidor e executar o script newIP.sh.
Compatibilidade
Codecs: O Cluebase VMS está pronto para funcionar com qualquer stream de vídeo h.264 e h.265.
Todas as câmeras IP e DVR/NVR são suportadas.
Câmeras e NVRs se conectam ao Cluebase VMS usando ONVIF, RTSP ou protocolos nativos.
Instalando o aplicativo cliente
Observe que o aplicativo cliente web fica disponível imediatamente ao acessar o endereço IP do servidor a partir de um navegador web. No entanto, se precisar instalar um aplicativo cliente em seu desktop, você pode baixá-lo em https://vcloud.ai/downloads
Instalando o aplicativo no Linux
Depois de baixar o arquivo Cluebase_VMS_Linux_x_x.deb, você pode instalá-lo pela interface clicando duas vezes e seguindo as instruções na tela ou pela linha de comando:
sudo apt install Cluebase_ VMS_Linux_x_x.deb
Instalando o aplicativo no Windows
Depois de baixar o arquivo Cluebase_VMS_WIN_x_x.exe, você pode instalá-lo a partir da interface clicando duas vezes e seguindo as instruções na tela.
Instalando o aplicativo no macOS
Depois de baixar o arquivo Cluebase_VMS_MacOS_x_x.dmg, você pode instalá-lo pela interface clicando duas vezes e seguindo as instruções na tela.
Entrar
Após executar o aplicativo pela primeira vez, você verá a tela de login.
A página de login fornece acesso seguro à interface do Cluebase VMS. Somente usuários autorizados com credenciais válidas podem fazer login para gerenciar ou monitorar o sistema.
Campos e controles
Usuário - Digite o nome de usuário da sua conta. Usuário administrativo padrão: admin (pode ser alterado posteriormente nas configurações).
Senha - Digite a senha correspondente. Para visualizar a senha enquanto você a digita, clique no ícone de olho próximo ao campo de entrada.
Lembrar-me (caixa de seleção) - Quando ativada, as credenciais da sessão são armazenadas no navegador para mantê-lo conectado entre as visitas. ⚠️ Recomendado apenas em dispositivos privados e confiáveis.
Botão Login - Clique para enviar suas credenciais e acessar o painel do sistema.
Seletor de Idiomas - Localizado no canto superior direito da página; clique no ícone do globo para selecionar o idioma da interface de sua preferência.
⚠️ Dica do administrador: Após a configuração inicial, é altamente recomendável alterar a senha padrão e criar contas de usuário separadas com níveis de acesso apropriados para os membros da equipe.
Digite seu nome de usuário e senha válidos e clique em Entrar. Após a instalação você pode usar credenciais padrão: admin/admin.
Ativação da licença
Para ativar o Cluebase VMS, você deve obter um arquivo de licença válido. As licenças podem ser solicitadas online ou offline, dependendo da conectividade do sistema.
Esta seção explica como solicitar e aplicar uma licença usando a interface integrada.
Vá para Menu Principal -> Configurações -> Licença e preencha o formulário de solicitação de licença VMS.
Campos de solicitação de licença
E-mail do cliente - Por favor insira um endereço de e-mail válido. É usado para identificar a solicitação de licença e receber a chave de licença.
Nome do Cliente - Digite o nome completo da empresa ou pessoa para quem a licença será emitida.
Número de câmeras conectadas ao VMS - Especifique o número total de câmeras a serem usadas com a instância do VMS. A licença estará vinculada a esse valor.
Tipo de licença - Selecione o tipo de licença necessária:
- Permanente - Licença completa sem expiração.
- Temporária - Licença de teste ou demonstração válida apenas por um período limitado.
Opções de solicitação
- Solicitação Online - Envie a solicitação de licença diretamente da interface VMS para o servidor de licença. Requer conectividade com a Internet.
- Solicitação offline - Gera um arquivo de solicitação de licença que pode ser enviado manualmente ao provedor de licença por e-mail ou upload de arquivo; é útil para sistemas isolados ou sem acesso à Internet.
Ativação de uma licença
Se você já recebeu um arquivo de licença:
- Clique no botão … para navegar e selecionar o arquivo .lic.
- Clique em Ativar para aplicar a licença ao sistema.
✅ Após a ativação bem-sucedida, o sistema estará totalmente operacional com base na quantidade de câmeras e recursos incluídos em sua licença. 🔗 A licença está sujeita ao Contrato de Licença de Usuário Final (EULA)
Menu Principal
O Menu Principal oferece acesso rápido a todas as principais funções da plataforma Cluebase VMS. Localizado no lado esquerdo da interface, permite aos operadores alterar e criar layouts, acessar rapidamente todas as câmeras em todos os servidores, gerenciar mapas, visualizar eventos e relatórios, alterar o idioma da interface e acessar as configurações do sistema.
Layouts
Permite que os usuários criem e alternem entre layouts de grade de câmera personalizados para visualização ao vivo. Clicar no menu suspenso exibe os layouts predefinidos disponíveis.
Árvore da Câmera
Mostra todas as câmeras e dispositivos disponíveis organizados por servidor.
Exibe listas de câmeras agrupadas por nome de servidor.
Cada câmera é indicada com um ponto vermelho ou verde (offline/online).
Você pode arrastar câmeras individuais para um layout para acesso imediato.
Ícones de navegação
Mapas - Abre o editor de mapas onde você pode colocar e monitorar imagens de câmeras em uma planta baixa ou mapa do local.
Eventos - Permite acessar o histórico de eventos com filtros e detalhes.
Relatórios - Permite gerar e visualizar relatórios de eventos.
Configurações - Abre opções de configuração de todo o sistema, incluindo configurações de servidor, câmera, usuário e análise de vídeo. Seção do usuário
Nome de usuário (por exemplo, admin) - Indica o usuário conectado no momento. Pode haver permissões diferentes dependendo da função do usuário.
Sair - Efetue logout e retorne à tela de login.
Seletor de idioma - Altera o idioma da interface. Clique no ícone do globo para escolher os idiomas suportados.
Adicionar câmeras
Assista ao vídeo Como adicionar câmeras nos tutoriais Cluebase VMS no YouTube
Ferramenta de pesquisa de câmera
A ferramenta de busca de câmeras está disponível para simplificar e agilizar os processos de descoberta e conexão de câmeras.
Vá para Configurações->Câmeras->Pesquisar
Todas as câmeras compatíveis na rede local serão encontradas automaticamente (normalmente em 5 a 10 segundos).
Depois de especificar as credenciais das câmeras (nome/nome de usuário/senha), você pode adicioná-las uma por uma com o botão '+' no lado esquerdo
Ou você pode clicar em Adicionar todos os dispositivos para adicionar todas as câmeras com as credenciais especificadas.
Clique em Atualizar pesquisa para pesquisar na rede novamente.
Você pode especificar manualmente o intervalo de pesquisa.
Por padrão, o sistema pesquisará a sub-rede atual.
Adicionar câmeras manualmente
Vá para Configurações->Câmeras->Adicionar câmera
Dê um nome à câmera, selecione o tipo de conexão, insira o endereço IP e a porta para ONVIF ou o URL para RTSP, insira o nome de usuário e a senha da câmera, selecione o fuso horário e clique em Adicionar.
Crie um novo layout para as câmeras conforme descrito abaixo.
Adicionar câmeras RTMP
Cluebase VMS permite adicionar câmeras e fontes de vídeo usando o protocolo RTMP. Esta opção é usada quando uma câmera, codificador, DVR/NVR ou servidor de streaming intermediário fornece um stream de vídeo RTMP.
Para adicionar uma câmera RTMP, abra Configurações, vá para Câmeras e clique em Adicionar câmera.
O formulário de configuração da câmera será aberto.
Preencha os seguintes campos:
Nome do dispositivo - insira o nome da câmera a ser exibida na árvore de câmeras e nos layouts.
Tipo de câmera - selecione RTMP na lista suspensa.
URL – insira o URL completo do fluxo RTMP.
Exemplo de URL RTMP:
rtmp://192.168.1.100/live/camera1
Após inserir as informações necessárias, clique em Adicionar.
A câmera aparecerá na árvore de câmeras no servidor selecionado. Se o streaming RTMP estiver disponível e o URL estiver correto, o indicador de status da câmera ficará verde. A câmera pode ser usada em visualização ao vivo, layouts, gravação e outras funções do VMS.
Usando um servidor RTMP intermediário
Um servidor de streaming intermediário só será necessário se a câmera não fornecer diretamente um fluxo RTMP.
Neste caso, a câmera envia seu stream de vídeo para o servidor intermediário e o Cluebase VMS recebe o stream desse servidor como RTMP.
Como servidor intermediário você pode usar simple-rtsp-server / MediaMTX. Ao usar o MediaMTX, certifique-se de que o RTMP esteja habilitado em seu arquivo de configuração YAML. Após habilitar o RTMP, configure a câmera, codificador ou DVR/NVR para enviar o stream ao servidor MediaMTX. Esta opção geralmente está disponível na interface da web da câmera, nas configurações do codificador ou nas configurações de streaming do DVR/NVR.
O fluxo típico é:
Habilite o RTMP na configuração MediaMTX YAML.
Configure a câmera, codificador ou DVR/NVR para publicar o stream no MediaMTX.
Copie o URL RTMP resultante.
No Cluebase VMS, abra Configurações, vá para Câmeras e clique em Adicionar Câmera.
Selecione RTMP como tipo de câmera.
Cole o URL RTMP no campo URL.
Clique em Adicionar.
Notas
Use RTMP somente quando a fonte de vídeo fornecer um fluxo RTMP diretamente ou por meio de um servidor de streaming intermediário.
Se a câmera suportar RTSP, mas não suportar RTMP, ela poderá ser adicionada ao Cluebase VMS como uma câmera RTSP ou transmitida usando um servidor intermediário com RTMP habilitado.
Certifique-se de que o servidor Cluebase VMS tenha acesso de rede à origem RTMP.
Layouts
Assista ao vídeo Como criar um novo layout nos tutoriais do Cluebase VMS no YouTube
Clique em Novo layout no menu principal.
A página de edição de layout será aberta. O menu Layout permite aos usuários criar e personalizar grades de visualização com múltiplas câmeras. Ele oferece uma maneira poderosa e flexível de monitorar vários fluxos de vídeo simultaneamente, adaptar layouts para diferentes monitores e permitir resposta rápida a alarmes por meio de visualizações dedicadas.
Atribua um Nome ao novo layout, escolha um modelo de layout e arraste câmeras ou grupos inteiros para a grade do lado direito.
Painel de configuração do layout (lado esquerdo)
Campo de nome - Insira um nome personalizado para o layout atual (por exemplo, “Visualização de entrada principal” ou “Turno noturno”).
Modelos de Layout - Selecione uma grade predefinida escolhendo uma das opções disponíveis:
1, 4, 9, 16, 25, 36 ou Todas (rolagem 3x3), dependendo de quantas câmeras você deseja ver ao mesmo tempo.
Pesquisa de câmera - Use o campo de entrada para encontrar rapidamente uma câmera por nome ou número entre todos os dispositivos registrados.
Árvore de câmeras - Exibe todas as câmeras disponíveis, organizadas por servidor (por exemplo, Servidor local e Escritório).
As câmeras são rotuladas por nome/número e podem ser arrastadas e soltas em qualquer célula da grade.
Mapas - Se configurado, os mapas podem ser adicionados como um elemento de layout para exibir geoespacialmente as localizações das câmeras.
Janela de alarme - Bloco de vídeo especial que muda automaticamente para exibir a transmissão ao vivo da câmera que acionou o evento ou alarme mais recente.
Configurações do mural de vídeos
Exibe o layout da tela atualmente selecionado (por exemplo, Tela 1).
Cada quadrado vazio é um slot onde uma câmera pode ser colocada.
As câmeras podem ser arrastadas do painel esquerdo para qualquer célula da grade. Use o botão + na parte superior para adicionar telas adicionais ao espaço de trabalho (por exemplo, para configurações de vários monitores).
Clique em Salvar para salvar o layout.
Para editar layouts existentes, clique no botão de lápis no menu de abas de layout na parte superior da tela.
Quando o layout está aberto na tela, você pode arrastar e soltar as janelas de vídeo e as guias de layout para reordená-las. As alterações são salvas automaticamente.
Zoom digital
O recurso de zoom digital permite aumentar e diminuir o zoom de qualquer câmera no modo ao vivo e de arquivo, rolando a roda do mouse ou selecionando uma área específica com o botão direito do mouse.
Para selecionar a área de interesse, mantenha pressionado o botão direito do mouse, mova o mouse para selecionar a área (um retângulo verde hachurado aparecerá) e solte o botão direito do mouse.
A área de interesse se expandirá.
Zoom panorâmico e inclinação (PTZ)
O menu de controle PTZ (Pan-Tilt-Zoom) fornece controle intuitivo em tempo real para câmeras compatíveis com PTZ. Ele permite que os operadores movam a câmera manual ou automaticamente para as visualizações desejadas, aumentem ou diminuam o zoom e ativem posições predefinidas ou sequências de patrulha.
⚠️ Obs: A opção PTZ deve estar habilitada no menu de configurações de cada câmera (Menu Principal -> Configurações -> Câmeras) apenas para câmeras PTZ e câmeras com zoom motorizado.
Controle PTZ manual
Controle direcional - Use o controle central para mover a câmera:
Cima / Baixo / Esquerda / Direita - Incline ou gire a câmera na direção selecionada. As teclas de seta do teclado físico também funcionam para essa finalidade.
Centro do Círculo - Interrompe o movimento quando clicado (se aplicável).
Controle deslizante de zoom
+ para aumentar o zoom. A tecla ‘+’ do teclado físico também funciona.
- para diminuir o zoom. A tecla '-' do teclado físico também funciona.
Arraste o controle deslizante para ajustar suavemente o nível de zoom.
Predefinições PTZ
Botões numerados (1-9) - Pressione um número para mover a câmera para uma posição predefinida salva anteriormente. As teclas 1 a 9 do teclado físico também funcionam.
Salvar - Escolha um número (1-9), após definir a posição da câmera, e então pressione Salvar para salvar a posição PTZ atual como predefinida.
Excluir - Exclui a posição predefinida selecionada e a disponibiliza para configuração novamente.
Modo patrulha
Botão Patrulha - Ativa o modo de patrulha automática, que percorre todas as predefinições salvas em ordem numérica.
Atraso (segundos) - Define o tempo de espera entre cada posição predefinida durante o modo patrulha.
Exemplo: 10s significa que a câmera permanecerá em cada predefinição por 10 segundos antes de passar para a próxima.
Comandos do teclado físico
O Cluebase VMS oferece suporte a comandos de teclado físico para operação mais rápida em visualização ao vivo, layouts, controle PTZ e modo de arquivo. Esses atalhos são úteis para operadores que precisam navegar entre câmeras, controlar janelas de vídeo, alterar layouts ou trabalhar com reprodução de arquivos sem usar o mouse.
Navegação geral pelo teclado: Setas - Move a seleção entre câmeras no layout atual. A câmera selecionada é destacada com uma moldura azul.
Enter - Amplia a janela do vídeo selecionado. Pressione novamente ou use os controles da interface para retornar à visualização do layout.
A - Muda a câmera selecionada para o modo de arquivo.
Shift + Seta para a Esquerda / Shift + Seta para a Direita - Muda para o layout anterior ou seguinte.
M - Abre ou fecha o menu principal.
E - Abre ou fecha o painel de eventos.
Controle PTZ com teclado:
Quando a janela de controle PTZ estiver aberta, o teclado poderá ser usado para controlar a câmera PTZ selecionada.
Setas Mova a câmera PTZ para cima, para baixo, para a esquerda ou para a direita.
+ / - Aumenta ou diminui o zoom.
Teclas numéricas 1-9 Mova a câmera para a posição predefinida PTZ correspondente.
Controle do modo de arquivo com teclado:
Quando a câmera selecionada está aberta em modo arquivo, os seguintes comandos estão disponíveis:
Seta para a esquerda / Seta para a direita Retroceder ou avançar entre os segmentos do arquivo.
+ / - Aumenta ou diminui a velocidade de reprodução.
Shift + '+' / Shift + '-' Aumenta ou diminui o zoom na linha do tempo do arquivo.
T - Abre o painel de navegação do timestamp. O cursor é colocado automaticamente no campo de hora, para que o operador possa inserir imediatamente a hora desejada. Pressione Enter para ir para o carimbo de data/hora selecionado.
Funcionalidade multi-servidor
Cluebase VMS permite criar sistemas multiservidor para:
- Gerencie todos os servidores e câmeras de um único cliente.
- Crie layouts unificados contendo câmeras de vários servidores.
- Receba alarmes de vários servidores em um único cliente.
Vá para: Menu Principal -> Configurações-> Câmeras -> Vincular servidor
Preencha os campos de acesso ao servidor e clique em Vincular.
Configurações de armazenamento
Configurações gerais de armazenamento
Para acessar as configurações de armazenamento, vá em: Menu Principal -> Configurações-> Armazenamento
Para ativar um volume de armazenamento para gravação, selecione o volume de armazenamento e ative-o:
Em seguida selecione as câmeras que precisam ser gravadas, defina a profundidade do arquivo, selecione a qualidade e clique em Salvar. O armazenamento será ativado para gravação imediatamente.
Por padrão, o VMS deve identificar todas as unidades montadas no sistema.
Para usar múltiplas unidades de armazenamento, você deve montar os discos no sistema operacional e reiniciar o VMS.
O sistema de arquivos das unidades deve ser EXT4.
Timelapse
O modo de gravação Timelapse permite que o Cluebase VMS grave câmeras selecionadas com uma taxa de quadros reduzida em vez de gravação contínua em tempo integral. Isso é útil para cenários de monitoramento de longo prazo em que você precisa reter o histórico visual por longos períodos e, ao mesmo tempo, reduzir o consumo de armazenamento.
Para configurar a gravação Timelapse:
- Vá para Menu Principal → Configurações → Armazenamento.
- Selecione o volume de armazenamento onde o arquivo da câmera será gravado.
- Certifique-se de que o volume de armazenamento selecionado esteja Ativado.
- Na lista de câmeras, encontre a câmera que precisa ser gravada no modo Timelapse.
- Na coluna Lógica de Gravação, abra o menu suspenso da câmera necessária.
- Selecione Timelapse.
- No campo Timelapse Rate (min), especifique com que frequência o Cluebase VMS deve salvar um quadro no arquivo. O valor pode ser definido de 1 a 1440 minutos. Exemplo:
- 1 - um quadro é salvo a cada minuto.
- 60 - um quadro é salvo a cada hora.
- 1440 - um quadro é salvo uma vez por dia.
- Defina a Profundidade do arquivo (dias) necessária para a câmera.
- Clique em Salvar para aplicar as configurações de armazenamento e gravação.
Após salvar as configurações, o Cluebase VMS começará a gravar a câmera selecionada de acordo com a frequência de lapso de tempo especificada.
Nota: A frequência do lapso de tempo é definida em minutos e se aplica a câmeras com Timelapse selecionado como lógica de gravação.
NAS (Network Attached Storage) e configuração de armazenamento iSCSI
Para usar o armazenamento NAS no Cluebase VMS, você deve montar o drive NAS no sistema operacional. Então, dentro de aproximadamente 2 minutos, o Cluebase VMS conectará automaticamente a unidade NAS montada.
Estes são alguns pontos importantes a serem considerados:
O sistema não fornece uma interface para conectar o armazenamento ao servidor; você deve fazer isso manualmente. Os artigos a seguir podem ajudá-lo a seguir o procedimento:
- https://ubuntu.com/server/docs/service-iscsi
- https://www.seagate.com/gb/en/manuals/lyve-mobile-rackmount-receiver/iscsi-network-setup-linux-ubuntu-debian/
Depois que o armazenamento for adicionado ao servidor com o utilitário "open-iscsi", não será necessário reiniciar o VMS. O servidor verifica periodicamente o armazenamento disponível (a cada 4 minutos) e, quando detecta armazenamento NAS que ainda não foi utilizado, monta-o automaticamente e adiciona-o ao sistema.
Durante esta verificação, o servidor também verifica se o armazenamento ainda está conectado ou se o sistema de arquivos foi convertido para o modo somente leitura (isso pode ocorrer se a conexão iSCSI for interrompida por algum tempo). De modo geral, o sistema verifica tudo para manter o status do disco atualizado e gerenciar todos os processos relacionados, como montagem, remontagem e gravação de arquivos.
O mesmo armazenamento NAS também pode ser configurado em servidores de failover para que o arquivo gravado no servidor primário esteja disponível no servidor de failover.
Configuração de tempo
O horário preciso do servidor é essencial para o registro confiável de eventos, registros de data e hora de vídeo e sincronização entre sistemas. Esta seção permite configurar a hora do servidor VMS manualmente ou automaticamente usando NTP. Vá para Menu Principal->Configurações->Configurações Gerais->Configurações de Tempo:
Defina a hora do servidor manualmente
Use os campos de hora, minuto e segundo para definir manualmente o relógio do sistema.
Este método é útil se a sincronização NTP estiver desabilitada ou indisponível.
Selecionar fuso horário
Escolha seu fuso horário local na lista suspensa.
O formato é Região/Cidade (deslocamento GMT).
Sincronização NTP Chave liga/desliga - Habilite esta opção para sincronizar automaticamente a hora do servidor usando um servidor NTP (Network Time Protocol). Isso ajuda a manter o tempo consistente e preciso por longos períodos.
URL do servidor NTP – Especifique o servidor NTP com o qual sincronizar. Padrão: ntp.ubuntu.com. Você pode alterá-lo para qualquer servidor de horário preferencial (por exemplo, pool.ntp.org ou um servidor NTP local).
Gerenciamento de acesso do usuário
Gerenciamento de funções Vá para Configurações-> Usuários-> Adicionar função
Dê um nome à função e conceda acesso a câmeras e recursos específicos. Clique em salvar.
Observe que todos os usuários com esta função terão acesso às câmeras e recursos especificados.
Gerenciamento de usuários Vá para Configurações-> Usuários-> Adicionar novo usuário
Especifique as credenciais do novo usuário: nome de usuário, senha e a função necessária. O acesso concedido à Função selecionada é indicado abaixo, mas não está disponível para edição. Para editar as permissões você deve editar a Função clicando no botão de lápis.
Gestão da Organização
Por padrão, todas as funções e usuários são adicionados à organização raiz. Se você precisar de uma camada adicional de acesso de usuário para multilocação, crie mais organizações e crie funções e usuários dentro delas.
Mapas e plantas baixas
O menu Mapas permite visualizar e monitorar localizações de câmeras tanto em mapas interativos quanto em plantas baixas, tornando-o ideal para reconhecimento espacial em tempo real, visão geral do local e resposta de segurança coordenada.
Para localizar uma câmera, sensor de alarme ou porta em um mapa ou planta baixa, você pode configurá-lo no menu Mapas. Vá para Menu Principal->Mapas e clique em “+” adicionar para criar um item de layout de mapa. Siga as instruções na tela inicial para criar um mapa. Clique com o botão direito em qualquer local do mapa para colocar uma câmera, sensor de alarme ou porta. Adicione o mapa ao Layouts para mantê-lo visível ao trabalhar com câmeras.
O editor de planta baixa permite colocar e vincular câmeras, sensores e portas diretamente nos diagramas arquitetônicos do local. Isso fornece uma visão geral visual dos componentes do sistema e permite que os operadores identifiquem, monitorem e reajam rapidamente a eventos espacialmente.
Painel de configuração do sensor
Ao clicar no ícone de um sensor, o seguinte painel de configurações é exibido:
Sensor ID - Identificador exclusivo do sensor. É usado para referência interna e integração.
Emparelhar com câmera - Use o menu suspenso para emparelhar o sensor com uma câmera específica. Quando o sensor for ativado, a câmera vinculada será exibida automaticamente.
Pisca em vermelho quando ativado - Quando ativado, o ícone do sensor no mapa piscará em vermelho em tempo real quando ativado.
Editar localização - Permite reposicionar o ícone do sensor no mapa sem excluí-lo.
Remover sensor do mapa - Remove o ícone do sensor da planta baixa.
Botão Salvar - Confirma e aplica as alterações ao sensor selecionado. Piso 1 / Piso 2 - Permite navegar entre vários pisos ou níveis da instalação. Cada guia representa uma camada separada da planta onde diferentes dispositivos podem ser colocados.
Mapas geográficos offline
O Cluebase VMS pode usar mapas geográficos offline em instalações onde o servidor ou a estação de trabalho do operador tem acesso limitado ou nenhum acesso à Internet. Os mapas offline são criados como um tipo de mapa separado, e as regiões geográficas necessárias devem ser baixadas antes do uso.
Para criar um mapa offline:
- Abra Menu Principal -> Mapas e clique em + para adicionar um novo mapa.
- Insira o título do mapa.
- No campo Tipo de mapa, selecione Mapa global offline.
- Clique em Criar.
Depois que o mapa offline for criado, abra a janela de download de regiões usando o botão de regiões/download no canto inferior direito do editor de mapas.
Na janela Regiões, expanda o continente, país ou área necessária. A lista mostra as regiões disponíveis e o tamanho aproximado de download de cada uma.
Para baixar uma região, clique no botão de download ao lado do nome dela. Repita essa ação para cada região que deve estar disponível offline.
Depois que as regiões necessárias forem baixadas, o mapa offline poderá ser usado da mesma forma que outros mapas. Os operadores podem ampliar e mover-se pela área baixada, desenhar polígonos e posicionar câmeras, sensores ou portas no mapa.
Grupos de câmeras
Vá para Configurações->Câmeras->Adicionar Grupo e preencha o campo do nome do grupo. Em seguida, clique em “Adicionar”.
Para editar um grupo, clique no ícone de 'lápis' no lado direito do grupo.
Agora você pode editar ou excluir o grupo.
Para adicionar uma câmera a um grupo específico, acesse as configurações da câmera e selecione o grupo desejado.
💡 Também é possível arrastar e soltar câmeras dentro de grupos com o mouse.
Configurações de streaming de vídeo
O sistema permite que você gerencie streams de vídeo em Configurações -> Configurações Gerais -> Configurações de Streaming de Vídeo:
Este menu inclui controles que permitem configurar como as informações de vídeo são tratadas para visualização e arquivamento ao vivo. Ajuste essas opções para equilibrar o desempenho e a qualidade do vídeo com base nos recursos do sistema e no caso de uso.
Tamanho do pedaço de transmissão ao vivo (segundos) - WS Define o comprimento do pedaço (em segundos) usado para streaming de vídeo ao vivo via WebSocket. Valores menores reduzem a latência, mas podem aumentar a carga da CPU/rede.
Tamanho do fragmento do arquivo (segundos) Define a duração dos fragmentos de vídeo armazenados no arquivo. Pedaços mais longos reduzem o número de arquivos e podem otimizar o armazenamento, mas podem aumentar o tempo de acesso ao revisar arquivos.
Rip fluxos SD e HD simultaneamente Quando ativado, o sistema extrai fluxos de definição padrão e de alta definição ao mesmo tempo. Isto pode melhorar a velocidade de mudança de transmissão, mas pode aumentar significativamente a carga da CPU. Padrão: Desabilitado.
Verificar fluxo ao adicionar nova câmera Quando ativado, o sistema verifica automaticamente o fluxo de vídeo ao adicionar uma nova câmera. Isso ajuda a garantir que a câmera esteja conectada e transmitindo corretamente antes de adicioná-la ao sistema. Padrão: Habilitado.
Análise de vídeo
Informações gerais
O Cluebase VMS oferece suporte robusto para uma variedade de tecnologias de análise de vídeo, com flexibilidade para diferentes cenários de implantação e requisitos do usuário. O sistema suporta seis tipos de análise de vídeo, cada um projetado para necessidades específicas:
- Análise de vídeo integrada Inclui detectores padrão como:
- Detecção de movimento
- Detecção de violação de câmera
- Detecção de objetos
- Detecção humana
- Detecção de veículos
- Contagem de pessoas
- Contagem de veículos
- Reconhecimento facial Lite
- Detecção de fumaça e incêndio
- Detecção de EPI (Equipamento de Proteção Individual)
- Detecção de estacionamento inadequada
- Detecção de resíduos
- Outros modelos de IA adicionais incluídos no software
- Análise de vídeo YOLO personalizada Integre seus próprios modelos treinados de forma personalizada usando a arquitetura YOLO (You Only Look Once) para detecção de objetos adaptada a casos de uso específicos.
- Visual Assistant - análise baseada em LLM Módulo avançado baseado em grandes modelos de linguagem (LLM) para fluxos de análise de vídeo personalizáveis usando lógica em linguagem natural.
- Módulos de análise de vídeo de terceiros O VMS pode ser integrado a provedores de análise de terceiros, permitindo suporte flexível para diversas soluções específicas do setor.
Análise de vídeo com IA
O Cluebase VMS inclui uma ampla variedade de análises de vídeo integradas.
Clique no botão 
na parte inferior da janela de vídeo para abrir as configurações de análise de vídeo da câmera atual.
No menu , escolha o detector de análise de vídeo desejado, habilite-o, configure-o e clique em 
para aplicar as configurações.
Quando necessário, habilite a opção Visualizar Zona nas configurações do detector para utilizar a zona de detecção (máscara).
Análise de vídeo YOLO personalizada
Cluebase VMS suporta a integração de modelos YOLO treinados e personalizados para soluções personalizadas de análise de vídeo. Esse recurso é ideal para usuários que precisam detectar objetos ou comportamentos muito específicos não cobertos pelos detectores padrão.
⚠️ Nota: Assim como os plug-ins de IA, esse recurso requer a instalação do contêiner ai. Se o contêiner não for instalado durante a configuração, o sistema não será capaz de executar modelos YOLO personalizados e retornará o erro: “Analytics server is unavailable.”
Principais capacidades:
- Os utilizadores podem carregar e executar os seus próprios modelos YOLO no formato .pt (PyTorch).
- Os modelos podem ser treinados com conjuntos de imagens personalizados, por exemplo, usando plataformas como Roboflow, que simplificam a preparação, rotulagem e treinamento de conjuntos de dados.
- Uma vez implementados, esses modelos podem ser aplicados às imagens da câmera usando o menu AI na interface Cluebase VMS.
Esse recurso permite que as organizações implementem casos de detecção altamente especializados, como a identificação de equipamentos, comportamentos ou eventos específicos do setor exclusivos.
Para usar um modelo YOLO treinado pelo usuário (por exemplo, criado com Roboflow) para detecção de objetos personalizados, siga estas etapas na interface Cluebase VMS:
- Vá para Menu Principal -> Configurações -> Análise -> Modelo de IA Personalizado (YOLO)
- Selecione “Novo Modelo” No campo suspenso Modelo, escolha “Novo Modelo” para indicar que você está adicionando um novo ao sistema, ou selecione um modelo existente.
- Digite um nome No campo Nome do modelo, atribua um nome descritivo. Exemplo: Modelo de detecção de drone.
- Carregue o arquivo do modelo Clique no botão “…” ao lado do campo Arquivo do modelo para procurar e carregar seu arquivo de modelo YOLO .pt. Exemplo: drone-detection.pt ⚠️ Certifique-se de que o modelo esteja no formato .pt e tenha sido treinado corretamente usando plataformas como Roboflow ou outras ferramentas compatíveis com YOLO.
- Clique em “Adicionar” Assim que o arquivo e o nome do modelo estiverem preenchidos, clique no botão “Adicionar” no canto inferior direito para salvar e carregar o modelo.
Depois de adicionado, o modelo YOLO personalizado será listado no menu na janela de vídeo do layout e poderá ser configurado e usado exatamente como as análises integradas.
Assistente Visual
O recurso Visual Assistant introduz uma abordagem inovadora para análise de vídeo, permitindo aos usuários definir a lógica de detecção usando linguagem natural. Desenvolvido por grandes modelos de linguagem (LLM), este módulo facilita a criação de cenários de detecção personalizados sem programação ou treinamento de modelo.
O Visual Assistant permite criar regras de detecção poderosas e sensíveis ao contexto simplesmente descrevendo-as em texto simples. Por exemplo: “Answer only 'yes' when you detect a fight”
O sistema interpreta a regra, aplica-a ao stream de vídeo e começa a detectar de acordo.
Instalação
Para ativar o Assistente Visual:
- Vá para Menu Principal → Configurações → Análise → Assistente Visual
- Clique no botão Instalar
⚠️ Requisitos do sistema: Este recurso requer uma GPU com suporte CUDA. Verifique a lista de GPUs suportadas aqui: Lista de GPUs compatíveis
Se o seu sistema não tiver uma GPU compatível, a instalação não continuará e a funcionalidade do Visual Assistant não estará disponível.
Criando uma nova regra de detecção no Visual Assistant
A interface do Visual Assistant permite definir uma regra de análise de vídeo personalizada usando instruções em linguagem natural. Siga estas etapas para adicionar uma nova regra:
1. Iniciar uma nova regra
No campo “Regra de detecção”, digite o nome da nova regra.
Exemplo: Detecção de Luta
2. Selecione a regra de detecção
No menu suspenso “Selecionar regra de detecção”, escolha “Nova regra” se esta for a primeira vez que você a está criando.
Depois de salvo, ele aparecerá aqui para reutilização ou modificação.
3. Escreva o prompt
No campo Prompt, descreva em linguagem simples o que a IA deve detectar.
Exemplo:
say only 'yes' if you see a real fight 💡 A IA avaliará cada quadro com base nesta instrução e retornará uma resposta simples como “yes”, “no” ou uma contagem.
4. Defina a lógica
- Use o menu suspenso Lógica para definir como o sistema deve reagir à resposta da IA:
- Alarme se a resposta for "yes" - ativa um alerta quando o modelo responder “yes”.
- Alarme se a resposta for "no" - ativa um alerta quando a resposta for “no”.
- Contagem - retorna uma contagem numérica em vez de disparar um alarme.
5. Teste a regra (opcional)
- Carregue uma imagem de amostra (JPG ou PNG) em Experimentar uma imagem para verificar como o prompt funciona antes de salvar.
- Clique em Executar para executar o prompt na imagem.
Exemplo: Esta captura de tela mostra como um usuário configurou uma regra de detecção personalizada com o módulo Visual Assistant para detectar lutas em um stream de vídeo usando lógica de IA de linguagem natural.
Detalhamento da configuração:
Nome da regra de detecção: Detecção de luta - Este é o nome personalizado atribuído à regra para identificá-la facilmente. Prompt: say only 'yes' if you see a real fight - Esta é a instrução de linguagem natural dada ao Visual Assistant. Diz à IA para analisar a entrada e retornar “yes” somente se uma luta real for observada.
Lógica: Alarm if answer is 'yes' - Esta opção define o que acontece com base na resposta da IA. Se a IA retornar “yes”, o sistema ativará um alarme.
Imagem de teste: O usuário enviou uma foto mostrando uma cena caótica com várias pessoas e uma pessoa no chão, o que pode indicar uma briga. Esta imagem é usada para testar a regra antes de implementá-la em vídeo ao vivo.
Resultado do teste (à direita): O sistema executou o prompt e retornou:
➜ “Yes” - significa que a IA detectou o que interpretou como uma luta real e, com base na lógica definida, isso acionaria um alerta no VMS.
Resultado final:
- O usuário validou que a lógica de detecção funciona corretamente com uma imagem de teste.
- Quando estiver satisfeito, o usuário pode clicar em Salvar regra para aplicar esta lógica às transmissões de vídeo ao vivo.
6. Salve a regra
Quando estiver satisfeito com as configurações, clique em “Salvar regra” para aplicá-la. Depois de salvo, o detector personalizado será listado no menu na janela de vídeo do layout e poderá ser configurado e usado exatamente como a análise integrada.
Listas de reconhecimento facial
Para usar listas de reconhecimento facial, vá ao Menu Principal -> Configurações -> Análise -> Listas de reconhecimento facial.
O menu de listas de reconhecimento facial permite criar, editar e excluir listas de rostos para os detectores de reconhecimento facial integrados e VCA; Também permite adicionar e remover rostos de listas.
Listas LPR (listas de reconhecimento de placas de veículos)
Para usar listas LPR, vá para Menu Principal -> Configurações -> Análise -> Listas LPR *disponível apenas se o Servidor VCA estiver configurado.
Utilize este menu para criar, editar e excluir listas LPR para o detector VCA LPR; também para adicionar e excluir números de placas de veículos nas listas.
Painel de alarme
O Painel de Alarmes fornece uma visão centralizada de todos os eventos detectados pelo sistema, como detecções de objetos, alertas de movimento e eventos acionados por câmera. Os usuários podem filtrar, revisar e exportar dados de eventos com contexto visual, tornando-os ideais para monitoramento em tempo real e análise pós-incidente.
Para visualizar análises de vídeo e eventos do sistema em tempo real, abra o Painel de alarmes clicando no botão da campainha no canto superior direito do layout.
Filtros e pesquisa
Use a seção superior para filtrar e pesquisar entre eventos:
Menu suspenso Tipo de Evento: Filtre eventos por tipo (por exemplo, Detecção de Objeto, Movimento, Intrusão).
Menu suspenso Subtipo: Refina ainda mais a categoria do evento (por exemplo, Pessoa, Veículo).
Seleção de Câmera: Filtra eventos com base em uma ou mais câmeras específicas.
Intervalo de data e hora: Define uma janela de tempo para restringir a pesquisa usando os campos De e Para.
Reset: Limpa todos os filtros e restaura toda a lista de eventos. Baixar relatório Baixar relatório Exporta a lista de eventos filtrados no formato escolhido. Formatos suportados: PDF (padrão).
Resultados por página Ajusta o número de eventos exibidos ou incluídos no relatório (o padrão é 50).
Salvar alterações Aplica os novos filtros ou configurações selecionadas acima.
Cada entrada na lista inclui:
Miniatura da captura Visualização da imagem do momento em que o evento ocorreu.
Tipo de Evento (por exemplo, Detecção de Objeto)
Nome da câmera Indica qual câmera acionou o evento.
Tipo de Objeto Classifica o objeto detectado (por exemplo, Pessoa, Veículo).
Nível de confiança Mostra o percentual de certeza da IA na detecção.
Carimbo de data/hora Indica quando o evento foi registrado.
Botões de ação do evento (lado direito de cada evento)
Comentários - Abre uma caixa de comentários onde os operadores podem anotar o evento para referência interna ou entrega de turno.
Baixar captura do evento - Baixa imediatamente o quadro de imagem associado à detecção do evento.
Baixar videoclipe do evento - Baixe instantaneamente um pequeno videoclipe do momento do evento, útil para revisão de incidentes ou arquivamento de evidências.
Clique duas vezes no botão da campainha para ajustar o volume do som da notificação.
Exportar e importar configuração VMS
Esta seção permite que você exportar, importar e redefinir configurações do sistema, bem como opcionalmente enviar backups de configuração para Telegram em intervalos regulares: Menu Principal->Configurações->Configurações Gerais->Configurações:
Salvar e carregar configuração
Clique no botão Salvar para exportar as configurações atuais para um arquivo. Isso é útil para backups ou transferência de configurações para outro sistema.
Carregar arquivo de configuração – Clique no botão… para selecionar um arquivo de configuração salvo anteriormente em seu dispositivo e pressione Carregar para importá-lo para o sistema.
Redefinir para padrões - Restaura o sistema às configurações originais de fábrica.
⚠️ Aviso: esta ação excluirá todas as configurações personalizadas e não poderá ser desfeita.
Enviar configuração para Telegram
Este recurso permite que você envie automaticamente backups de configuração para um bate-papo designado do Telegram usando um bot.
Habilitar/Desabilitar - Use estes botões para ativar ou desativar o envio automático para o Telegram.
Token do Telegram Bot – Insira o token API do seu bot do Telegram. Este bot deve ser criado previamente usando @BotFather no Telegram.
Telegram Chat ID – Especifique o ID do chat para o qual o arquivo de configuração será enviado. Pode ser um chat pessoal ou um grupo onde o bot é adicionado como membro.
Intervalo entre envios de configuração (minutos) - Define com que frequência o arquivo de configuração será enviado ao Telegram.
Notificações
Esta seção permite configurar como o sistema envia alertas e notificações em resposta a vários eventos ou estados do sistema, como alarmes de análise de vídeo e desconexões de câmeras. Você pode enviar alertas por e-mail, Telegram ou para um painel de alarme externo, e também automatizar respostas personalizadas usando cenários predefinidos. Vá para Menu Principal->Configurações->Notificações:
Enviar eventos por email
+ Adicionar e-mail - Clique neste link para adicionar um ou mais endereços de e-mail para onde as notificações de eventos serão enviadas. O sistema notificará esses endereços com base nos gatilhos selecionados.
Enviar eventos para Telegram
Ativar/Desativar - Ativa ou desativa notificações de eventos pelo Telegram.
Telegram Bot Token - Insira o token API do seu bot Telegram aqui. Você deve primeiro criar o bot usando @BotFather.
Telegram Chat ID - Especifique o ID do chat para onde as notificações de eventos serão enviadas. Pode ser um chat individual ou em grupo onde o bot está presente.
Enviar notificações quando a conexão da câmera for perdida
Selecione como deseja receber notificações se uma câmera ficar off-line:
E-mail - Envia um alerta por e-mail.
Telegram - Envie uma mensagem usando o Telegram.
Painel de alarme - Envia um sinal para o painel de alarme.
Cenários de automação
Este recurso permite automatizar respostas a determinados eventos de câmeras selecionadas.
Método - Escolha entre métodos HTTP como GET ou POST para definir como o sistema externo será contatado.
URL - Especifique o endpoint que será ativado quando as condições do cenário forem atendidas (por exemplo, http://admin:admin@192.168.1.1/...).
Câmeras - Selecione uma ou mais câmeras que irão acionar esta automação.
Eventos - Escolha quais eventos (por exemplo, detecção de movimento, desconexão) irão acionar o cenário.
Incluir informações do evento - Habilite esta opção se desejar enviar dados detalhados do evento em um arquivo JSON.
Excluir - Clique para remover um cenário.
+ Adicionar cenário - Adiciona um novo cenário de automação com parâmetros personalizados.
Programação
Atribua um horário específico pré-criado às suas regras de automação ou notificação para receber notificações apenas durante horários programados.
Automação
O módulo Automação no Cluebase VMS permite criar fluxos visuais que conectam câmeras, detectores, ações do usuário, programações e chamadas externas de API. As automações podem ser usadas para acionar ações automaticamente quando ocorre um evento específico, como abrir uma porta quando um rosto é reconhecido.
Abra o editor de Automação
Para abrir o módulo Automação, selecione Automação no Menu Principal -> Configurações -> Automação.
O espaço de trabalho Automação contém:
- Um painel esquerdo com cenários disponíveis
- Um campo de busca para encontrar cenários rapidamente
- Um editor visual de fluxo de trabalho
- Um interruptor Ativado / Desativado para ativar ou desativar o cenário selecionado
- Um botão Adicionar bloco para adicionar novos elementos ao fluxo
- Um botão Salvar para salvar as alterações
Crie um novo cenário de automação
Para criar um novo cenário de automação:
- No painel esquerdo, clique no botão +.
- Digite o nome da automação.
- Clique em Criar.
O novo cenário aparecerá na lista de cenários no lado esquerdo da tela.
Adicionar blocos ao fluxo de trabalho
Os cenários de automação são criados com blocos. Cada bloco representa um objeto, evento, condição ou ação dentro do fluxo.
Para adicionar um bloco:
- Clique em + Adicionar Bloco no canto inferior direito do editor de fluxo.
- Selecione uma categoria de bloco.
- Selecione o item desejado na lista.
- Clique em + Adicionar Bloco na janela de seleção de bloco.
As categorias de blocos disponíveis incluem:
Câmeras
Use esta categoria para selecionar uma câmera ou grupo de câmeras.
Um bloco de câmera pode ser usado como fonte de eventos ou condições de detector.
Detectores
Use esta categoria para adicionar eventos de análise de vídeo ao fluxo.
Os tipos de eventos de detector disponíveis podem incluir:
- Todos os eventos
- Detecção de movimento
- Reconhecimento facial
- Reconhecimento de placas de veículos
- Detecção de objetos
- Detecção de multidão
- EPI
- Fumaça e fogo
Blocos detectores são normalmente usados após um bloco de câmera. Por exemplo, um fluxo pode começar com a câmera Gate e continuar quando Reconhecimento facial estiver ativado.
Interação
Use esta categoria para adicionar blocos de interação, como ações de API.
O bloco API permite que o Cluebase VMS envie uma solicitação HTTP para um sistema externo quando a automação é acionada.
Tempo
Use esta categoria para adicionar condições baseadas em tempo limite ao fluxo.
Os blocos de tempo podem ser usados quando uma automação precisa ter um atraso antes de executar outro bloco.
Exemplo: Abrir uma porta usando reconhecimento facial
As capturas de tela mostram um exemplo de cenário de automação em que o Cluebase VMS envia uma solicitação de API para abrir uma porta após um evento de reconhecimento facial.
Etapa 1. Crie ou selecione um cenário
Selecione um cenário existente no painel esquerdo ou crie um novo com o botão +.
Nome do cenário de exemplo:
Abrir porta/portão
Etapa 2. Adicionar um bloco de câmera
Clique em + Adicionar Bloco, abra a categoria Câmeras e selecione a câmera desejada.
Neste exemplo, a câmera selecionada é:
Portão
Clique em + Adicionar Bloco para colocá-lo na tela de fluxo.
Etapa 3. Adicionar um bloco detector
Clique novamente em + Adicionar Bloco e abra a categoria Detectores.
Selecione o evento de detector necessário.
Neste exemplo:
Reconhecimento facial
Clique em + Adicionar Bloco para adicionar o detector ao fluxo.
Etapa 4. Adicionar um bloco de API
Clique em + Adicionar Bloco e abra a categoria Interação.
Selecione:
API
Clique em + Adicionar bloco para colocar o bloco de API na tela de fluxo.
Etapa 5. Configurar o bloco API
Clique no ícone de configurações do bloco de API.
A janela Editar Bloco será aberta.
Configure a solicitação:
- Método: Selecione o método HTTP, por exemplo
POST. - URL: Insira a URL do endpoint da API.
- Parâmetros de consulta: Adicione parâmetros opcionais se necessário.
- Cabeçalhos: Adicione cabeçalhos de solicitação, se necessário.
- Body: Selecione o tipo de corpo da solicitação, por exemplo Event Payload.
- Autenticação: Selecione o tipo de autenticação ou deixe como Nenhum.
URL de exemplo:
http://192.168.1.14/openDoor
Clique em Salvar para aplicar as configurações de bloqueio da API.
Conectar blocos
Após adicionar blocos, conecte-os na ordem necessária.
Para conectar blocos:
- Clique no conector de saída no lado direito do primeiro bloco.
- Arraste a linha de conexão até o conector de entrada do próximo bloco.
- Repita o processo para cada próxima etapa do fluxo.
Fluxo de exemplo:
Câmera Gate → Detector de reconhecimento facial → Solicitação API
Isso significa que quando a câmera selecionada detectar um evento de reconhecimento facial, o Cluebase VMS acionará a solicitação de API configurada.
Ativar automação
Depois de configurar o fluxo:
- Mude o cenário de Desativado para Ativado.
- Clique em Salvar.
A automação só será executada quando estiver habilitada e salva.
Salvar alterações
Clique em Salvar no canto inferior direito após criar ou editar o fluxo.
As alterações não salvas poderão ser perdidas se você sair da página ou mudar para outro cenário.
Use esses controles para atualizar ou remover elementos do fluxo.
Cenário de automação com botão de câmera
O bloco Botão da Câmera permite adicionar um botão de automação personalizado diretamente na barra inferior da janela de vídeo da câmera. Este botão pode ser usado por um operador para acionar manualmente uma ação de automação, como abrir uma porta, chamar uma API externa, ativar um relé ou enviar um comando para um sistema de terceiros.
Este cenário é útil quando a automação deve ser iniciada por uma ação do usuário, em vez de ser acionada automaticamente por análise de vídeo ou detecção de movimento.
Caso de uso típico
Um exemplo comum é um cenário de controle de portão.
Um operador observa a câmera Gate. Quando um visitante chega, o operador pode clicar no botão de automação na barra inferior da janela da câmera. O Cluebase VMS envia uma solicitação de API ao controlador de porta e abre a porta.
Fluxo de exemplo:
Botão de câmera: Gate → Solicitação API: Open door
Crie uma automação com o botão da câmera
Abra o módulo Automação e selecione o cenário desejado no painel esquerdo, ou crie um novo.
Certifique-se de que o cenário esteja ativado alterando-o de Desligado para Ligado.
Adicionar um bloco de botão da câmera
Para adicionar um botão de câmera ao fluxo de automação:
- Clique em + Adicionar Bloco no canto inferior direito do editor de fluxo.
- Na janela de seleção de bloco, selecione Botões da Câmera.
- Escolha a câmera onde o botão deve aparecer.
- Clique em + Adicionar bloco.
Um novo bloco será adicionado à tela de fluxo.
Isto significa que o botão de automação estará disponível na barra inferior da janela de vídeo da câmera Gate.
Conecte o botão da câmera a uma ação
Após adicionar o bloco Botão de câmera, conecte-o à ação que deve ser executada quando o usuário clicar no botão.
Por exemplo, conecte o bloco do botão da câmera a um bloco API.
Exemplo:
Botão de câmera: Gate → API: http://192.168.1.14/openDoor
Neste caso, quando o operador clica no botão de automação da câmera Gate, o Cluebase VMS envia a solicitação da API configurada.
Configurar a ação da API
O bloco API deve ser previamente configurado ou editado clicando no ícone de configuração do bloco.
Nas configurações do bloco de API, configure:
- Método HTTP, por exemplo
POST - URL do sistema externo
- Parâmetros de consulta, se necessário
- Cabeçalhos, se necessário
- Tipo de corpo
- Tipo de autenticação
URL de exemplo:
http://192.168.1.14/openDoor
Clique em Salvar dentro da janela de configuração do bloco após editar a solicitação da API.
Salvar a automação
Depois de criar o fluxo:
- Verifique se o bloco do botão da câmera está conectado ao bloco de ação necessário.
- Certifique-se de que o cenário esteja Ativado.
- Clique em Salvar no canto inferior direito do editor de fluxo.
O botão estará disponível na barra inferior da janela de vídeo da câmera selecionada.
Use o botão de automação na janela da câmera
Abra a janela de vídeo da câmera selecionada no bloco Botão da Câmera.
Um botão de automação aparecerá na barra inferior da janela do vídeo. O botão usa o ícone de automação.
Ao clicar neste botão o operador ativará o fluxo de automação conectado.
Relatórios
Cluebase VMS permite criar relatórios gráficos sobre análise de vídeo baseada em contagem.
Para abrir Relatórios, vá ao Menu Principal -> Relatórios.
Recursos da nuvem
Cluebase VMS contém os seguintes recursos de nuvem:
- Modo nuvem: Otimiza o VMS para uso em nuvem, evitando tráfego desnecessário entre servidores em arquitetura multi-servidor e também limitando a conexão do VMS a uma câmera.
- Qualidade de transmissão ao vivo: permite a transcodificação de transmissões ao vivo no servidor em uma taxa de bits especificada. Isto não afeta a qualidade de gravação do arquivo. Observe que este recurso requer recursos de CPU significativos.
- Túnel: Permite um túnel seguro entre o servidor e o serviço vCloud.ai CloudLink, permitindo que o servidor local seja acessado de qualquer local pela Internet. Uma vez ativado, o URL do CloudLink será exibido na tela. Certifique-se de usar uma senha de administrador forte antes de ativar o túnel.
Para acessar as configurações da nuvem, vá para Menu Principal->Configurações->Configurações Gerais->Nuvem
Marca
O Cluebase VMS permite que você aplique a marca do usuário: logotipo, título do aplicativo, favicon e imagem da página de login.
Registros
O menu Logs fornece ferramentas para auditar a atividade do sistema através de relatórios detalhados de ações do usuário, alterações de configuração, eventos de câmera e operações do sistema. Isto é essencial para administradores que precisam monitorar o uso, investigar problemas ou manter a conformidade. Vá para Menu Principal->Configurações->Configurações Gerais->Logs. Configure filtros conforme necessário selecionando usuários, períodos e tipos de eventos específicos. Clique em Exibir relatório de registros para abrir o relatório em uma guia separada ou em Baixar para obter a versão do arquivo de texto.
Filtros
Menu suspenso Usuário - Selecione um usuário específico para filtrar os registros por atividade associada a essa conta ou escolha Todos os usuários para visualizar os registros de todo o sistema.
Intervalo de datas (de/até) - Use os seletores de calendário para definir o intervalo de tempo dos registros que você deseja recuperar.
Tipos de evento
Selecione uma ou mais categorias de ações registradas para incluir no relatório:
Login/Logout - Ações de login e logout do usuário.
Exportação de Arquivo - Dados de arquivo exportados pelos usuários.
Edição de layout - Alterações nos layouts da câmera.
Configurações de análise - Modificações nas configurações de análise de vídeo.
Configurações da câmera - Alterações feitas nas configurações da câmera.
Câmera desconectada - Registra quando uma câmera fica indisponível.
Controle PTZ - Operações PTZ (Pan-Tilt-Zoom) iniciadas pelos usuários.
Reprodução de arquivo - Grava ao visualizar vídeo arquivado.
Notificação de Eventos - Logs relacionados a eventos e alertas acionados.
Licença - Ativação, atualizações ou problemas de licença.
Configurações Gerais - Alterações nas preferências gerais do sistema.
Configurações de armazenamento - Alterações nas configurações de armazenamento.
Armazenamento desconectado - Registra quando dispositivos de armazenamento são perdidos ou reconectados.
Configuração do usuário - Modificações nas contas ou permissões dos usuários.
Todos os Eventos - Habilite rapidamente todos os tipos de eventos para auditoria completa.
✅ As caixas marcadas indicam quais tipos de registros serão incluídos no relatório gerado.
Failover
O menu Failover permite aos administradores configurar servidores redundantes que assumem automaticamente o processamento de vídeo e tarefas de gerenciamento se um servidor primário falhar. Isto garante alta disponibilidade e continuidade de serviço, essenciais em ambientes críticos como segurança e videovigilância.
Vá para Menu Principal -> Configurações -> Failover:
O Cluebase VMS oferece suporte à funcionalidade hot swap com as seguintes opções:
- 1 a 1 – cada servidor no sistema possui um servidor de failover.
- Muitos para 1 - vários servidores podem ser trocados a quente por 1 servidor de failover.
- Muitos para muitos - vários servidores podem ser trocados a quente por vários servidores de failover.
Observe:
- Ao usar a funcionalidade de failover, é importante garantir que o armazenamento de rede (armazenamento de objetos ou NAS) seja usado.
- O hardware do servidor de failover deve ser capaz de lidar com o número necessário de câmeras, portanto o hardware desses servidores deve ser calculado e configurado com precisão.
- A configuração é enviada automaticamente do servidor primário para o servidor de failover a cada 5 minutos.
Configuração:
Para configurar um sistema de failover você precisa de pelo menos 1 servidor primário e 1 servidor de failover.
Vá para a interface do servidor principal e abra as configurações de failover: Configurações->Failover->Adicionar servidor de failover e preencha os campos com as credenciais do servidor de failover. No campo Lógico, escolha o servidor ou servidores que devem ser trocados a quente pelo servidor de failover atual. Em seguida, clique em Salvar.
Opção de redefinição de fábrica
A opção Redefinição de fábrica permite apagar todos os dados existentes e retornar as configurações do sistema ao estado padrão original.
Vá para Menu Principal -> Configurações -> Configurações Gerais -> Configurações
Use o botão Redefinir para padrões para excluir todos os dados atuais do sistema e restaurar as configurações padrão.
Configurações de reinicialização automática do servidor
A configuração reinicialização automática do servidor permite agendar reinicializações periódicas do servidor.
Vá para Menu Principal -> Configurações -> Configurações Gerais -> Configurações do Administrador
- Use o botão Habilitar para ativar a reinicialização automática do servidor.
- Selecione a frequência de redefinição na lista suspensa (por exemplo, Toda semana).
Atualize e reinicie o servidor
Vá para Menu Principal -> Configurações -> Configurações Gerais -> Informações do Sistema
Atualizar o sistema
- Use o botão Atualizar localizado no canto inferior direito para atualizar a interface e o servidor para a versão mais recente disponível.
Reinicie o servidor
- Use o botão Reiniciar localizado na parte inferior esquerda para reiniciar o servidor.
Suporte técnico
O suporte técnico vCloud.ai funciona 24 horas por dia, 7 dias por semana; O tempo médio de resposta é de 3 horas. O suporte técnico pode ser solicitado por e-mail: support@vcloud.ai