Gestão de episódios¶

media.episodes.management

Um episódio vincula um evento a um stream e a um tempo do vídeo. media.episodes.management abrange gestão, armazenamento e acesso a episódios; é uma função por stream da grade tarifária existente.

O central armazena o estado mais recente do episódio e suas imagens no PostgreSQL. O coletor recebe atualizações dos streamers; a API de gestão lê o histórico salvo sem precisar que o streamer de origem esteja disponível. O payload de origem e as anotações externas em meta são armazenados separadamente.

Leitura¶

GET /central/api-v4/episodes retorna uma seleção conjunta; GET /central/api-v4/episodes/{episode_id} lê um episódio. Os filtros de stream, tipo e tempo se combinam com o filtro JSON meta. Siga next_cursor; o limite padrão é 100 e o máximo é 1000. Offset é proibido.

O acesso de espectadores usa /playback/v/{stream_name}/episodes no central e /streaming/v/{stream_name}/episodes em um streamer. O central fornece o histórico salvo; o streamer, sua janela atual em memória. Aplicam-se as permissões e os tokens de reprodução habituais do stream. Ler episódios e imagens não cria nem renova uma sessão de visualização.

Para exemplos de criação, atualização de meta e busca, consulte o manual do Optic. A retenção é descrita em Arquivo de episódios.