SRT¶
media.ingest.srt
Descripción¶
Sapsan se conecta a un servidor SRT remoto y captura MPEG-TS en modo caller. La entrada abre un puerto UDP local efímero, independiente de listeners y de los puertos de publicación. host y port identifican el servidor remoto. Véase Publicación SRT para conexiones entrantes.
Configuración¶
Configure el stream mediante la API de central. Fragmento de configuración:
streams:
- name: source1
inputs:
- srt:
host: origin.example.com
port: 9000
stream_id: '#!::r=studio,m=request'
latency_ms: 120
peer_timeout_ms: 5000
Parámetros¶
| Parámetro | Descripción |
|---|---|
host |
IP o DNS del servidor remoto |
port |
su puerto UDP. |
stream_id |
stream_id se envía al conectar. |
passphrase |
contraseña de cifrado acordada. |
latency_ms |
latencia de recepción y presupuesto de recuperación. |
handshake_timeout_ms |
tiempo de conexión |
peer_timeout_ms |
espera sin datos. |
Autenticación¶
passphrase debe coincidir con el emisor. El servidor remoto define el formato de stream_id, incluido el token de acceso si lo requiere.
Opciones de transporte¶
-
UDP — conexión cliente al listener SRT remoto.
-
ACK/ACKACK — confirmación de entrega.
-
NAK/ARQ — solicitudes de retransmisión y recuperación.
-
Búfer de latencia — ordenación de paquetes.
-
Too-late drop — descarte de paquetes tardíos.
-
Keepalive — supervisión de la conexión.
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¶
El cambio de dirección, puerto, passphrase o stream_id reinicia la fuente; el cambio de solo los tiempos de espera se aplica en caliente.
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.
Srt¶
| Campo | Tipo |
|---|---|
incoming_bytes |
counter |
outgoing_bytes |
counter |
incoming_packets |
counter |
outgoing_packets |
counter |
incoming_lost_packets |
counter |
outgoing_lost_packets |
counter |
incoming_retransmitted_packets |
counter |
outgoing_retransmitted_packets |
counter |
incoming_recovered_packets |
counter |
missing_packets |
counter |
incoming_ack_packets |
counter |
outgoing_ack_packets |
counter |
incoming_ackack_packets |
counter |
outgoing_ackack_packets |
counter |
incoming_drop_request |
counter |
incoming_drop_requests |
counter |
outgoing_drop_requests |
counter |
incoming_nak_packets |
counter |
outgoing_nak_packets |
counter |
outgoing_drop_too_late_packets |
counter |
incoming_drop_late_seq |
counter |
incoming_drop_late_time |
counter |
incoming_drop_far_time |
counter |
incoming_drop_too_late |
counter |
incoming_drop_buffer_full |
counter |
loss_tracking_overflows |
counter |
keepalive_timeouts |
counter |
receive_buffer_size |
gauge |
send_buffer_size |
gauge |
rtt_us |
gauge |
rtt_var_us |
gauge |
source_clock_drift_us |
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.