RTSP e ONVIF: o que são, como ativar e como usar o ONVIF Device Manager

RTSP quer dizer Real Time Streaming Protocol. É um padrão da internet, publicado pela IETF, para iniciar e controlar a entrega de áudio e vídeo em tempo real.

Para quem tem câmeras, o RTSP aparece como um endereço que começa com rtsp://. Com esse endereço e com o usuário e a senha do aparelho, qualquer programa que entenda RTSP consegue abrir o vídeo ao vivo daquela câmera. O VLC e os programas de análise de vídeo fazem isso.

A porta padrão do RTSP é a 554. A documentação da Dahua e um guia da Intelbras citam esse número como padrão, mas alguém pode ter trocado a porta no aparelho.

ONVIF é um fórum aberto do setor de segurança eletrônica, fundado em 2008 por fabricantes de câmeras. A missão dele é criar interfaces padronizadas para que produtos de segurança baseados em IP, de marcas diferentes, funcionem juntos. Hoje o fórum reúne mais de 500 empresas associadas.

Para deixar claro o que cada aparelho entende, o ONVIF trabalha com perfis. Um perfil é um conjunto fixo de funções. Os que interessam para vídeo são o Perfil S, de vídeo básico ao vivo, o Perfil T, de vídeo avançado, e o Perfil G, para guardar e buscar gravações no próprio aparelho.

O ONVIF e o RTSP trabalham juntos. O ONVIF cuida de achar o aparelho na rede, de entrar nele com um usuário e de informar como pedir o vídeo. O vídeo em si costuma sair por RTSP. Por isso o ONVIF Device Manager, que aparece mais adiante, mostra o endereço RTSP da câmera.

Você precisa de um dos dois, e quem decide é o programa que vai usar o vídeo. Estas regras ajudam a escolher.

• Se o programa pede um endereço RTSP ou a URL do fluxo, você precisa do link RTSP, do usuário e da senha.
• Se o programa procura as câmeras na rede sozinho ou pede ONVIF, ligue o ONVIF no aparelho e crie um usuário ONVIF.
• Se o seu aparelho só funciona pelo aplicativo do fabricante, ele pode não oferecer nenhum dos dois. Procure RTSP ou ONVIF na ficha técnica ou no manual do modelo.
• A ONVIF mantém uma lista pública de produtos que passaram pela conformidade com cada perfil, e dá para consultá-la.

Os dois caminhos pedem as mesmas informações básicas. Junte tudo antes, e o resto fica rápido.

• O endereço IP do aparelho. O roteador mostra a lista dos aparelhos ligados, e o programa do fabricante também costuma mostrar.
• O usuário e a senha de administrador do aparelho. É a senha criada quando ele foi ativado, e não a senha de uma conta em aplicativo.
• Um computador na mesma rede do aparelho, por cabo ou pelo Wi-Fi do mesmo roteador.
• A porta RTSP, se alguém a mudou. O padrão é 554.
• Qual câmera você quer. Em um gravador, cada câmera é um canal.

A Hikvision publica um documento de ajuda para câmeras IP. O caminho vale para o firmware 5.5.0 ou mais novo. Um boletim técnico da Hikvision informa que, a partir dessa versão, o ONVIF vem desligado, até em aparelhos atualizados que antes o tinham ligado. Em firmware mais antigo, o ONVIF já vem ligado e usa o mesmo usuário e a mesma senha da câmera.

Em gravadores o menu pode mudar de nome, então confira o manual do modelo.

• 1. Digite o endereço IP da câmera no navegador e entre como administrador.
• 2. Vá em Configuration, Network, Advanced Settings e Integration Protocol.
• 3. Marque Enable ONVIF.
• 4. Clique em Add para criar um usuário ONVIF, com nome e senha. O boletim técnico informa que o limite é de 32 usuários.
• 5. Use esse usuário e essa senha no programa que vai acessar a câmera por ONVIF.

A Dahua mantém uma wiki técnica própria, a DahuaWiki. Segundo ela, o ONVIF vem desligado por padrão, e o caminho em um gravador é o que está abaixo. Os nomes dos menus aparecem em inglês na wiki, e alguns aparelhos os mostram em português.

No manual de câmeras IP, a Dahua avisa que, em firmware antigo, a senha ONVIF não muda quando você troca a senha do sistema. Se o login ONVIF falhar depois de uma troca de senha, atualize o firmware ou troque a senha ONVIF à mão.

