Transcodificação e MBR¶

O transcodificador resolve dois problemas do cliente. O primeiro é o multi-bitrate: espectadores com link fraco recebem 360p, os com link bom — 1080p, e o reprodutor alterna entre eles em tempo real. O segundo é a compatibilidade: uma entrada que os reprodutores não leem (quadros brutos, áudio que não é AAC) vira algo que todos leem.

Tudo é configurado na aba Transcodificador da página do stream. Enquanto o transcodificador está desligado, a entrada passa intacta — e para uma fonte já comprimida em h264/aac isso pode ser exatamente o certo: transcodificar custa CPU, e não há razão para queimá-la sem causa.

Comece com um preset¶

A aba vazia oferece três presets — cada um fecha uma tarefa típica com um clique:

• Corrigir áudio (vídeo como está + AAC) — o vídeo não é recodificado, o áudio é levado a AAC. O jeito mais barato de tornar um stream compatível quando a fonte entrega áudio fora do padrão.
• Escada padrão 1080/720/360 + AAC — um conjunto ABR pronto para a transmissão típica.
• RAW para SDI (v210) — saída sem compressão para uma cadeia SDI/2110 de estúdio.

Um preset é um ponto de partida: ele preenche a escada e as regras, que depois você edita. Não esqueça de Salvar.

A escada de qualidades¶

O bloco Vídeo (escada) — um degrau por qualidade de saída:

• Altura — 2160, 1080, 720, 576, 360 ou personalizada. A largura segue as proporções da entrada.
• Codec — H.264, HEVC, AV1; «Como está» é passthrough sem recodificação; os codecs RAW são para saída SDI.
• Bitrate (kbps) e Rate control — CBR para banda previsível, VBR para melhor qualidade na mesma média.

O degrau Original (sem transcodificação) passa a entrada para a escada como está. Ao lado de degraus codificados ele degrada a escada — seu GOP e seus quadros IDR não estão alinhados com os demais, e a troca fluida de qualidades quebra; a interface avisa com uma faixa.

O GOP é uma propriedade da escada inteira, não de um degrau: para o reprodutor trocar de qualidade sem solavanco, os keyframes de todos os degraus devem coincidir. O cabeçalho da escada leva o Comprimento do GOP (em quadros) e a Estrutura do GOP (de ip sem B-frames a ibbbbp). GOP mais curto — partida mais rápida e menor atraso de troca; mais longo — melhor compressão. Se o GOP dos degraus desalinha — após edições manuais, por exemplo — a interface mostra «GOP: difere entre degraus» e o botão Unificar GOP.

Áudio¶

O bloco Áudio guarda as regras de seleção e codificação de trilhas. Em cada regra:

• Quais trilhas — Todas as trilhas, Melhor qualidade, Idioma…, Idioma + codec…, ID exato…
• Codec — Como está, AAC ou Opus, e o bitrate.

O caso multilíngue típico: uma única regra «Todas as trilhas → AAC» — todos os idiomas vão ao ar recodificados.

Ajustes avançados do degrau¶

O botão Mais no degrau revela:

• Estratégia de resize — o que fazer quando as proporções da entrada não batem com a saída: Fit mantém a proporção e adiciona bordas (a cor é configurável), Scale estica, Crop corta.
• Fonte — sobrepor qual trilha de entrada o degrau usa.
• Se nenhuma trilha corresponder — o comportamento quando uma trilha some: pular, silêncio / quadro preto, placeholder SMPTE, ou parar o stream com erro. O placeholder serve a um stream que deve sempre mostrar imagem; a parada — a uma cadeia onde o ar arruinado em silêncio é pior que o ar caído.

Se as regras acabam sem selecionar nada, a aba avisa: «O manifesto está vazio» — esse stream não entrega nada ao espectador.

Codificação: CPU ou GPU¶

A seção Codificação decide o que faz o trabalho. O campo Transcodificar em tem dois valores: CPU e GPU NVIDIA. A dica enuncia a diferença sem rodeios: CPU é o padrão; NVIDIA executa todo o vídeo na GPU — para a placa vai todo o caminho de vídeo, não apenas a codificação.

Ao escolher NVIDIA aparece um campo GPU com as placas que o nó relatou. O valor Auto (menos carregada) escolhe a placa ao iniciar o stream — um stream já em execução não migra para outra placa. Num cluster, o layouter coloca um stream com codificação NVIDIA só num streamer com GPUs — não são precisas etiquetas para isso (Alocação de streams).

