Gstreamer-GstEvent

相关连接：https://blog.csdn.net/knowledgebao/article/details/84621238

Includes

#include <gst/gst.h>

Description

event类提供构造和解析events的方法，而events事件是通信的载体。

events通常调用类似 gst_event_new_*() 这样的函数去创建。应用程序一般通过gst_element_send_event() 函数发送events，而element通常通过 gst_pad_send_event() or gst_pad_push_event()发送events。如果events构建后没有被发送，需要调用gst_event_unref()去释放。如果发送了就由对方去释放。

events可以通过类似 gst_event_parse_*() 这样的函数去解析内容，当然events可以只有类型而没有内容，既内容可以为空。

events主要在一个bin里的element之间传递。一些events可以包含有数据流。一些events只能向下游传递，一些events只能向上游传递，一些events既可以向下游传递，也可以向上游传递。events一般用于在数据流中发出特殊的信号，比如EOS(流的结束)或新流段的开始。events也会被用于刷新任何挂起数据的pipeline。

大多数事件API是在插件中使用的。应用程序通常只构造和使用seek事件。使用gst_event_new_seek()创建一个seek事件。它使用所需的参数来指定查找时间和模式。如下边代码段：

GstEvent *event;
gboolean result;
...
// construct a seek event to play the media from second 2 to 5, flush
// the pipeline to decrease latency.
event = gst_event_new_seek (1.0,
   GST_FORMAT_TIME,
   GST_SEEK_FLAG_FLUSH,
   GST_SEEK_TYPE_SET, 2 * GST_SECOND,
   GST_SEEK_TYPE_SET, 5 * GST_SECOND);
...
result = gst_element_send_event (pipeline, event);
if (!result)
  g_warning ("seek failed");
...

举例：

1，pad关联一个event处理函数，上游pad可以发送event事件给下游

#define gst_pad_set_event_function(p,f)   gst_pad_set_event_function_full((p),(f),NULL,NULL)
void gst_pad_set_event_function_full(GstPad *pad,GstPadEventFunction event,gpointer user_data,GDestroyNotify notify);
//解析函数定义及调用：
//设置指定pad接收函数
gst_pad_set_event_function(priv->sinkpad, GST_DEBUG_FUNCPTR(gst_ff_audio_enc_sink_event));
//定义及实现接收函数
static gboolean gst_ff_audio_enc_sink_event(GstPad * pad, GstObject * parent, GstEvent * event)
{
    GST_LOG_OBJECT(filter, "audio Enc * Received %s event: %" GST_PTR_FORMAT,
        GST_EVENT_TYPE_NAME(event), event);

    switch (GST_EVENT_TYPE(event)) {
    case GST_EVENT_EOS:
    {
        GST_FF_AUDIO_ENC_LOCK(priv);
        ret = gst_pad_push_event(priv->srcpad, event);
        gst_event_unref(event);
        GST_FF_AUDIO_ENC_UNLOCK(priv);
        break;
    }
    case GST_EVENT_CAPS:
    {
        GST_FF_AUDIO_ENC_LOCK(priv);
        GstCaps * caps;
        gst_event_parse_caps(event, &caps);
        ret = gst_ff_audio_enc_create(filter, caps);
        if (ret)
            ret = gst_ff_audio_enc_setcaps(filter);
        gst_event_unref(event);
        GST_FF_AUDIO_ENC_UNLOCK(priv);
        break;
    }
    default:
        ret = gst_pad_event_default(pad, parent, event);
        break;
    }

    return ret;
}
//上游发送events
ret = gst_pad_push_event(priv->srcpad, gst_event_new_caps(fixcaps));

Types and Values

Functions

Object Hierarchy

    GBoxed
    ╰── GstEvent

参考资料：

1. https://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstEvent.html

有任何问题，请联系knowledgebao@163.com