RIST¶

media.ingest.rist

Descripción¶

Capture MPEG-TS por RIST con recuperación de pérdidas mediante retransmisión. Se admiten Simple Profile y Main Profile.

Configuración¶

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

streams:
- name: source1
  inputs:
  - rist:
      host: 0.0.0.0
      port: 5000
      profile: simple
      buffer_ms: 1000

Parámetros¶

Parámetro	Descripción
`host`	dirección local o grupo multicast
`port`	puerto par de medios Simple Profile.
`buffer_ms`, `reorder_ms`, `max_retries`	`buffer_ms` (1000), `reorder_ms` (70), `max_retries` (7) controlan recuperación.
`peer_timeout_ms`	espera de la fuente.
`multicast_interface`	interfaz del grupo.
`profile`	`simple` o `main`.
`tunnel_port`, `tunnel_role`, `encryption_passphrase`, `allow_insecure_encryption`	Main usa `tunnel_port`, `tunnel_role` (`client`/`server`, entrada `server` por defecto), `encryption_passphrase`, `allow_insecure_encryption` (`false` por defecto).

Autenticación¶

Main Profile admite PSK compartida mediante encryption_passphrase. Simple Profile no proporciona cifrado.

Opciones de transporte¶

Simple Profile — RTP en puerto par P, RTCP en P+1.
Main Profile — túnel GRE en tunnel_port.
ARQ — retransmisión dentro del presupuesto del búfer.

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¶

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.

Rist¶

Campo	Tipo
`incoming_packets`	`counter`
`incoming_lost_packets`	`counter`
`incoming_recovered_packets`	`counter`
`incoming_unrecovered_packets`	`counter`
`incoming_duplicate_packets`	`counter`
`incoming_retransmitted_packets`	`counter`
`incoming_reordered_packets`	`counter`
`incoming_late_packets`	`counter`
`incoming_invalid_datagrams`	`counter`
`incoming_foreign_ssrc_packets`	`counter`
`incoming_foreign_profile_packets`	`counter`
`incoming_undecryptable_packets`	`counter`
`incoming_encryption_mismatch_packets`	`counter`
`source_restarts`	`counter`
`outgoing_nak_packets`	`counter`
`outgoing_packets`	`counter`
`outgoing_bytes`	`counter`
`outgoing_retransmitted_packets`	`counter`
`incoming_nak_packets`	`counter`
`retransmits_denied_cache`	`counter`
`retransmits_denied_rate`	`counter`
`cache_evicted_by_ceiling`	`counter`
`tunnel_keepalives_sent`	`counter`
`tunnel_keepalives_received`	`counter`
`tunnel_discarded_unknown_version`	`counter`
`tunnel_discarded_bad_encapsulation`	`counter`
`tunnel_discarded_unroutable`	`counter`
`tunnel_discarded_queue_full`	`counter`
`tunnel_discarded_foreign_profile`	`counter`
`rtt_us`	`gauge`
`tunnel_up`	`gauge`
`tunnel_silence_ms`	`gauge`
`tunnel_streams`	`gauge`
`tunnel_insecure_iv_allowed`	`gauge`
`memory_bytes`	`gauge`

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`
`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.