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

• 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.
• A API exige autenticação HTTP Basic com um usuário da interface web do Alta. Saiba mais em Usuários.

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.

Nota

Envie / no id como está ou codificado em URL como %2F.

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

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

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

Nota

Um intervalo de tempo vazio é indicado com 404, não com um array vazio. Trate 404 na requisição de listagem como “nenhum arquivo”.

Solução de problemas

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 start ou 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

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/