Marqueurs SCTE-35 dans MPEG-TS et HLS en C# .NET¶
Présentation¶
Les sections de raccord SCTE-35 marquent les points où une chaîne de diffusion ou FAST quitte le flux du réseau pour une coupure publicitaire, puis y revient. Elles circulent dans le flux de transport sur leur propre PID (type de flux 0x86). Media Blocks SDK .NET vous permet de :
- Les lire depuis un fichier ou un flux MPEG-TS (
MPEGTSDemuxBlock), ou depuis une source MPEG-TS ou HLS décodée parUniversalSourceBlock, sous forme d'événementOnSpliceEvent. - Les conserver lors d'un remux : un TS lu avec SCTE-35 activé et écrit par
MPEGTSSinkBlockavec un PID SCTE-35 porte les mêmes commandes de raccord dans sa sortie. - Insérer vos propres commandes splice_insert dans un fichier MPEG-TS, ou dans un flux MPEG-TS envoyé en UDP, SRT ou RIST, depuis un pipeline Media Blocks ou depuis
VideoCaptureCoreX.
SCTE-35 est désactivé par défaut : sans EnableSCTE35, le démultiplexeur ignore le PID SCTE-35.
Lire les événements de raccord depuis MPEG-TS¶
var pipeline = new MediaBlocksPipeline();
var source = new BasicFileSourceBlock("channel.ts");
var demux = new MPEGTSDemuxBlock(renderVideo: true, renderAudio: true);
demux.Settings.EnableSCTE35 = true;
demux.OnSpliceEvent += (sender, e) =>
{
if (e.CommandType == SpliceCommandType.Insert)
{
var kind = e.OutOfNetwork ? "break starts" : "break ends";
Console.WriteLine($"Event {e.EventId}: {kind} at {e.RunningTime}, duration {e.BreakDuration}");
}
};
pipeline.Connect(source.Output, demux.Input);
// Connectez demux.VideoOutput et demux.AudioOutput à des moteurs de rendu, des encodeurs ou des sinks.
await pipeline.StartAsync();
SpliceEventArgs contient :
| Propriété | Signification |
|---|---|
Section | La splice_info_section complète, de table_id (0xFC) à CRC_32. Utilisez-la pour les descripteurs (segmentation, avail) et pour les commandes autres que splice_insert et time_signal. |
CommandType | Insert (splice_insert), TimeSignal, Null, Schedule, BandwidthReservation ou Private. |
EventId, Cancel, OutOfNetwork, Immediate | Les champs de splice_insert. OutOfNetwork = true ouvre une coupure, false la ferme. |
PtsTime | L'instant du raccord dans l'horloge PTS à 90 kHz du flux, pts_adjustment appliqué. |
RunningTime | Le même point en temps d'exécution du pipeline, la base de temps des tampons qui sortent du démultiplexeur. Là où les horodatages du flux sautent, le démultiplexeur comble l'écart, et RunningTime suit sa sortie, pas le PTS d'origine. null lorsque le démultiplexeur ne peut pas le convertir : la section arrive avant que l'horloge du flux soit connue, ou le point se situe avant le début de la sortie. |
BreakDuration, AutoReturn | Le break_duration d'un splice_insert. |
Encrypted, PtsAdjustment | Lorsque Encrypted est défini, seuls Section et PtsAdjustment sont renseignés. |
L'événement est déclenché sur un thread de streaming lorsque le démultiplexeur atteint la section, généralement quelques secondes avant le point de raccord lui-même. Revenez vite et confiez le travail à votre propre thread ou au répartiteur de l'interface.
Lire les événements de raccord depuis HLS¶
UniversalSourceBlock déclenche le même événement pour une source MPEG-TS et pour un flux HLS de segments MPEG-TS. Les sections parviennent à l'application après le passage par les décodeurs :
var settings = await UniversalSourceSettings.CreateAsync(new Uri("https://example.com/live/index.m3u8"));
settings.EnableSCTE35 = true;
var source = new UniversalSourceBlock(settings);
source.OnSpliceEvent += (sender, e) => Console.WriteLine($"{e.CommandType} {e.EventId} at {e.RunningTime}");
Ce sont les sections SCTE-35 à l'intérieur des segments TS qui sont lues. Les balises de la liste de lecture (#EXT-X-CUE-OUT, #EXT-X-DATERANGE) ne le sont pas.
Conserver les événements de raccord lors d'un remux¶
Activez EnableSCTE35 sur le démultiplexeur et SCTE35PID sur le sink. Chaque section voyage avec les flux, et le multiplexeur l'écrit sur le nouveau PID avec une temporisation ajustée à la sortie :
var demux = new MPEGTSDemuxBlock(renderVideo: true, renderAudio: true);
demux.Settings.EnableSCTE35 = true;
pipeline.Connect(source.Output, demux.Input);
var videoParse = new H264ParseBlock();
pipeline.Connect(demux.VideoOutput, videoParse.Input);
var sink = new MPEGTSSinkBlock(new MPEGTSSinkSettings("output.ts") { SCTE35PID = 500 });
pipeline.Connect(videoParse.Output, sink.CreateNewInput(MediaBlockPadMediaType.Video));
Insérer des événements de raccord dans une sortie MPEG-TS¶
Avec SCTE35PID défini, MPEGTSSinkBlock écrit un flux SCTE-35 avec un battement splice_null toutes les 5 minutes, et InsertSpliceOut / InsertSpliceIn ajoutent des commandes splice_insert pendant l'exécution du pipeline :
var sink = new MPEGTSSinkBlock(new MPEGTSSinkSettings("channel.ts") { SCTE35PID = 500 });
pipeline.Connect(h264Encoder.Output, sink.CreateNewInput(MediaBlockPadMediaType.Video));
await pipeline.StartAsync();
// Une coupure de 30 secondes qui commence à 10 s de temps d'exécution, annoncée à l'avance.
sink.InsertSpliceOut(eventId: 1, spliceTime: TimeSpan.FromSeconds(10), duration: TimeSpan.FromSeconds(30));
// Attendez jusqu'à environ 5 s avant la fin de la coupure, puis annoncez le retour.
await Task.Delay(TimeSpan.FromSeconds(35));
sink.InsertSpliceIn(eventId: 1, spliceTime: TimeSpan.FromSeconds(40));
- Les temps sont en temps d'exécution du pipeline. Passez
nullpour un raccord immédiat. - Annoncez un raccord quelques secondes avant qu'il ait lieu (SCTE 67 recommande au moins 4 secondes). Le multiplexeur convertit le temps en PTS de la sortie et demande à l'encodeur une image clé au point de raccord.
- Envoyez chaque raccord quelques secondes avant son propre point, pas toute la coupure d'un coup. Le multiplexeur ne garde qu'une section en attente jusqu'à son paquet suivant : un second appel avant ce moment remplace le premier, et les deux renvoient
true. - Utilisez un PID de 0x50 à 0x1FFE qu'aucun autre flux de la sortie n'utilise (500 dans les exemples). Les PID inférieurs sont pris par les tables et par les propres flux du multiplexeur ; un PID hors de cette plage est signalé via
OnError. Un conflit avec un autre flux dans la plage n'est pas détecté.
Insérer des événements de raccord dans un flux UDP, SRT ou RIST¶
Les blocs sink MPEG-TS réseau acceptent la même propriété SCTE35PID et les mêmes méthodes InsertSpliceOut / InsertSpliceIn que MPEGTSSinkBlock. Utilisez-les lorsque la chaîne part en direct, vers une tête de réseau, un packager cloud ou un serveur d'insertion publicitaire qui lit le SCTE-35 dans le flux de transport, plutôt que vers un fichier.
| Bloc sink | Classe de paramètres portant SCTE35PID |
|---|---|
UDPMPEGTSSinkBlock | UDPSinkSettings |
MultiUDPMPEGTSSinkBlock | MultiUDPSinkSettings |
SRTMPEGTSSinkBlock | SRTSinkSettings |
RISTMPEGTSSinkBlock | RISTSinkSettings |
var pipeline = new MediaBlocksPipeline();
var video = new VirtualVideoSourceBlock(new VirtualVideoSourceSettings());
var encoder = new H264EncoderBlock(new OpenH264EncoderSettings());
pipeline.Connect(video.Output, encoder.Input);
var srt = new SRTMPEGTSSinkBlock(new SRTSinkSettings
{
Uri = "srt://ingest.example.com:9000",
Mode = SRTConnectionMode.Caller,
SCTE35PID = 500,
});
pipeline.Connect(encoder.Output, srt.CreateNewInput(MediaBlockPadMediaType.Video));
await pipeline.StartAsync();
// Une coupure de 30 secondes à 60 s de temps d'exécution, annoncée 5 secondes à l'avance.
await Task.Delay(TimeSpan.FromSeconds(55));
srt.InsertSpliceOut(eventId: 7, spliceTime: TimeSpan.FromSeconds(60), duration: TimeSpan.FromSeconds(30));
// Le retour, annoncé vers la fin de la coupure.
await Task.Delay(TimeSpan.FromSeconds(30));
srt.InsertSpliceIn(eventId: 7, spliceTime: TimeSpan.FromSeconds(90));
Les règles de la section précédente s'appliquent telles quelles : points de raccord en temps d'exécution, quelques secondes de préavis et une seule section en attente dans le multiplexeur. Définissez SCTE35PID avant de démarrer le pipeline : un PID défini plus tard n'atteint jamais le multiplexeur, et les méthodes d'insertion renvoient false. Les sections de raccord lues par un MPEGTSDemuxBlock en amont avec EnableSCTE35 traversent aussi ces sinks, comme elles traversent MPEGTSSinkBlock.
Une entrée fichier n'a pas besoin d'être cadencée. Quand l'entrée n'est pas en direct, les sinks MPEG-TS UDP, UDP multi-destination et SRT envoient chaque paquet à son horodatage : un fichier part en temps réel et le sink n'abandonne rien ; une connexion SRT bloquée retient le fichier jusqu'à ce qu'elle reprenne. Avec une source en direct, ils envoient chaque paquet dès son arrivée et abandonnent les plus anciens si le réseau se bloque, pour que le reste du pipeline - un aperçu, un enregistrement - continue. L'entrée compte comme en direct dès qu'une de ses sources l'est. Une source push est en direct quand IsLive est activé dans ses paramètres : PushVideoSourceSettings, PushAudioSourceSettings et PushJPEGSourceSettings valent true par défaut, PushDataSourceSettings vaut false.
UDPSinkBlock, MultiUDPSinkBlock et SRTSinkBlock envoient tel quel un flux déjà multiplexé et ignorent SCTE35PID.
Insérer des événements de raccord depuis Video Capture SDK .NET¶
VideoCaptureCoreX construit ses sorties SRTOutput, RISTOutput et MPEGTSOutput sur les mêmes sinks. Définissez le PID dans les paramètres Sink de la sortie, et insérez par l'index de la sortie :
var capture = new VideoCaptureCoreX(videoView);
capture.Video_Source = videoSourceSettings;
var srt = new SRTOutput("srt://ingest.example.com:9000");
srt.Video = new OpenH264EncoderSettings();
srt.Sink.SCTE35PID = 500;
capture.Outputs_Add(srt);
await capture.StartAsync();
// Index 0 : la première sortie ajoutée. Les temps sont le temps d'exécution de la sortie, l'horloge que renvoie Outputs_GetDuration.
capture.Outputs_InsertSpliceOut(0, eventId: 7, spliceTime: TimeSpan.FromSeconds(60), duration: TimeSpan.FromSeconds(30));
// ... vers la fin de la coupure :
capture.Outputs_InsertSpliceIn(0, eventId: 7, spliceTime: TimeSpan.FromSeconds(90));
Les deux méthodes renvoient false et déclenchent OnError lorsque la sortie n'a pas démarré ou a été arrêtée, a été démarrée sans PID, ou n'est pas une sortie MPEG-TS : l'une de ces trois, ou un CustomBlocksOutputSettings dont le Sink est n'importe quel bloc sink MPEG-TS, UDPMPEGTSSinkBlock et MultiUDPMPEGTSSinkBlock compris.
Plateformes¶
La lecture et l'insertion, dans des fichiers et dans des flux UDP, SRT et RIST, fonctionnent sous Windows, macOS, Linux et iOS, là où le bloc sink lui-même est disponible (IsAvailable()). Android n'est pas pris en charge : sa version de GStreamer n'exporte pas la bibliothèque de sections MPEG-TS, donc OnSpliceEvent n'y est jamais déclenché (le pipeline signale une erreur à l'arrivée de la première section) et les méthodes d'insertion renvoient false avec une erreur dans le journal.
SCTE-104 (la forme SDI/VANC de ces marqueurs) n'est pas couvert par cette API.