Agent DVR: Plugins

Instalando Plugins

Plugins são módulos complementares opcionais que estendem Agent DVR com recursos extras de processamento de áudio e vídeo, como varredura de código de barras, "Sobreposições" de clima e filtros de áudio.

A forma mais fácil de instalar plugins é através do portal web remoto. Depois de conectado, clique no "Ícone" do "Servidor" no "Canto superior direito" e navegue até 'Plugins' em "Sistema". Aqui, você pode "Selecionar" o plugin que deseja usar no menu suspenso no canto superior direito e clicar em 'Instalar' para começar.

Prefere instalar manualmente? Sem problema! Você pode compilar os plugins a partir da fonte e depois copiar a saída compilada para Agent/Plugins/PLUGINNAME. Este método oferece a você mais controle sobre o processo de instalação.

Plugins Disponíveis

Agent DVR vem repleto de recursos avançados de processamento de vídeo como integração com CodeProject AI, juntamente com rastreamento avançado de objetos, reconhecimento de áudio e detectores de contagem. Para aprimorar ainda mais sua experiência, oferecemos uma variedade de plugins que você pode usar em AgentDVR para estender sua funcionalidade.

Lista de Plugins

Códigos de barras

Digitalize praticamente qualquer código de barras de uma câmera (apenas Windows).

Eventos gerados: Código de barras reconhecido
Suporta: Vídeo

captura de tela

Ganho

Aplique filtros de banda ao vivo no áudio proveniente de dispositivos de áudio.

Eventos gerados: Nenhum
Suporta: Áudio

captura de tela

Atraso ao vivo

Adiciona um atraso ao áudio e vídeo ao vivo (útil para análise de esportes).

Eventos gerados: Nenhum
Suporta: Vídeo, Áudio

captura de tela

Clima

Adiciona uma sobreposição de status climático ao vídeo ao vivo com base na sua localização. Gere eventos se o clima mudar - por exemplo, se uma tempestade está chegando ou se as rajadas de vento ou limites de temperatura forem ultrapassados. Você pode personalizar o layout e o modo de exibição dos dados climáticos, desde apenas um ícone até detalhes completos.

A configuração do clima usa uma string de formato para organizar as informações. Aqui estão alguns exemplos de strings de formato que você pode usar:

Informações completas:

{icon}{main}: {description} 
 Vento: {wind} Rajada: {gust} 
 Temp: {temp} Sensação térmica: {feelsLike} 
 Umidade: {humidity} IUV: {uvi}

Apenas ícone:

{icon}

Uma linha:

{main} {wind} {temp} {humidity} IUV: {uvi}

Eventos gerados: Temperatura alta, Rajada, Status
Suporta: Vídeo

captura de tela
Se você estiver usando um plugin de áudio como Listen em uma câmera, você precisará editar a câmera, selecionar a aba Áudio e clicar para configurar o microfone. De lá, você pode acessar a aba Plugins para dispositivos de áudio. Alternativamente, você pode clicar no ícone do Servidor, selecionar Editar dispositivos e editar o microfone dessa lista.

Configurar Plugins

Pronto para aproveitar o poder dos plugins? Simplesmente adicione um dispositivo (câmera e/ou microfone) e acesse suas configurações de edição. Procure pela aba Plugins na lista suspensa no canto superior direito. Aqui, você pode selecionar seu plugin desejado e clicar no botão "..." para configurá-lo conforme suas necessidades.

Alguns plugins geram eventos que você pode anexar ações. O plugin Weather, por exemplo, gera um evento Gust quando rajadas de vento excedem um valor especificado (configurável no plugin). Editar a câmera e navegar para a aba Ações oferece opções para responder a isso - soando um alarme ou iniciando uma gravação, por exemplo. Simplesmente selecione o nome do plugin: evento (ex. Weather: Gust) na caixa Se selecionar e atribua uma ação.

Crie seu próprio Plugin

Os plugins são módulos dinâmicos que você pode adicionar ao Agent DVR para aprimorar seus recursos de processamento de áudio e vídeo. Com plugins, aplique efeitos em tempo real, sobreposições, dispare eventos e ative alertas no Agent DVR, permitindo ações personalizadas avançadas.

Para começar a criar plugins para o Agent DVR, comece clonando nossos plugins de código aberto em https://github.com/ispysoftware/AgentDVR-Plugins. Você precisará de uma versão recente do Visual Studio para compilá-los.

Recomendamos começar com o plugin de demonstração como base. Certifique-se de ter a versão mais recente do Agent instalada. Depois de compilar o plugin de demonstração, copie todos os arquivos da pasta de saída para Agent\Plugins\Demo\. Reinicie o Agent DVR, edite uma câmera e acesse a guia Plugins. Ative o plugin, selecione Demo na lista suspensa e clique no botão "..." para configurá-lo.

O plugin Demo é totalmente compatível com múltiplas plataformas e demonstra a funcionalidade extensiva que você pode criar com plugins. Inclui efeitos de vídeo ao vivo, sobreposições gráficas, controle de volume ao vivo e integração com o subsistema de eventos do Agent DVR. O menu do plugin fornece insights sobre como vários controles de entrada funcionam.


Notas de Plugin para Desenvolvedores:

Configuração: Agent DVR usa JSON e um arquivo de classe para armazenamento de configurações. Para configurar as definições, edite o arquivo config.cs.

A renderização de configuração do Agent DVR depende de arquivos .json. Edite config_en.json no diretório json para exibição da interface, onde você pode adicionar várias seções renderizadas como guias. Os campos-chave 'bindto' no json vinculam aos campos de configuração. Agent DVR automatiza a renderização de controles, armazenamento de configurações e atualizações.

Adicionar "live": true às entradas json permite atualizações imediatas sem esperar pelo clique do botão OK, o que é ótimo para ajuste ao vivo. O campo 'converter' utiliza 'PopulateResponse' em Utils.cs para formatação de valores.

Suporte de Mídia: Escolha processar "vídeo", "áudio" ou ambos. O campo 'Supports' em Main.cs pode ser codificado.

Processamento Contínuo: Cada quadro de vídeo e áudio do dispositivo é enviado ao plugin para análise ou processamento, conforme demonstrado no plugin de demonstração.

Processamento de Movimento/Alerta: Processe quadros em movimento ou alertas utilizando o método 'ProcessEvent' no plugin de demonstração. Isso permite o processamento de quadros apenas durante esses eventos.

Eventos Personalizados: O método 'GetCustomEvents' no seu plugin deve retornar uma lista de eventos personalizados que ele gera. Esses eventos aparecem em Ações na lista 'Se' da interface do Agent DVR. Dispare esses eventos com um item 'Resultado', especificando o nome da ação e opcionalmente MSG, Tag, Nome do arquivo e AIJSON.

Alerta, Detectar e Tag: Dispare alertas ou detecte eventos adicionando um Resultado com "alert" ou "detect" como eventName. Marque gravações em andamento com um eventName 'tag' e defina Tags conforme necessário.

Chamadas da API: Agent DVR inicializa plugins com informações do dispositivo e porta do servidor local, útil para comandos da API do dispositivo. As propriedades AppDataPath e AppPath também são definidas para exibição ou locais de salvamento de arquivos.

Distribuição: Criou um plugin legal ou útil? Compartilhe conosco e contribua para a comunidade!