MPEG-TS¶

media.ingest.mpegts

Descripción¶

Capture MPEG-TS por UDP unicast o multicast. Seleccione un programa MPTS con program. Véase TSHTTP para MPEG-TS por HTTP.

Configuración¶

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

streams:
- name: source1
  inputs:
  - udp:
      host: 239.0.0.1
      port: 5000
      program: 101
      peer_timeout_ms: 5000

Parámetros¶

Campo	Descripción
`host`, `port`	dirección y puerto de recepción; use el grupo para multicast.
`program`	programa; si se omite, se toma el primero con medios.
`source`	emisor SSM IPv4.
`interface`	interfaz multicast.
`recv_buffer_bytes`	búfer (4 MiB por defecto).
`peer_timeout_ms`	espera sin datos.

Opciones de transporte¶

UDP unicast.
UDP multicast IPv4/IPv6 — suscripción IGMP/MLD.
SSM IPv4 — filtro del emisor con source.

Códecs admitidos¶

H.264
HEVC / H.265
AV1
JPEG 2000
MPEG-2 Video
AAC (ADTS)
AC-3
E-AC-3
MPEG Audio (Layer II / III)
SMPTE ST 302M

MPEG-TS es el contenedor; SRT, RIST, UDP y HTTP son transportes de entrega. La lista describe la extracción de frames de MPEG-TS, no su decodificación ni la compatibilidad del reproductor.

AV1 requiere stream_type 0x06 y el descriptor de registro AV01 en la PMT; cada PES debe contener un temporal unit completo. No se admite AV1 en MPEG-TS sin esta señalización. AAC se analiza como ADTS; reconocer stream_type 0x11 no implica compatibilidad con LATM. Opus se puede identificar en la PMT, pero el analizador PES actual no emite sus frames.

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¶

Cambiar dirección o programa reconecta la entrada. recv_buffer_bytes actualiza el socket UDP compartido en vivo; prevalece el último valor explícito de los streams que lo usan. peer_timeout_ms cambia sin desconectar.

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.

Mpegts¶

Campo	Tipo
`bytes`	`counter`
`sync_bytes`	`counter`
`packets`	`counter`
`frames`	`counter`
`errors`	`counter`
`errors_ts_pat`	`counter`
`errors_ts_service_lost`	`counter`
`broken`	`counter`
`low_recv_buffer_secs`	`counter`
`recv_buffer_granted_bytes`	`gauge`
`recv_buffer_requested_bytes`	`gauge`
`recv_buffer_required_bytes`	`gauge`
`recv_buffer_drops`	`counter`
`memory_bytes`	`gauge`

MpegtsPid¶

Campo	Tipo
`pid`	`label`
`pnr`	`label`
`packets`	`counter`
`frames`	`counter`
`empty_packets`	`counter`
`errors_adaptation_broken`	`counter`
`errors_ts_scrambled`	`counter`
`errors_ts_pmt`	`counter`
`errors_ts_cc`	`counter`
`errors_ts_tei`	`counter`
`errors_ts_psi_checksum`	`counter`
`errors_pid_lost`	`counter`
`broken_pes_count`	`counter`
`broken_pes_sum`	`counter`
`time_corrections`	`counter`
`corrected_backward_pts`	`counter`
`discarded_buffer_count`	`counter`
`discarded_buffer_sum`	`counter`
`fillers_count`	`counter`
`fillers_sum`	`counter`
`unpaired_fields`	`counter`
`warning_invalid_sibling_frames`	`counter`
`padding_pes_count`	`counter`
`padding_pes_sum`	`counter`
`orphan_pes_count`	`counter`
`dts_goes_backwards`	`counter`
`dts_jump_forward`	`counter`
`too_large_dts_jump`	`counter`
`pcr_resync`	`counter`
`pcr_jitter_ok_0`	`counter`
`pcr_jitter_ok_500ns`	`counter`
`pcr_jitter_fail_500us`	`counter`
`pcr_jitter_fail`	`counter`
`hrd_buffer_min`	`gauge`
`hrd_buffer_max`	`gauge`
`hrd_buffer_underrun`	`counter`
`ad_marks`	`counter`
`errors_ad_marks_dropped`	`counter`
`warning_ad_mark_descriptors_dropped`	`counter`

Otros detalles¶

Además del vídeo y el audio, MPEG-TS transporta:

Teletexto DVB.
Metadatos KLV.
Marcadores SCTE-35.
Descriptores de idioma y subtítulos DVB de la PMT.