Integrações: Integrações
API (Interface de Programação de Aplicativos)
Tradução: Python Wrapper
Existe um wrapper python para funcionalidades básicas de interface do usuário aqui: agent-py .
URL参数
您可以通过调用Agent DVR的URL以特定视图打开Agent(区分大小写):
- ?start=Live&viewIndex=3(在第3个视图上进行实时查看)
- ?start=TimeMachine(时光机视图)
- ?start=Timeline(时间轴视图)
- ?start=Photos(照片视图)
- ?start=Recordings(录像视图)
- ?start=Floorplans&planIndex=2(在第2个平面图上进行楼层图视图)
- ?start=VR(虚拟现实)
您可以通过传入两个字母的语言代码来打开Agent DVR(绕过语言选择)。例如:?lang=fr
您可以使用过滤器参数传入保存的过滤器名称以应用过滤器。例如:?start=Recordings&filter=intruder。您还可以使用JavaScript的时间戳传入过滤器的起始时间和结束时间。例如:?start=timeline&from=1657841514949&to=1657852514949。
设置默认的主题选项(主题选项在账户菜单中的主题设置中可用):
- ?theme=darkly&variant=dark&large=false
- ?theme=sketchy&variant=primary&large=true
加载时自动播放音频(可能还需要更改浏览器设置):
- ?playaudio=true
以最小化模式启动(隐藏顶部和底部的用户界面栏):
- ?mini=true
传入本地用户名和密码以进行自动登录(注意 - 这将向网络公开您的凭据):
- ?un=username&pwd=password
Comandos
Para acessar os Comandos no Agent DVR, clique no ícone do Servidor no canto superior esquerdo da interface do Agent e selecione "Comandos" em Sistema. Um atalho rápido é pressionar "Alt - C".
O Agent DVR inclui vários comandos pré-configurados que podem controlar vários dispositivos simultaneamente. Esses comandos utilizam a API para realizar várias tarefas. Você tem a flexibilidade de adicionar seus próprios comandos personalizados para chamar a API ou executar software em seu computador.
Chamando um Arquivo de Script
Para executar um arquivo de script genérico, basta adicionar um arquivo .bat (ou .sh no Linux/macOS) ao diretório de comandos. O nome do arquivo de script (sem a extensão) aparecerá na lista de Comandos e poderá ser clicado para ser executado. Observação: Talvez seja necessário recarregar a interface para que ele apareça.
Chamando a API
Crie um novo arquivo .bat na pasta de Comandos onde o Agent está instalado. A primeira linha deve ser:
REM ispy-internal
Essa linha indica que o arquivo deve ser processado internamente pelo Agent, não executado como um aplicativo independente.
As linhas subsequentes são interpretadas como comandos para a API do Agent. Por exemplo:
REM ispy-internal
switchon&group=external
switchoff&group=internal
record&group=external
broadcast 'external cameras are on and recording'
Esses comandos são anexados às chamadas da API no formato /command.cgi?cmd=.... Portanto, você pode usar qualquer comando disponível na API.
Os comandos de exemplo acima irão ativar todos os dispositivos rotulados como "externos", desativar todos os dispositivos "internos", iniciar a gravação nos dispositivos "externos" e enviar uma mensagem de transmissão para todos os clientes conectados.
Consulte o botão de comando readme para exemplos e a documentação da API para obter uma lista de comandos disponíveis.
Após recarregar a interface e pressionar "Alt - C", seu novo comando deve ser visível na lista. Clique nele para executar.
A partir da versão 3.8.1.0+, você pode usar nomes de localização nos comandos (por exemplo, switchon&location=home). Apenas atribua uma localização aos seus dispositivos primeiro!
Amazon Alexa
A partir da versão 2.9.5.0, o Agent DVR oferece integração com a Amazon Alexa. Essa funcionalidade permite que você controle o Agent DVR usando comandos de voz por meio de dispositivos compatíveis com a Alexa. Você pode armar ou desarmar o sistema ou exibir feeds de vídeo ao vivo em dispositivos Alexa Show.
Para configurar, selecione 'Alexa' em Integrações no menu Servidor do Agent DVR. Isso redirecionará você para a Amazon para vincular suas contas.
Depois de vinculado, execute o processo de descoberta da Alexa. Ela deve encontrar dois dispositivos: o painel de segurança e o controle da câmera.
Agora você pode usar comandos de voz como:
- "Alexa, arme o Agent no modo residencial"
- "Alexa, mostre a câmera do Agent"
Defina seu código de segurança nas Configurações do Agent para operações que exigem autenticação. O código padrão é 1234.
Os perfis da Alexa (Casa / Ausente / Noite) correspondem aos do Agent DVR. Configure-os em Servidor - Perfis.
Para vários servidores, defina um nome de servidor nas configurações e use-o nos comandos de voz.
Home Assistant
O Agent DVR integra-se completamente com o Home Assistant, permitindo que você adicione o Agent DVR à sua configuração do Home Assistant. Incorpore o painel do Agent DVR na interface do usuário do Lovelace ou selecione câmeras individuais. Ele também inclui um controle para o painel de segurança principal. Para mais informações, consulte o link do Home Assistant em Servidor - Integrações.
IFTTT (Se Isso Então Aquilo)
O IFTTT permite que você configure ações e gatilhos com dispositivos IoT. Comece vinculando sua conta do IFTTT ao iSpyConnect.com, acessível em Servidor - Integrações.
Alertas de Notificação
A configuração de alertas push móveis é detalhada em Configurando Alertas Push.
Telegram
Conecte o Agent DVR com o chatbot do Telegram para controle e notificações de alerta ao vivo. Ative as notificações Push nas configurações do dispositivo para alertas ao vivo. Comece selecionando o botão do Telegram abaixo do ícone do Servidor na interface web remota.