Manual do utilizador de Ajax Video SDK

Ajax Video SDK é um conjunto de ferramentas concebido para integrar a videovigilância Ajax em software de terceiros. Permite aos programadores transmitir vídeos em direto e gravados a partir de dispositivos de vídeo Ajax e gerir as transmissões de vídeo das suas próprias interfaces.

Este kit destina-se a programadores de software que necessitam de integrar vídeo Ajax nas suas apps e garantir uma transmissão de vídeo estável.

Descrição geral

Ajax Video SDK permite aos programadores transmitir vídeos em direto e gravados a partir de dispositivos de vídeo Ajax. Utiliza uma arquitetura de dois níveis:

• REST API — utilizada para autenticar e obter recursos (espaços, dispositivos de vídeo, canais e tokens de vídeo).

• gRPC SDK — utilizada para iniciar e controlar transmissões de vídeo com tokens obtidos através da API REST.

Ajax Video SDK lança um serviço gRPC local que gere a transmissão de vídeo. A app liga-se ao serviço para iniciar e controlar as transmissões de vídeo e recebe um URL RTSP que pode ser utilizado para reproduzir vídeo num reprodutor compatível.

Principais características

Ajax Video SDK oferece as seguintes funcionalidades:

1. Transmissão em direto através de RTSP.

2. Reprodução de arquivo através de RTSP.

3. Controlo de arquivo:

   • seleção de um intervalo de tempo,

   • navegação para uma data e hora específicas,

   • navegação num arquivo através de um calendário (navegação do lado do cliente),

   • obtenção de metadados para o intervalo selecionado, incluindo uma linha de tempo e deteções.

4. Seleção da qualidade de transmissão (PRINCIPAL/SECUNDÁRIO).

Estrutura de Ajax Video SDK

O arquivo de Ajax Video SDK inclui a biblioteca SDK, ficheiros .proto que definem a API gRPC e apps de demonstração em C++ com código-fonte, que podem ser utilizadas para testar as funcionalidades de SDK e servir como um exemplo prático da sua utilização.

Requisitos do sistema

Ajax Video SDK está implementado em C/C++ e pode ser integrado diretamente em apps C++.

O kit de ferramentas pode também ser utilizado com qualquer linguagem de programação compatível com gRPC: é necessário executar o SDK como um serviço local e estabelecer ligação ao mesmo através do gRPC.

Fluxo de integração

Para aceder a Ajax Video SDK, preencha o formulário de pedido. A equipa de Ajax entrará em contacto consigo e fornecerá um arquivo com os ficheiros do SDK para o seu sistema operativo.

Para começar a utilizar Ajax Video SDK:

1. Efetue a autenticação utilizando um dos métodos suportados.

2. Encontre o espaço necessário.

3. Recupere os ID de edge e de canal necessários através da API de Ajax. Pode solicitar a lista de todos os dispositivos presentes no espaço e identificar o canal pelo seu nome.

4. Certifique-se de que a sua conta tem as permissões necessárias para aceder ao canal selecionado. A transmissão de vídeo apenas está disponível para os canais aos quais o utilizador ou a empresa tem acesso.

5. Gere um token de acesso ao reprodutor de vídeo utilizando os IDs de edge e de canal necessários.

6. Inicialize o SDK para iniciar um servidor gRPC local.

7. Abra um fluxo gRPC (LiveStreaming ou ArchiveStreaming) utilizando o token de vídeo gerado.

8. Obtenha um URL RTSP a partir do SDK e utilize-o para reproduzir o vídeo num reprodutor compatível.

9. Mantenha a sessão atualizando os tokens da sessão e do vídeo antes que estes expirem.

Métodos de autenticação

Ajax Video SDK suporta dois métodos de autenticação:

• Autenticação do utilizador — requer o início de sessão e fornece um token de sessão e um token de atualização.

• Token da empresa — permite o acesso sem ser necessário iniciar sessão, utilizando um token pré-emitido.

O acesso às transmissões de vídeo depende das permissões associadas ao utilizador ou à empresa autenticados. As permissões são validadas no lado de Ajax Cloud. Se o utilizador ou a empresa não tiverem acesso a um canal específico, não será possível obter a respetiva transmissão.

O método de autenticação define como os pedidos de API são autorizados e quais os endpoints utilizados.

Gestão de tokens

Os tokens utilizados em Ajax Video SDK têm uma validade limitada e devem ser atualizados:

• Token de sessão — deve ser atualizado periodicamente (aproximadamente a cada 30 minutos).

• Token de vídeo — deve ser atualizado durante uma transmissão ativa através da ligação gRPC.

A falha na atualização dos tokens pode resultar na interrupção da transmissão de vídeo.

Fluxo de transmissão de vídeo

O processo de transmissão de vídeo é o seguinte:

App → REST API → SDK (gRPC) → RTSP → Reprodutor de vídeo.

Ajax Video SDK gere a comunicação com os serviços Ajax e fornece um endpoint de transmissão local, enquanto a app é responsável pela reprodução.

O número de transmissões de vídeo simultâneas é limitado: até 16 transmissões por utilizador e até 2 transmissões por câmara.