Obter o preview MP4 do arquivo com a API
Quando Save Preview está ativado nas configurações de Armazenamento, o Alta salva pequenos clipes de preview em formato MP4 para o arquivo gravado. Este artigo descreve como listar os arquivos de preview de um canal e baixá-los com curl.
Requisitos
Seção intitulada “Requisitos”- O Canal tem um Armazenamento atribuído e o armazenamento tem Save Preview ativado.
- O Canal usa vídeo H.264 ou H.265.
- As requisições vão para o API Server (porta padrão
8100), não para o OTT Server. Saiba mais em Servidor HTTP. - As requisições precisam das credenciais de um usuário do Alta: HTTP Basic, como nos exemplos abaixo, ou um Bearer token. Saiba mais em HTTP API. As funções
admineobserverpodem ler os previews.
Caminho do canal
Seção intitulada “Caminho do canal”Ambas as requisições usam o parâmetro id com o caminho do canal no formato <channel_name>/<variant>, por exemplo discovery/hd.
Listar arquivos de preview
Seção intitulada “Listar arquivos de preview”URL:
GET /api/ott/channel/storage/preview?id=<channel_name>/<variant>ou com o parâmetro opcional:
GET /api/ott/channel/storage/preview?id=<channel_name>/<variant>&start=<time>- id: Caminho do canal.
- start (opcional): Timestamp Unix. Retorna os arquivos a partir desse momento.
O Alta não oferece suporte ao parâmetro end. Para limitar o resultado pelo horário final, filtre a lista no lado do cliente.
Exemplo:
curl -sS -u 'USER:PASSWORD' \ 'http://alta.example.com:8100/api/ott/channel/storage/preview?id=discovery/hd&start=1747485787'Resposta:
["1747485787.mp4", "1747485797.mp4", "1747485807.mp4"]A resposta é um array JSON com nomes de arquivos. O nome de cada arquivo é o timestamp Unix do início do segmento.
Baixar arquivo de preview
Seção intitulada “Baixar arquivo de preview”URL:
GET /api/ott/channel/storage/preview?id=<channel_name>/<variant>&name=<file>- id: Caminho do canal.
- name: Nome do arquivo da lista, por exemplo
1747485787.mp4.
Exemplo:
curl -sS -f -u 'USER:PASSWORD' \ -o preview.mp4 \ 'http://alta.example.com:8100/api/ott/channel/storage/preview?id=discovery/hd&name=1747485787.mp4'O corpo da resposta é o arquivo MP4. A opção -f faz o curl falhar em erros HTTP, em vez de salvar a página de erro no arquivo.
Códigos de resposta
Seção intitulada “Códigos de resposta”| Código | Descrição |
|---|---|
200 | Sucesso |
404 | Nenhum arquivo de preview encontrado para o canal ou o intervalo de tempo, ou o arquivo não existe |
Solução de problemas
Seção intitulada “Solução de problemas”Lista vazia ou 404
Seção intitulada “Lista vazia ou 404”- Verifique se Save Preview está ativado no armazenamento e se o canal está gravando.
- Verifique o caminho do canal. Ele deve incluir a variante, por exemplo
discovery/hd. - Remova o parâmetro
startou diminua o valor dele. Os arquivos de preview ficam disponíveis apenas durante o período de retenção do arquivo no armazenamento.
Conexão recusada
Seção intitulada “Conexão recusada”Verifique se você usa a porta do API Server, não a do OTT Server. Teste a conexão:
curl -v http://alta.example.com:8100/