HLS / HTTP, RTSP et RTMP¶
Les transports de ce groupe fonctionnent selon le schéma « nœud — client » : la connexion est toujours établie par le nœud lui-même, et non par la partie distante. Ils n’ont donc ni port d’écoute ni choix de mode — au lieu d’une adresse et d’un port, on indique une URL complète. La réception en MPEG-TS et les limitations de chaque source sont décrites dans Autres entrées et sorties et Publication et réception RTMP.
HLS / HTTP¶
L’entrée récupère le MPEG-TS via HTTP : elle analyse soit une playlist HLS et télécharge les segments, soit lit un flux continu dans la réponse du serveur (Entrée HLS / HTTP). Disponible uniquement pour les flux SPTS ; il n’y a pas de sortie de ce type — la diffusion HLS se configure dans l’onglet « OTT » du flux lui-même (OTT et DVR).
Entrée¶
Champ |
Rôle |
Valeurs |
|---|---|---|
URI |
L’adresse de la playlist ou du flux. Seuls les schémas |
|
Login, Password |
Les identifiants HTTP. Le nœud ne les envoie pas d’emblée : une requête ordinaire est d’abord effectuée, et ce n’est qu’en réponse à un 401 que la requête est répétée avec le schéma d’autorisation annoncé par le serveur. Les identifiants sont joints à la playlist comme à chaque segment. La paire ne fonctionne qu’entière : un identifiant avec un mot de passe vide n’est pas utilisé. |
vide par défaut |
Mode |
Comment traiter la réponse du serveur. Auto-detect — d’après le type de contenu : un type de playlist signifie une analyse HLS, tout autre la lecture d’un MPEG-TS continu. HLS — toujours analyser comme une playlist (pour les serveurs qui servent une playlist avec un type de contenu erroné). Plain HTTP / MPEG-TS — toujours lire le flux sans l’analyser. |
Auto-detect (par défaut), HLS, Plain HTTP / MPEG-TS |
Client timeout (s) |
Le délai d’une seule opération réseau — connexion, envoi de la requête et lecture de la réponse — aussi bien pour la playlist que pour chaque segment. Une valeur plus faible accélère le basculement vers l’entrée de secours, une valeur plus élevée est plus tolérante envers une source lointaine ou lente. |
à partir de 1, par défaut 10 |
Adaptive stream id |
Quelle variante prendre dans la playlist maître — d’après l’ordre d’énumération dans la playlist, en comptant à partir de un, et non d’après le débit. Une valeur supérieure au nombre de variantes conduit au choix de la dernière. Pour une playlist ordinaire (non maître), le champ est sans effet. |
à partir de 1, par défaut 1 |
Chunks preloading |
Combien de segments sont téléchargés simultanément. Un signifie un téléchargement strictement séquentiel ; une valeur plus élevée masque la latence de la liaison vers la source et aide à rattraper le retard, mais ouvre autant de connexions parallèles. |
1–10, par défaut 1 |
User-Agent |
La valeur de l’en-tête |
vide par défaut |
Cookies |
Une valeur toute prête de l’en-tête |
vide par défaut |
Disable URL encode |
Envoyer le chemin et les paramètres de requête sous forme décodée. Nécessaire pour les serveurs qui traitent mal l’encodage pourcent dans les liens de la playlist ; pour un serveur correct, l’activation peut au contraire corrompre le lien. |
désactivé par défaut |
Trace |
Journalisation détaillée : chaque requête et son résultat, les redirections, le corps de la playlist, la file d’attente et la taille des segments. Réglage de diagnostic — en fonctionnement normal il est désactivé. |
désactivé par défaut |
Particularités de la réception à connaître lors du diagnostic : les segments doivent être en MPEG-TS (une playlist avec des segments fMP4/CMAF n’est pas acceptée) ; le nœud ne suit pas plus de trois redirections d’affilée ; le certificat du serveur n’est pas vérifié en https.
RTSP¶
L’entrée ouvre une session RTSP, lit les flux élémentaires et les remultiplexe en MPEG-TS (Entrée RTSP). Uniquement pour les flux SPTS ; il n’y a pas de sortie de ce type.
Entrée¶
Champ |
Rôle |
Valeurs |
|---|---|---|
URI (rtsp://…) |
L’adresse complète de la session RTSP. Champ obligatoire. Contrairement à l’entrée HLS, le schéma n’est pas vérifié ici à l’enregistrement — une erreur s’y révélera au démarrage de l’entrée. |
|
Login, Password |
Les identifiants RTSP. Le nœud les insère dans l’adresse de la session, de sorte que c’est ensuite le schéma d’autorisation exigé par la caméra qui s’applique. L’identifiant est utilisé même avec un mot de passe vide. Si l’adresse contient déjà des identifiants, les valeurs de ces champs les remplacent. |
vide par défaut |
Transport |
Le transport RTP au sein de la session. UDP — des datagrammes séparés : latence minimale, sensibilité aux pertes. TCP — RTP à l’intérieur de la connexion de contrôle : traverse le NAT et les pare-feu. HTTP — un tunnel RTSP sur HTTP pour traverser un proxy. |
UDP (par défaut), TCP, HTTP |
Client timeout (s) |
Le temps limite d’une seule opération réseau de la session. À son expiration, une source silencieuse est considérée comme défaillante, et le flux bascule ou se reconnecte. |
à partir de 1, par défaut 10 |
User-Agent, Cookies |
Les valeurs des champs de requête du même nom — pour les appareils qui ne répondent qu’aux clients connus, et pour les sessions liées à un cookie. |
vide par défaut |
Trace |
Journalisation des changements d’état de la session dans le journal du flux. |
désactivé par défaut |
RTMP¶
Le nœud ne travaille avec RTMP et RTMPS qu’en tant que client : l’entrée récupère le flux par URL, la sortie publie le flux vers un point de réception externe. La réception de publications entrantes n’est pas prise en charge (Publication et réception RTMP). Uniquement pour les flux SPTS.
Entrée¶
Champ |
Rôle |
Valeurs |
|---|---|---|
URL (rtmp(s)://…) |
L’adresse de la source. Champ obligatoire. |
|
Bind interface |
L’interface locale de la connexion sortante ; choisie dans la liste des interfaces du nœud. |
n’importe laquelle par défaut |
Client timeout (s) |
Délai de connexion et de lecture. |
1–120, par défaut 10 |
Verify TLS certificate |
Pour |
désactivé par défaut |
Trace |
Journalisation des changements d’état de la connexion RTMP dans le journal du flux. |
désactivé par défaut |
Sortie¶
Les mêmes champs que pour l’entrée, et en plus :
Champ |
Rôle |
Valeurs |
|---|---|---|
Allow HEVC (Enhanced RTMP) |
Autoriser la publication de HEVC via l’extension Enhanced RTMP. La désactivation ne convertit pas le flux en H.264 : seule une source H.264 est publiée, tandis qu’une source HEVC n’est pas publiée du tout lorsque le réglage est désactivé — la raison est visible dans les statistiques de la sortie. |
activé par défaut |
Un seul programme est publié : une vidéo et au plus une piste audio AAC. Il n’est pas nécessaire de sélectionner les pistes à la main — la sortie prend elle-même la première vidéo appropriée et la première piste AAC, écarte les autres et énumère ce qui a été écarté dans les statistiques. La publication n’est empêchée que lorsqu’il n’y a aucune vidéo appropriée. S’il faut limiter le flux lui-même, les filtres de PID se définissent dans l’onglet « MPEG-TS PID » de la fenêtre d’entrée et s’appliquent à tout le flux, avec toutes ses sorties (Filtrage MPEG-TS).
