Streaming iDFace

Streaming RTSP

O controlador de acesso iDFace é capaz de transmitir o streaming de vídeo de sua câmera através do protocolo RTSP. Uma vez habilitado o recurso, para ter acesso à transmissão é necessário configurar um cliente RTSP (como o VLC Media Player ou o Windows Media Player) para acessar o equipamento no endpoint /main_stream. É importante destacar que o recurso vem, por padrão de fábrica, desabilitado e sem credenciais. Para habilitar deve-se seguir as instruções de configuração que serão mostradas na sequência.

URL para acesso ao serviço

Para acessar o streaming de vídeo da câmera do iDFace, caso nenhum usuário e senha estejam registrados nas credenciais RTSP, é necessário utilizar uma URL tal como a apresentada abaixo:

rtsp://endereço.ip.do.equipamento:porta/main_stream

Caso um usuário e uma senha tenham sido registrados nas credenciais RTSP, a URL de acesso seguirá o seguinte padrão:

rtsp://usuário:senha@endereço.ip.do.equipamento:porta/main_stream

Configurações dos parâmetros do Streaming RTSP

Atenção: todas as mudanças de configuração listadas abaixo só serão efetivadas após reinício do equipamento

Caso o usuário deseje utilizar o streaming de vídeo de sua câmera, é preciso habilitar na GUI, interface WEB ou via API. O parâmetro que permite habilitar (1) ou desabilitar (0) é o rtsp_enabled do módulo onvif.

Exemplo de requisição

Esta requisição habilita a transmissão de vídeo via RTSP.

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            "onvif": {
                "rtsp_enabled": "1"
            }
        }
    )
});

Configuração da porta

É possível configurar também a porta utilizada para a transmissão. A porta padrão utilizada é a "554". Para alterá-la deve-se utilizar o parâmetro rtsp_port do módulo onvif.

Exemplo de requisição

Esta requisição altera a porta da transmissão de vídeo via RTSP.

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            "onvif": {
                "rtsp_port": "556"
            }
        }
    )
});

Configuração de credenciais

Da mesma forma, é possível registrar um nome de usuário e senha para que a transmissão só seja habilitada a partir do preenchimento do usuário e senhas corretos. Para isso deve-se utilizar os parâmetros rtsp_username e rtsp_password do módulo onvif. Por padrão, nenhum usuário e senha estão registrados nesses parâmetros.

Exemplo de requisição

Esta requisição insere um usuário e senha para ativar a transmissão de vídeo via RTSP.

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            "onvif": {
                "rtsp_username": "admin",
                "rtsp_password": "admin",
            }
        }
    )
});

Configuração de câmera

Além disso, é possível alterar a câmera utilizada para fazer a transmissão de vídeo. A câmera padrão é a RGB, mas via requisição API é possível alterá-la para câmera infravermelha (IR). O parâmetro responsável por essa configuração é o rtsp_rgb do módulo onvif, e são duas as entradas válidas para ele: "0" (IR) ou "1" (RGB).

Exemplo de requisição

Esta requisição altera a câmera da transmissão de vídeo para a câmera IR.

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            "onvif": {
                "rtsp_rgb": "0"
            }
        }
    )
});

Configuração de codec

Também é possível alterar o codec de vídeo utilizado na transmissão. O codec padrão é MJPEG, mas via requisição API é possível alterá-lo para H.264. O parâmetro responsável por essa configuração é o rtsp_codec do módulo onvif, e são duas as entradas válidas para ele: "mjpeg" (MJPEG) ou "h264" (H.264).

Exemplo de requisição

Esta requisição altera o codec de transmissão para H.264.

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            "onvif": {
                "rtsp_codec": "h264"
            }
        }
    )
});

Streaming ONVIF

O controlador de acesso iDFace também é capaz de transmitir o streaming de vídeo de sua câmera através do padrão ONVIF (Open Network Video Interface Forum), reconhecido e utilizado mundialmente por diversos fabricantes de câmeras de vigilância e gravadores.

Configurações dos parâmetros do Streaming ONVIF

Atenção: todas as mudanças de configuração listadas abaixo só serão efetivadas após reinício do equipamento

Primeiramente, devemos nos atentar que as transmissões seguindo padrão ONVIF são realizadas utilizando em seu background o protocolo RTSP, logo, lembre-se de configurar devidamente o RTSP e habilitá-lo para garantir que a transmissão ONVIF ocorra sem erros. A transmissão ONVIF só irá funcionar se o RTSP estiver ativo e operando corretamente.

Além disso, é importante saber que o ONVIF utiliza as suas credenciais padrões, ou seja, o valor de "admin" tanto para o login quanto para senha.

Caso o usuário deseje utilizar a funcionalidade ONVIF, é preciso habilitar na GUI, interface WEB ou via API. O parâmetro que permite habilitar (1) ou desabilitar (0) é o onvif_enabled do módulo onvif.

Exemplo de requisição

Esta requisição habilita a transmissão de vídeo via ONVIF.

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            "onvif": {
                "onvif_enabled": "1"
            }
        }
    )
});

Configuração da porta

É possível configurar também a porta utilizada para a transmissão. A porta padrão utilizada é a "8000". Para alterá-la deve-se utilizar o parâmetro onvif_port do módulo onvif.

Exemplo de requisição

Esta requisição altera a porta da transmissão de vídeo via ONVIF.

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            "onvif": {
                "onvif_port": "8001"
            }
        }
    )
});

Parametrizações de visualização

O controlador de acesso iDFace também é capaz de transmitir o vídeo de sua câmera com resolução de 360x640, com a possibilidade de configurar o espelhamento da imagem a fim de melhorar a visualização do local.

Configurações dos parâmetros de transmissão de vídeo

Além disso, é possível alterar a orientação da transmissão de vídeo, podendo ser original ou espelhada. O parâmetro responsável por essa configuração é o rtsp_flipped do módulo onvif, e são duas as entradas válidas para ele: "0" para original ou "1" tela espelhada.

Exemplo de requisição

Esta requisição altera para a tela espelhada.

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            "onvif": {
                "rtsp_flipped": "1"
            }
        }
    )
});