Bloc d'enregistrement pré-événement — VisioForge Media Blocks SDK .Net¶

Media Blocks SDK .Net

Le PreEventRecordingBlock met en tampon en continu les images vidéo et audio encodées dans un tampon circulaire en mémoire (ring buffer). Lorsqu'un événement se déclenche (détection de mouvement, alarme, appel d'API), il vide les images pré-événement mises en tampon vers un fichier et continue d'enregistrer les images en direct pendant une durée post-événement configurable. Cela crée des clips d'événement complets qui incluent les images antérieures au déclenchement.

Ce bloc est couramment utilisé dans les applications de surveillance et de sécurité où vous devez capturer ce qui s'est passé avant et après un événement, sans écrire en continu sur le disque.

Informations sur le bloc¶

Nom : PreEventRecordingBlock.

Ceci est un bloc puits — il n'a pas de pads de sortie. Les fichiers enregistrés sont écrits directement sur le disque lorsqu'un enregistrement est déclenché.

Paramètres¶

Le PreEventRecordingBlock est configuré à l'aide de PreEventRecordingSettings.

Constructeur¶

public PreEventRecordingBlock(PreEventRecordingSettings settings, string muxFactoryName = "mp4mux")

Paramètres :

• settings — Configuration de l'enregistrement pré-événement. Utilise les valeurs par défaut si null.
• muxFactoryName — Nom de fabrique d'élément de multiplexeur GStreamer. Par défaut : "mp4mux". Autres options : "matroskamux" (MKV), "mpegtsmux" (MPEG-TS).

Propriétés du bloc¶

Machine à états¶

Le bloc suit une machine à états bien définie :

stateDiagram-v2
    [*] --> Idle
    Idle --> Buffering : Build() / StartBuffering()
    Buffering --> Recording : TriggerRecording()
    Recording --> PostEventRecording : Pre-event buffer flushed
    PostEventRecording --> Buffering : Post-event timer expires
    PostEventRecording --> Buffering : StopRecording()
    Buffering --> Stopped : StopBuffering()
    PostEventRecording --> Stopped : StopBuffering()
    Stopped --> Buffering : StartBuffering()

Événements¶

public event EventHandler<PreEventRecordingEventArgs> OnRecordingStarted;
public event EventHandler<PreEventRecordingEventArgs> OnRecordingStopped;
public event EventHandler<PreEventRecordingEventArgs> OnStateChanged;

Propriétés de PreEventRecordingEventArgs :

Méthodes¶

Exemple de pipeline¶

Avec une source caméra locale, la détection de mouvement, l'aperçu vidéo et l'enregistrement pré-événement :

graph LR;
    VideoSource-->MotionDetector;
    MotionDetector-->VideoTee;
    VideoTee-->VideoRenderer;
    VideoTee-->H264Encoder;
    H264Encoder-->PreEventRecordingBlock;
    AudioSource-->AudioTee;
    AudioTee-->AudioRenderer;
    AudioTee-->AACEncoder;
    AACEncoder-->PreEventRecordingBlock;

Lorsque TriggerRecording() est appelé, le bloc crée en interne un pipeline de sortie dynamique :

graph LR;
    RingBuffer-->AppSrcVideo;
    RingBuffer-->AppSrcAudio;
    AppSrcVideo-->Muxer;
    AppSrcAudio-->Muxer;
    Muxer-->FileSink;

Exemple de code¶

L'extrait suivant montre comment créer et connecter le bloc. Pour une application fonctionnelle complète avec détection de mouvement, aperçu vidéo, prise en charge de caméra RTSP et interface WPF complète, consultez le Guide d'enregistrement pré-événement.

// Configurer les paramètres pré-événement
var preEventSettings = new PreEventRecordingSettings
{
    PreEventDuration = TimeSpan.FromSeconds(10),
    PostEventDuration = TimeSpan.FromSeconds(5)
};

// Créer le bloc (sortie MP4)
var preEventBlock = new PreEventRecordingBlock(preEventSettings, "mp4mux");
preEventBlock.AudioEnabled = true;

// S'abonner aux événements
preEventBlock.OnRecordingStarted += (s, args) =>
    Debug.WriteLine($"Enregistrement démarré : {args.Filename}");
preEventBlock.OnRecordingStopped += (s, args) =>
    Debug.WriteLine($"Enregistrement arrêté : {args.Filename}");

// Connecter la vidéo et l'audio encodés au bloc
pipeline.Connect(h264Encoder.Output, preEventBlock.VideoInput);
pipeline.Connect(aacEncoder.Output, preEventBlock.AudioInput);

// Démarrer le pipeline — la mise en tampon commence immédiatement
await pipeline.StartAsync();

// Plus tard : déclencher l'enregistrement sur événement
preEventBlock.TriggerRecording("/recordings/event_001.mp4");

// Étendre si la condition de déclenchement persiste
preEventBlock.ExtendRecording();

// Ou arrêter manuellement
preEventBlock.StopRecording();

Options de format de conteneur¶

Plateformes¶

Windows, macOS, Linux, Android, iOS (la disponibilité par plateforme dépend de la prise en charge des multiplexeurs et encodeurs GStreamer).