Bloque de Grabación Pre-Evento - VisioForge Media Blocks SDK .NET¶

Media Blocks SDK .NET

El PreEventRecordingBlock almacena continuamente fotogramas de video y audio codificados en un buffer circular (anillo) basado en memoria. Cuando se activa un evento (detección de movimiento, alarma, llamada API), vacía el metraje pre-evento almacenado a un archivo y continúa grabando fotogramas en vivo durante una duración post-evento configurable. Esto crea clips de eventos completos que incluyen metraje de antes de que ocurriera el disparador.

Este bloque se usa comúnmente en aplicaciones de vigilancia y seguridad donde necesita capturar lo que sucedió antes y después de un evento, sin escribir continuamente en disco.

Información del bloque¶

Nombre: PreEventRecordingBlock.

Este es un bloque sumidero — no tiene pads de salida. Los archivos grabados se escriben directamente en disco cuando se activa una grabación.

Configuración¶

El PreEventRecordingBlock se configura usando PreEventRecordingSettings.

Constructor¶

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

Parámetros:

• settings — Configuración de grabación pre-evento. Usa valores predeterminados si es null.
• muxFactoryName — Nombre de fábrica del elemento muxer de GStreamer. Predeterminado: "mp4mux". Otras opciones: "matroskamux" (MKV), "mpegtsmux" (MPEG-TS).

Propiedades del bloque¶

Máquina de estados¶

El bloque sigue una máquina de estados bien definida:

stateDiagram-v2
    [*] --> Idle
    Idle --> Buffering : pipeline start / StartBuffering()
    Buffering --> Recording : TriggerRecording()
    Recording --> PostEventRecording : Pre-event buffer flushed
    PostEventRecording --> Buffering : Post-event timer expires / StopRecording() / StartBuffering() / format change
    Recording --> Buffering : StopRecording() / StartBuffering() / format change / trigger failed
    Idle --> Stopped : StopBuffering()
    Buffering --> Stopped : StopBuffering() / pipeline stop
    Recording --> Stopped : StopBuffering() / pipeline stop
    PostEventRecording --> Stopped : StopBuffering() / pipeline stop
    Stopped --> Buffering : StartBuffering() / restart after a pipeline stop

Un cambio del formato codificado durante una ejecución — resolución, perfil, nivel, datos de códec, o la frecuencia, el número de canales o el códec de audio — cierra una grabación en curso, igual que StopRecording(), y descarta los fotogramas almacenados de ese flujo. El otro flujo permanece en el búfer. El archivo siguiente se construye con el formato nuevo. Una frecuencia de imagen o una relación de aspecto de píxel repetidas no cierran la grabación.

Eventos¶

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

Los eventos se generan de uno en uno, en el orden en que ocurrieron los cambios: un controlador nunca se ejecuta al mismo tiempo que otro, y OnRecordingStopped llega después del OnRecordingStarted del mismo archivo y una vez finalizado el archivo. Mientras se ejecuta un controlador, todo lo que provoca un evento nuevo — StopRecording(), StopBuffering(), StartBuffering(), TriggerRecording(), la detención del pipeline o un cambio de formato, en otro hilo o dentro del propio controlador — regresa antes de que se genere ese evento; el hilo que ejecuta el controlador lo genera cuando el controlador termina. Por eso un controlador puede ejecutarse en un hilo de trabajo aunque la llamada se haya hecho en el hilo de la interfaz, y después de detener el pipeline o de liberar el bloque; pase al hilo de la interfaz antes de tocar los controles. StopRecording(), StopBuffering(), StartBuffering() y TriggerRecording() vuelven a lanzar lo que lanzaron los controladores de los eventos que generaron; en el temporizador posterior al evento, el inicio o la detención del pipeline o un cambio de formato, la excepción se registra como error.

Propiedades de PreEventRecordingEventArgs:

Métodos¶

El pipeline de muestra¶

Con una fuente de cámara local, detección de movimiento, vista previa de video y grabación pre-evento:

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

Cuando se llama a TriggerRecording(), el bloque crea internamente un pipeline de salida dinámico:

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

Código de muestra¶

El siguiente fragmento muestra cómo crear y conectar el bloque. Para una aplicación completa funcional con detección de movimiento, vista previa de video, soporte de cámara RTSP y UI WPF completa, vea la Guía de Grabación Pre-Evento.

// Configure pre-event settings
var preEventSettings = new PreEventRecordingSettings
{
    PreEventDuration = TimeSpan.FromSeconds(10),
    PostEventDuration = TimeSpan.FromSeconds(5)
};

// Create the block (MP4 output)
var preEventBlock = new PreEventRecordingBlock(preEventSettings, "mp4mux");
preEventBlock.AudioEnabled = true;

// Subscribe to events
preEventBlock.OnRecordingStarted += (s, args) =>
    Debug.WriteLine($"Recording started: {args.Filename}");
preEventBlock.OnRecordingStopped += (s, args) =>
    Debug.WriteLine($"Recording stopped: {args.Filename}");

// Connect encoded video and audio to the block
pipeline.Connect(h264Encoder.Output, preEventBlock.VideoInput);
pipeline.Connect(aacEncoder.Output, preEventBlock.AudioInput);

// Start pipeline — buffering begins immediately
await pipeline.StartAsync();

// Later: trigger recording on event
preEventBlock.TriggerRecording("/recordings/event_001.mp4");

// Extend if trigger condition persists
preEventBlock.ExtendRecording();

// Or stop manually
preEventBlock.StopRecording();

Opciones de formato de contenedor¶

Plataformas¶

Windows, macOS, Linux, Android, iOS (la disponibilidad de plataforma depende del soporte de muxer y codificador de GStreamer).