M4F2¶

media.ingest.m4f

Descripción¶

Se admiten los protocolos anteriores M4F/M4S y el nuevo M4F2 para capturar de otros servidores Flussonic. M4F2 maneja pistas de forma independiente, transfiriendo las necesarias y reduciendo el tráfico entre servidores. La entrega conserva la línea temporal y la descripción de pistas.

Configuración¶

Configure el stream mediante la API de central. Fragmento de configuración:

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

Parámetros¶

Parámetro	Descripción
`m4f.url`, `m4s.url`, `m4f2.url`	`m4f.url`, `m4s.url`, `m4f2.url` identifican la versión de la fuente.
`cluster_key`	M4F/M4S anteriores usan `cluster_key` para la clave compartida.
`via_agent`	M4S y M4F2 admiten `via_agent` para conectarse mediante `agent://ID`.

Autenticación¶

M4F/M4S envían cabeceras cluster-auth-* con la clave compartida. M4F2 propaga los parámetros de consulta, incluido token, a las solicitudes.

Opciones de transporte¶

M4F — captura de segmentos anterior.
M4S — captura de fotogramas anterior.
M4F2 — catálogo y solicitudes independientes de fragmentos/partes de pistas por HTTP; m4f2s:// usa HTTPS.

Códecs admitidos¶

M4F/M4S heredados:

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

La lista enumera los frames de audio y vídeo que el analizador M4F/M4S heredado extrae mediante los nombres de códec de las pistas. M4F es un contenedor propio, no otro nombre de fMP4 ni un códec. La fuente debe declarar correctamente el códec y su configuración; recibir frames no implica compatibilidad de decodificación ni que el protocolo de salida admita todos esos códecs.

M4F2: las descripciones de pistas se leen de segmentos de inicialización fMP4 y los frames de fragmentos y partes separados. Se aplica el conjunto de códecs fMP4. Esta ruta no admite VP9, JPEG 2000, MJPEG ni PCM sin comprimir de la lista M4F/M4S heredada. Conservar la línea temporal y los límites de fragmentos de la fuente no amplía las sample entries admitidas.

Comportamiento ante errores¶

El estado de la entrada y la causa del fallo están en las estadísticas del stream. Ante desconexión o ausencia de fotogramas se aplican los mecanismos de reintento y conmutación a reserva.

Aplicación de cambios¶

Aplique los cambios mediante la API de central. Cambiar la dirección o el formato vuelve a abrir la captura y puede interrumpirla durante la conexión. Compruebe después el estado y la llegada de fotogramas.

Contadores¶

Las tablas indican los nombres exactos de los campos de estadísticas del protocolo, incluidos contadores de eventos e indicadores del valor actual. Los campos nulos pueden omitirse. API y Prometheus exponen proyecciones distintas; un único resultado de Admin API no incluye necesariamente toda la lista. El detalle depende de la licencia de contadores.

Totales comunes de entrada: bytes, frames, errors, warnings. Agregan datos del protocolo; no deben sumarse otra vez a los contadores del protocolo.

M4f2¶

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

Otros detalles¶

M4F2 no exige enviar todas las calidades de vídeo a cada consumidor. Las solicitudes independientes permiten obtener solo las calidades y pistas de audio necesarias, sin transcodificar.