Este guia detalha algumas das operações realizadas em segundo plano pelo serviço VOD / AOD da Infomaniak.

Funcionamento das requisições SOAP e dos callbacks

No serviço de VOD (vídeo sob demanda) e AOD (áudio sob demanda), algumas operações, como o download de arquivos, são realizadas por meio de requisições SOAP, um protocolo que permite que dois sistemas se comuniquem, frequentemente utilizado para trocar dados entre servidores.

Quando um arquivo é solicitado via SOAP, pode haver um atraso antes que o servidor responda. Esse atraso depende de vários fatores, como o tamanho do arquivo, a carga do servidor ou a qualidade da conexão. O download é iniciado o mais rápido possível, mas é importante saber que existe uma fila de espera: se vários usuários fizerem solicitações ao mesmo tempo, cada uma será processada em ordem, e cada usuário tem um limite de downloads simultâneos.

Callback: uma notificação ao final do download

Um callback é um sistema que permite notificar o cliente (por exemplo, sua aplicação) assim que o download for concluído. Em outras palavras, em vez de aguardar monitorando o download, o sistema "chama" ou envia uma resposta quando tudo estiver pronto. Isso é útil para evitar que sua aplicação fique bloqueada enquanto o arquivo é baixado.

No entanto, também existe um tempo máximo de espera, chamado timeout. Se este tempo for atingido antes do término do download, uma resposta é enviada mesmo assim. Isso não significa que o download falhou, mas sim que a resposta foi dada antes que ele fosse concluído. Nesse caso, o processamento continua em segundo plano.

Arquivos grandes demoram mais

Quando o arquivo solicitado é grande (por exemplo, várias centenas de megabytes ou até mesmo vários gigabytes), o download pode demorar vários minutos. Esse tempo depende muito do servidor remoto: alguns são muito rápidos, outros menos. O sistema tenta gerenciar isso da melhor forma possível, mas é importante ter em mente que o tempo de resposta nem sempre será imediato.

Chamadas bloqueantes e não bloqueantes

Por padrão, alguns clientes SOAP esperam que o servidor termine de responder antes de continuar. Nesse caso, fala-se em uma chamada bloqueante: sua aplicação fica inativa até que a resposta chegue. Isso pode ser problemático se a resposta demorar.

Felizmente, é frequentemente possível configurar o cliente SOAP para que ele não bloqueie. Nesse caso, fala-se em uma chamada não bloqueante. Isso permite enviar várias solicitações uma após a outra sem ter que esperar pela resposta de cada chamada. É mais rápido e mais eficiente, especialmente quando você processa vários arquivos em sequência.