• 1. No menu principal, vá em Setup, Network, Connection e ONVIF, e ligue a função.
• 2. Em firmware mais novo, existe uma aba de contas ONVIF em Setup, System, Account e Onvif. Clique em Add User, escolha nome, senha e grupo, e aplique.
• 3. Em firmware mais antigo, as credenciais ONVIF são definidas no primeiro login, e a senha escolhida ali vale até o aparelho voltar às configurações de fábrica.
• 4. Para ver a versão do ONVIF do aparelho, vá em Setup, System e Version.

Um endereço RTSP é montado com as mesmas peças em todas as marcas: usuário, senha, IP, porta e um caminho. O caminho muda de fabricante para fabricante, e é nele que as pessoas costumam errar. Troque as palavras em maiúsculas pelos seus dados.

• Hikvision: rtsp://USUARIO:SENHA@IP:554/Streaming/Channels/101. O 101 é o fluxo principal da câmera 1, e o 102 é o fluxo secundário. O boletim da Hikvision mostra que o canal vem antes: 1701 é o fluxo principal do canal 17.
• Dahua: rtsp://USUARIO:SENHA@IP:554/cam/realmonitor?channel=1&subtype=0. O channel é o número da câmera, a partir de 1. O subtype 0 é o fluxo principal e o 1 é o fluxo extra. É o que a DahuaWiki documenta.
• Intelbras: segundo o guia da própria Intelbras para o terminal TIP 638V, as câmeras IP e os gravadores Intelbras usam o mesmo formato da Dahua, com a porta 554 como padrão. A exceção citada são os modelos VIP 1120, VIP 1220, VIP 1130 e VIP 3230VF, que usam rtsp://IP:PORTA/user=USUARIO&password=SENHA&channel=1&stream=0.sdp?. Em outro documento, a Intelbras diz que é imprescindível consultar o comando RTSP no manual do produto, então confira o do seu modelo.

Quase todo aparelho entrega dois fluxos de cada câmera. O principal tem a melhor qualidade e usa mais rede. O secundário é mais leve. Em um programa que mostra muitas câmeras ao mesmo tempo, ou em uma rede lenta, o fluxo secundário costuma ser a escolha certa. Na Hikvision a diferença está no final do caminho, 101 e 102. Na Dahua está no subtype, 0 e 1.

O ONVIF Device Manager, que muita gente chama de ODM, é um programa gratuito e de código aberto para Windows. A página do projeto o descreve como um gerenciador para aparelhos de vídeo em rede baseados em ONVIF. Na prática, ele é um programa que fala ONVIF: procura os aparelhos na rede, entra neles com um usuário, mostra o vídeo ao vivo e as configurações. A lista de funções do projeto inclui busca de aparelhos, imagem ao vivo, configuração de serviços, eventos, atualização de firmware e cópia de segurança da configuração.

Ele não foi feito pela ONVIF. A própria ONVIF avisa, na sua central de ajuda, que o ONVIF Device Manager é um projeto de código aberto que não foi desenvolvido pela organização, e manda as dúvidas para o projeto. A licença do programa é a GPL versão 2.

Para quem tem câmeras, o ODM serve para três coisas: ver se o aparelho entende ONVIF, achar o endereço RTSP e conferir se o usuário ONVIF funciona. A DahuaWiki explica que, se você consegue entrar no aparelho pelo ODM, o aparelho é compatível com ONVIF.

Baixe somente da página oficial do projeto, no SourceForge: sourceforge.net/projects/onvifdm. É o mesmo endereço para o qual a ONVIF aponta na sua central de ajuda. Na aba Files, o instalador é um arquivo .msi para Windows. A última versão publicada ali é a 2.2.250, de 11 de janeiro de 2024.

Evite outros sites que oferecem o programa com o mesmo nome. Eles não são o projeto, e um instalador baixado de um site que você não conhece pode trazer coisas que você não pediu. Se você só precisa do endereço RTSP, o caminho de montar o endereço à mão, mostrado mais acima, não exige instalar nada.

O ODM roda só em Windows. Os nomes de alguns botões podem ser diferentes do que está aqui, porque a última versão publicada é de janeiro de 2024.

