Catálogo VOD¶

A seção VOD é um catálogo de assets do cluster: arquivos que ficam nos streamers e tocam sob demanda. Ao contrário de um stream, um asset não tem fonte nem alocação pelo layouter; ele simplesmente fica onde foi enviado e é servido dali.

São quatro abas: Catálogo, Uploads, Armazenamentos e Tokens de upload. Esta página trata do catálogo; o envio e o armazenamento estão em Uploads de VOD.

Para que o catálogo tenha onde morar, o streamer precisa de ao menos um root VOD — ele é definido nas configurações do streamer.

Asset, chave e arquivos¶

A unidade do catálogo é o asset. Um asset tem:

• Chave — o nome em forma de caminho pelo qual ele é encontrado: movies/2026/blade.mp4. As chaves formam pastas, e o catálogo as mostra como uma árvore.
• Asset id — um identificador imutável. A chave pode ser renomeada, o asset id não, então os links por asset id sobrevivem a uma renomeação.
• Revisão — aumenta a cada mudança no conjunto de arquivos.
• Arquivos — um asset pode ser composto de vários arquivos: vídeo e faixas de áudio separadas, por exemplo.

As colunas da lista são Nome, Status, Arquivos, Tamanho, Asset id, Atualizado. O status é reproduzível ou não reproduzível: um asset cuja media info não pôde ser lida é servido apenas como arquivo raw.

A árvore mostra no máximo 1000 pastas por nível — em uma lista mais longa ela informa Mostradas as primeiras 1000 pastas — refine com o filtro. O campo Filtrar este nível… filtra o nível atual, e Carregar mais traz mais assets.

Onde um asset está¶

O bloco Placement mostra quais armazenamentos têm o asset e em que revisão:

• origin — a alocação primária, onde o asset foi enviado.
• replica — uma cópia em outro armazenamento.

Ao lado pode aparecer armazenamento indisponível. Significa exatamente o que a dica diz: Reprodução 503; a exclusão funciona, a limpeza fica adiada. Ou seja, o catálogo continua gerenciável mesmo enquanto a máquina com os arquivos está fora.

Arquivos do asset¶

A tabela de arquivos: Arquivo, Tamanho, Media info, Hash, Ações. Um arquivo cuja media info não pôde ser lida é marcado como media error e fica disponível como arquivo raw.

Copiar hash copia a soma de verificação do arquivo. O botão Reproduzir e os botões HLS, DASH e RAW são explicados abaixo.

Reproduzir um arquivo¶

O botão Reproduzir da coluna Ações abre um player dentro da própria console — sobre o cartão, sem sair do catálogo. Fecha-se com Esc ou com o xis do canto.

O endereço da página muda junto com o player aberto, então o link pode ser enviado a um colega: ele cai direto nesse arquivo.

Os botões HLS, DASH e RAW copiam o link de reprodução do tipo correspondente — cole-o no seu próprio player, set-top box ou analisador. O link copiado já carrega um ticket de admissão temporário e toca como está: a reprodução é fechada por padrão, e esse ticket vive algumas horas e serve para uma única exibição. Para a sua vitrine emita os seus próprios tickets — veja Tickets do Catena.

Os endereços são montados a partir do asset id e do nome do arquivo:

No endereço está o asset id, não a chave, então renomear não quebra esses links.

A verificação mais rápida de que o arquivo é entregue é a sua playlist:

curl -s 'http://<endereço>/playback/vod/<asset id>/<arquivo>/index.m3u8?token=<ticket>' | head

• Uma playlist com qualidades (#EXT-X-STREAM-INF) — o arquivo está analisado e toca.
• 403 — não há ticket, ou ele não cobre este asset.
• 404 — não existe esse asset, ou esse arquivo dentro dele.

Um arquivo cuja media info não pôde ser lida não é oferecido para reprodução: ele tem apenas RAW.

Renomear a chave¶

Renomear chave muda apenas os metadados: os arquivos ficam onde estão; os links salvos por AssetId continuam funcionando. Renomear uma pasta reescreve de uma vez os prefixos de todas as chaves abaixo dela. Se a nova chave já estiver ocupada, a operação é recusada — Esta chave já está ocupada.

Exclusão¶

Dá para excluir em três níveis:

• Excluir arquivo — um arquivo sai do asset e a revisão do asset aumentará. Se era o último, o asset é excluído junto.
• Excluir asset — com uma confirmação que informa a quantidade de arquivos.
• Excluir pasta — todos os assets sob aquele prefixo. O console primeiro reúne a lista (Reunindo assets: N), depois os enfileira e mostra o andamento: Excluindo assets: N/N, N com erro, Excluídos N assets.

A exclusão sempre age sobre o catálogo, não sobre o disco: a mensagem Removido do catálogo — a limpeza no nó ficou adiada significa que o registro some na hora, enquanto os arquivos são retirados pelo streamer quando ele puder. É justamente por isso que a exclusão está disponível mesmo com um armazenamento indisponível.

O que vem depois¶

• Uploads de VOD — como enviar arquivos, onde ver os armazenamentos e como emitir um token de upload para um portal.