M4F2¶

media.ingest.m4f

Descrição¶

São compatíveis os protocolos anteriores M4F/M4S e o novo M4F2 para captura de outros servidores Flussonic. M4F2 trata trilhas independentemente, transferindo as necessárias e reduzindo o tráfego entre servidores. A entrega preserva a linha do tempo e a descrição das trilhas.

Configuração¶

Configure o stream pela API do central. Trecho de configuração:

streams:
- name: source1
  inputs:
  - m4f2:
      url: m4f2://origin.example.com/studio?token=ACCESS_TOKEN

Parâmetros¶

Parâmetro	Descrição
`m4f.url`, `m4s.url`, `m4f2.url`	`m4f.url`, `m4s.url`, `m4f2.url` identificam a versão da fonte.
`cluster_key`	M4F/M4S anteriores usam `cluster_key` para a chave compartilhada.
`via_agent`	M4S e M4F2 aceitam `via_agent` para conexão por `agent://ID`.

Autenticação¶

M4F/M4S enviam cabeçalhos cluster-auth-* com a chave compartilhada. M4F2 propaga os parâmetros de consulta, incluindo token, nas requisições.

Opções de transporte¶

M4F — captura anterior de segmentos.
M4S — captura anterior de quadros.
M4F2 — catálogo e requisições independentes de fragmentos/partes das trilhas por HTTP; m4f2s:// usa HTTPS.

Codecs compatíveis¶

M4F/M4S legados:

H.264
HEVC / H.265
AV1
VP9
MPEG-2 Video
MJPEG / JPEG
JPEG 2000
AAC
AC-3
E-AC-3
MPEG Audio (Layer II / III)
Opus
G.711 A-law / μ-law
PCM

A lista enumera os frames de áudio e vídeo que o analisador M4F/M4S legado extrai pelos nomes de codec das faixas. M4F é um contêiner próprio, não outro nome para fMP4 nem um codec. A fonte deve declarar corretamente o codec e sua configuração; receber frames não implica suporte à decodificação nem que o protocolo de saída aceite todos esses codecs.

M4F2: as descrições de faixas são lidas dos segmentos de inicialização fMP4 e os frames de fragmentos e partes separados. Aplica-se o conjunto de codecs fMP4. Esse caminho não aceita VP9, JPEG 2000, MJPEG nem PCM sem compressão da lista M4F/M4S legada. Preservar a linha do tempo e os limites de fragmentos da fonte não amplia as sample entries aceitas.

Comportamento em caso de erro¶

O estado da entrada e a causa da falha estão nas estatísticas do stream. Desconexão ou ausência de quadros usa os mecanismos de repetição e comutação para reserva.

Aplicação de alterações¶

Aplique as alterações pela API do central. Alterar o endereço ou o formato reabre a captura e pode interrompê-la durante a conexão. Verifique depois o estado e a chegada de quadros.

Contadores¶

As tabelas mostram os nomes exatos dos campos de estatísticas do protocolo, incluindo contadores de eventos e indicadores do valor atual. Campos zerados podem ser omitidos. API e Prometheus expõem projeções diferentes; uma única resposta da Admin API não contém necessariamente toda a lista. O detalhe depende da licença de contadores.

Totais comuns da entrada: bytes, frames, errors, warnings. Eles agregam dados do protocolo; não devem ser somados novamente aos contadores do protocolo.

M4f2¶

Campo	Tipo
`version`	`gauge`
`bytes`	`counter`
`frames`	`counter`
`parts`	`counter`
`fragments`	`counter`
`fragments_from_parts`	`counter`
`part_sets_broken`	`counter`

Outros detalhes¶

M4F2 não exige enviar todas as qualidades de vídeo a cada consumidor. Requisições independentes permitem obter apenas as qualidades e trilhas de áudio necessárias, sem transcodificação.