Antes de abrir o programa, ligue o ONVIF no aparelho e crie o usuário ONVIF, como mostram as seções sobre Hikvision e Dahua acima. A DahuaWiki avisa que a maioria das contas ONVIF espelha o usuário e a senha do administrador de quando o aparelho foi ativado. Se você mudou a senha do administrador depois, a nova senha não passa sozinha para a conta ONVIF.

• 1. Instale o ODM em um computador com Windows ligado à mesma rede do aparelho, no mesmo roteador ou switch, por cabo ou pelo Wi-Fi do mesmo roteador.
• 2. Abra o programa. Ele procura na rede os aparelhos que respondem ao ONVIF e monta a lista.
• 3. Digite o usuário e a senha ONVIF e clique em Log in.
• 4. A lista de aparelhos se atualiza. Clique na câmera que você quer testar. Se o login funcionou, você confirmou que o aparelho é compatível com ONVIF.
• 5. Abra a imagem ao vivo para ver se o vídeo chega. O endereço RTSP aparece na barra de endereço, na parte de baixo da janela.
• 6. Copie o endereço e teste no VLC, como mostra a próxima seção.
• 7. Se não aparecer imagem, veja se a câmera está em H.265. A DahuaWiki descreve um caso em que a imagem só voltou depois de trocar a compressão para H.264 na página de configuração da câmera.

O ODM também cria usuários ONVIF. Vá em User management, clique em Create, digite o nome e a senha, escolha o tipo de usuário (a função que ele vai ter) e clique em Apply.

O ODM não diz com todas as letras quais perfis ONVIF o aparelho tem. Na área de perfis (Profiles) você vê os detalhes da configuração atual e pode comparar com a lista oficial de perfis da ONVIF, como o S, o T e o G que explicamos acima. A DahuaWiki mostra um raciocínio de exemplo: uma câmera que não abria em H.265 provavelmente não tem o Perfil T.

Quando a câmera não aparece na lista, o problema quase sempre é um destes.

• ONVIF desligado, ou sem usuário ONVIF. Em aparelhos Hikvision e Dahua, o ONVIF pode vir desligado, como mostram as seções acima.
• Computador e aparelho em redes diferentes. A busca do ONVIF funciona por mensagens enviadas a todos os aparelhos da rede local, então o computador precisa estar ligado ao mesmo roteador ou switch do aparelho.
• Aparelho que não responde à busca. Segundo a especificação do ONVIF, o aparelho vem por padrão em modo detectável, mas é possível pô-lo em modo não detectável. Nesse modo ele não responde à busca e não aparece na lista.
• Usuário ou senha ONVIF errados. Muitas tentativas erradas podem bloquear o aparelho por um tempo, então não fique chutando senhas.
• Sem a busca, você ainda pode montar o endereço RTSP à mão, como mostra a seção sobre o endereço RTSP, e testar no VLC. Para achar o endereço IP de um aparelho Hikvision, veja o guia do SADP.

Antes de colocar o link em qualquer programa, teste no VLC, que é gratuito. Se o vídeo abrir no VLC, o link está certo.

• 1. Abra o VLC e vá em Mídia e Abrir Transmissão de Rede.
• 2. Cole o endereço RTSP no campo de endereço.
• 3. Clique em Reproduzir.

Quase sempre o problema é um destes.

• Senha com caractere especial. A DahuaWiki avisa que a senha usada no endereço não pode ter o caractere #. Troque a senha ou use um programa que peça usuário e senha em campos separados.
• Porta diferente da padrão. Veja a porta RTSP no menu de rede do aparelho e use a mesma no endereço.
• Usuário ou senha errados. Se for ONVIF, lembre que o usuário ONVIF pode ser diferente do usuário do aparelho. Muitas tentativas erradas podem bloquear o aparelho por um tempo, então não fique chutando senhas.
• ONVIF desligado. Em aparelhos Hikvision e Dahua ele pode vir desligado, como visto acima.
• Compressão H.265. Alguns programas não abrem esse formato. A DahuaWiki pede H.264 no teste com o VLC.
• Rede diferente. O endereço IP local só funciona dentro da rede local. Se o computador está em outra rede, ele não chega até o aparelho.

É possível abrir a porta do RTSP no roteador e usar o link de fora, e alguns guias de fabricantes explicam como. Só que isso deixa o aparelho exposto na internet. Para ver as câmeras de longe, prefira o aplicativo do fabricante. Se você precisa mesmo do RTSP fora do local, peça a um instalador para configurar com cuidado.