Criação e gestão de um stream¶

Um stream é o que você entrega ao espectador: fontes, processamento, arquivo e reprodução sob um mesmo nome. O central guarda a configuração do stream; o stream roda em um streamer — em qual, o central decide sozinho. Esta página percorre o ciclo de vida: criar, encontrá-lo na lista e ler seu estado, editar, desabilitar, excluir.

Crie um stream¶

Na tela Streams, digite um nome em Nome do novo stream e pressione Criar. O stream é criado já habilitado e sua página se abre — ele ainda não tem fontes; adicioná-las é o próximo passo.

O nome também é um endereço: ele entra na URL de reprodução, /streaming/v/<nome>/index.m3u8. Use letras latinas, dígitos, hífen e sublinhado; espaços e caracteres especiais não têm lugar em uma URL.

O caminho completo de uma instalação vazia até um stream tocando está no Início rápido.

Encontre-o na lista¶

A tela Streams mostra todos os streams da instalação, uma linha por stream; as estatísticas são relidas a cada poucos segundos. O campo Pesquisar por nome filtra a tabela enquanto você digita.

Na cadeia de fontes a cor do ponto é a saúde da entrada:

• Verde — a fonte está funcionando.
• Verde vazado — uma reserva verificada.
• Amarelo — a fonte degradou.
• Vermelho — a fonte está morta.
• Cinza vazado — ainda não verificada.

A entrada ativa leva um anel. O clique em uma célula leva à aba correspondente do stream: a cadeia — às fontes, o selo de layout — ao layout, DVR — ao arquivo, o número de espectadores — às sessões.

A coluna Layout responde «os streamers executaram a decisão de alocação?»:

• aplicado — sim;
• entregando — decidido, ainda sem confirmação;
• desatualizado — um streamer ainda roda uma versão antiga;
• rejeitado — um streamer recusou, a razão está na dica;
• sem alocação — nenhum streamer recebeu o stream.

A decisão em si — qual stream roda em qual streamer — é do layouter; a página dele mostra quando foi o último recálculo, como terminou e por que o stream está exatamente onde está.

Status¶

• Verde — no ar: a fonte está capturada, o streamer serve o stream.
• Amarelo — um estado transitório: o stream está habilitado mas o stream ainda não partiu — por exemplo, acabou de ser criado ou espera a alocação.
• Vermelho — o stream não consegue tocar: nenhuma de suas fontes entrega dados.
• Cinza — o stream está desabilitado.

À parte do indicador está o destaque âmbar da linha inteira: o stream está vivo mas não roda como planejado — a entrada ativa degradou, ou o stream caiu da fonte principal para uma de prioridade menor. Um ponto vermelho no início da cadeia de fontes é a principal que caiu. Como a comutação funciona e como ajustá-la está na página de reserva de fontes.

Como as edições se aplicam¶

Um clique no nome do stream abre sua página: abas com as configurações e, no cabeçalho, Salvar, Cancelar, Excluir.

• As edições em quaisquer abas se acumulam no navegador até você salvar. Uma aba com alterações não salvas leva um ponto.
• Salvar só fica ativo quando há alterações, e as envia todas de uma vez. Se algum valor não passa na validação, a página nomeia o campo exato, e nada é aplicado.
• Cancelar desfaz tudo o que não foi salvo.
• Uma configuração salva não entra em vigor na hora: o central a entrega ao streamer, e alguns segundos depois o stream roda do jeito novo.

Enquanto você não tem edições não salvas, a página relê a configuração do central a cada poucos segundos — uma mudança feita por um colega aparece sozinha. A sincronização em segundo plano nunca sobrescreve suas edições não salvas.

Desabilite sem excluir¶

O interruptor Habilitado mora na aba de configurações básicas. Um stream desabilitado para: as fontes não são capturadas, os espectadores não recebem nada, e na lista o stream aparece cinza. A configuração fica intacta — habilite de novo e o stream sobe igual.

O interruptor é uma edição como qualquer outra: sem Salvar o stream continua rodando.

Exclua¶

O botão Excluir no cabeçalho da página do stream, com confirmação. O central remove o stream da configuração, o streamer para de capturar e de servir. A parada não é instantânea: por mais alguns segundos o streamer ainda pode servir o stream enquanto encerra.

O que vem depois¶

• Modelos de streams — levar os ajustes comuns de transcodificador e arquivo para valores padrão em vez de editar cada stream.
• Diagnóstico da fonte — como ler a saúde da entrada, a deriva da linha do tempo e os erros da fonte.