Aqui mesmo fica o Preset do codificador; por padrão, veryfast.

Desentrelaçamento¶

Fontes entrelaçadas mostram serrilhado após codificar para progressivo, então um degrau tem um campo Desentrelaçamento com três valores:

• Desativado — os quadros não são tocados.
• Automático (apenas quadros entrelaçados) — são processados apenas os quadros marcados como entrelaçados.
• Forçado (todos os quadros) — são processados todos, com marca ou sem ela. É necessário para fontes que não a colocam.

Logotipo no vídeo¶

O transcodificador «grava» o logotipo do canal ou uma marca d'água no vídeo: a imagem aparece em todos os dispositivos, o arquivo incluído. O logotipo da escada inteira é definido pelo cartão Logotipo da escada; os mesmos campos vivem nos ajustes avançados de cada degrau.

O cartão define o logotipo uma vez para a escada inteira:

• Atribuir — escolher a imagem da biblioteca de logotipos: busca por nome e upload de um arquivo PNG, JPEG ou WebP de até 1 MB.
• Posição no quadro — canto superior esquerdo, superior direito, inferior esquerdo, inferior direito ou centro. Os deslocamentos são contados do canto escolhido para dentro e, no centro, a partir do centro.
• Altura da imagem (…p), px — a altura do logotipo no degrau superior; a largura vem das proporções da imagem. Campo vazio significa o tamanho nativo da imagem, que aparece ao lado da pré-visualização.
• Deslocamento X, Deslocamento Y — os deslocamentos em pixels.

Os valores são dados para o degrau superior e recalculados nos demais na proporção da sua altura: abaixo dos campos dá para ver o que cada degrau vai receber antes de Salvar. Um degrau sem resize toma a altura da entrada. Degraus configurados à mão não são tocados: quando divergem, o cartão mostra «As configurações de logotipo dos degraus diferem» e aplicar um valor comum pede confirmação — ele sobrescreve as configurações individuais.

O logotipo vai só num degrau com codificação: o passthrough («Como está») e os codecs RAW não o têm, e quando um degrau passa a passthrough a interface remove a seção. A imagem — no máximo 1 MB e 4096 pixels por lado. Se a imagem não estiver disponível, o degrau não é montado: um erro com nome aparece no estado da saída enquanto os demais degraus e o stream continuam funcionando.

A biblioteca de logotipos vive no central, com a chave igual ao sha256 dos bytes da imagem: um registro é imutável, e subir os mesmos bytes de novo devolve o registro existente. A imagem viaja para o nó junto com a configuração do stream, então o logotipo funciona num nó que nunca teve o arquivo e sobrevive ao central indisponível. Registros que nenhum stream referencia mais são removidos pela própria biblioteca.

A pré-visualização¶

No pé da aba — Pré-visualização: entrada → saída. Para cada regra dá para ver o que vai parar no manifesto de saída antes de Salvar: qual degrau se monta de quê e se o áudio se perdeu. Quando as estatísticas de entrada não estão disponíveis, o lado esquerdo o diz — entrada desconhecida — e a saída é calculada mesmo assim a partir das regras.

MBR: uma escada sem transcodificação¶

Se a escada de qualidades já está pronta fora — o codificador do local entrega ele mesmo 1080/720/360 — não faz sentido recodificá-la. Para isso existe a fonte MBR: na aba Fontes escolha o protocolo MBR e adicione ao contêiner uma entrada por qualidade pronta. O stream as monta em uma escada única e serve ao espectador um stream multi-bitrate comum — sem gastar um único núcleo em codificação.

O transcodificador e a entrada MBR são dois caminhos para o mesmo resultado: o primeiro queima a CPU do streamer, o segundo — a banda do codificador. A escolha costuma ser ditada pelo que sai mais barato na sua montagem.

Se o transcodificador não funcionou¶

• A escada está configurada, o stream verde, mas não há trilhas de saída. Verifique se os plugins de codificação estão instalados no streamer — dpkg -l | grep sapsan-transcoder. Sem eles o servidor roda mas não tem com o que codificar; veja o Início rápido.
• O reprodutor engasga na troca de qualidade. Olhe as faixas da escada: um degrau passthrough ao lado de codificados, ou um GOP desalinhado — ambas as causas aparecem na própria interface.