【Gstreamer 13】基础教程之播放速度

原创于 2025-03-21 10:13:48 发布 · 1.3k 阅读

19 ·

CC 4.0 BY-SA版权

文章标签：

#音视频 #linux #媒体

开源库学习专栏收录该内容

22 篇文章

订阅专栏

官网地址

Basic tutorial 13: Playback speed

一、目标

快进、倒放和慢动作都是被称为技巧模式的技术，它们的共同点是修改了正常的播放速率。本教程展示了如何实现这些效果，并增加了逐帧播放的功能。具体来说，它展示了：

如何改变播放速率，比正常速度更快或更慢，正向或反向。
如何逐帧播放视频。

二、介绍

快进是一种以高于正常（预期）速度播放媒体的技术；而慢动作则使用低于预期速度的播放速率。倒放则是以相反的方向播放，从流的末尾到开头。

所有这些技术所做的就是改变播放速率，播放速率是一个变量，正常播放时为 1.0，快进时大于 1.0（绝对值），慢动作时小于 1.0（绝对值），正向播放时为正值，反向播放时为负值。

GStreamer 提供了两种改变播放速率的机制：Step Events 和 Seek Events。Step Events 允许跳过一定量的媒体并改变后续的播放速率（仅限正值）。Seek Events 则更进一步，允许跳转到流中的任何位置，并设置正向或负向的播放速率。

在基础教程 4：时间管理中，已经展示了 Seek Events 的使用，使用了一个辅助函数来隐藏其复杂性。本教程将进一步解释如何使用这些事件。

Step Events 是一种更便捷的改变播放速率的方式，因为创建它们所需的参数较少；然而，它们有一些缺点，因此本教程使用 Seek Events。Step Events 仅影响接收器（管道的末端），因此只有在管道的其余部分能够支持以不同速度播放时才会起作用。Seek Events 则会贯穿整个管道，因此每个元素都可以对它们做出反应。Step Events 的优点是它们的响应速度更快，但它们无法改变播放方向。

要使用这些事件，首先需要创建它们，然后将它们传递到管道中，事件会向上游传播，直到到达能够处理它们的元素。如果将事件传递给像 playbin 这样的 bin 元素，它会简单地将事件传递给所有接收器，这会导致多次执行 seek 操作。常见的做法是通过 video-sink 或 audio-sink 属性检索 playbin 的一个接收器，并直接将事件传递给该接收器。

逐帧播放是一种逐帧播放视频的技术。它通过暂停管道，然后发送 Step Events 每次跳过一帧来实现。

三、一个技巧模式播放器

将以下代码复制到一个名为 basic-tutorial-13.c 的文本文件中。

basic-tutorial-13.c

#include <string.h>
#include <stdio.h>
#include <gst/gst.h>

#ifdef __APPLE__
#include <TargetConditionals.h>
#endif

typedef struct _CustomData
{
  GstElement *pipeline;
  GstElement *video_sink;
  GMainLoop *loop;

  gboolean playing;             /* Playing or Paused */
  gdouble rate;                 /* Current playback rate (can be negative) */
} CustomData;

/* Send seek event to change rate */
static void
send_seek_event (CustomData * data)
{
  gint64 position;
  GstEvent *seek_event;

  /* Obtain the current position, needed for the seek event */
  if (!gst_element_query_position (data->pipeline, GST_FORMAT_TIME, &position)) {
    g_printerr ("Unable to retrieve current position.\n");
    return;
  }

  /* Create the seek event */
  if (data->rate > 0) {
    seek_event =
        gst_event_new_seek (data->rate, GST_FORMAT_TIME,
        GST_SEEK_FLAG_FLUSH | GST_SEEK_FLAG_ACCURATE, GST_SEEK_TYPE_SET,
        position, GST_SEEK_TYPE_END, 0);
  } else {
    seek_event =
        gst_event_new_seek (data->rate, GST_FORMAT_TIME,
        GST_SEEK_FLAG_FLUSH | GST_SEEK_FLAG_ACCURATE, GST_SEEK_TYPE_SET, 0,
        GST_SEEK_TYPE_SET, position);
  }

  if (data->video_sink == NULL) {
    /* If we have not done so, obtain the sink through which we will send the seek events */
    g_object_get (data->pipeline, "video-sink", &data->video_sink, NULL);
  }

  /* Send the event */
  gst_element_send_event (data->video_sink, seek_event);

  g_print ("Current rate: %g\n", data->rate);
}

/* Process keyboard input */
static gboolean
handle_keyboard (GIOChannel * source, GIOCondition cond, CustomData * data)
{
  gchar *str = NULL;

  if (g_io_channel_read_line (source, &str, NULL, NULL,
          NULL) != G_IO_STATUS_NORMAL) {
    return TRUE;
  }

  switch (g_ascii_tolower (str[0])) {
    case 'p':
      data->playing = !data->playing;
      gst_element_set_state (data->pipeline,
          data->playing ? GST_STATE_PLAYING : GST_STATE_PAUSED);
      g_print ("Setting state to %s\n", data->playing ? "PLAYING" : "PAUSE");
      break;
    case 's':
      if (g_ascii_isupper (str[0])) {
        data->rate *= 2.0;
      } else {
        data->rate /= 2.0;
      }
      send_seek_event (data);
      break;
    case 'd':
      data->rate *= -1.0;
      send_seek_event (data);
      break;
    case 'n':
      if (data->video_sink == NULL) {
        /* If we have not done so, obtain the sink through which we will send the step events */
        g_object_get (data->pipeline, "video-sink", &data->video_sink, NULL);
      }

      gst_element_send_event (data->video_sink,
          gst_event_new_step (GST_FORMAT_BUFFERS, 1, ABS (data->rate), TRUE,
              FALSE));
      g_print ("Stepping one frame\n");
      break;
    case 'q':
      g_main_loop_quit (data->loop);
      break;
    default:
      break;
  }

  g_free (str);

  return TRUE;
}

int
tutorial_main (int argc, char *argv[])
{
  CustomData data;
  GstStateChangeReturn ret;
  GIOChannel *io_stdin;

  /* Initialize GStreamer */
  gst_init (&argc, &argv);

  /* Initialize our data structure */
  memset (&data, 0, sizeof (data));

  /* Print usage map */
  g_print ("USAGE: Choose one of the following options, then press enter:\n"
      " 'P' to toggle between PAUSE and PLAY\n"
      " 'S' to increase playback speed, 's' to decrease playback speed\n"
      " 'D' to toggle playback direction\n"
      " 'N' to move to next frame (in the current direction, better in PAUSE)\n"
      " 'Q' to quit\n");

  /* Build the pipeline */
  data.pipeline =
      gst_parse_launch
      ("playbin uri=https://gstreamer.freedesktop.org/data/media/sintel_trailer-480p.webm",
      NULL);

  /* Add a keyboard watch so we get notified of keystrokes */
#ifdef G_OS_WIN32
  io_stdin = g_io_channel_win32_new_fd (fileno (stdin));
#else
  io_stdin = g_io_channel_unix_new (fileno (stdin));
#endif
  g_io_add_watch (io_stdin, G_IO_IN, (GIOFunc) handle_keyboard, &data);

  /* Start playing */
  ret = gst_element_set_state (data.pipeline, GST_STATE_PLAYING);
  if (ret == GST_STATE_CHANGE_FAILURE) {
    g_printerr ("Unable to set the pipeline to the playing state.\n");
    gst_object_unref (data.pipeline);
    return -1;
  }
  data.playing = TRUE;
  data.rate = 1.0;

  /* Create a GLib Main Loop and set it to run */
  data.loop = g_main_loop_new (NULL, FALSE);
  g_main_loop_run (data.loop);

  /* Free resources */
  g_main_loop_unref (data.loop);
  g_io_channel_unref (io_stdin);
  gst_element_set_state (data.pipeline, GST_STATE_NULL);
  if (data.video_sink != NULL)
    gst_object_unref (data.video_sink);
  gst_object_unref (data.pipeline);
  return 0;
}

int
main (int argc, char *argv[])
{
#if defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE
  return gst_macos_main ((GstMainFunc) tutorial_main, argc, argv, NULL);
#else
  return tutorial_main (argc, argv);
#endif
}

Linux 安装库(Install GStreamer on Ubuntu or Debian)

apt-get install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-bad1.0-dev gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-tools gstreamer1.0-x gstreamer1.0-alsa gstreamer1.0-gl gstreamer1.0-gtk3 gstreamer1.0-qt5 gstreamer1.0-pulseaudio

其他的系统看官网教程。

Installing on Mac OS X

执行编译

gcc basic-tutorial-13.c -o basic-tutorial-13 `pkg-config --cflags --libs gstreamer-1.0`

必需的库：gstreamer-1.0

四、代码解析

main 函数中的初始化代码没有新内容：创建了一个 playbin 管道，安装了一个 I/O 监视器来跟踪按键输入，并运行了一个 GLib 主循环。然后，在键盘处理函数中：

/* Process keyboard input */
static gboolean handle_keyboard (GIOChannel *source, GIOCondition cond, CustomData *data) {
  gchar *str = NULL;

  if (g_io_channel_read_line (source, &str, NULL, NULL, NULL) != G_IO_STATUS_NORMAL) {
    return TRUE;
  }

  switch (g_ascii_tolower (str[0])) {
  case 'p':
    data->playing = !data->playing;
    gst_element_set_state (data->pipeline, data->playing ? GST_STATE_PLAYING : GST_STATE_PAUSED);
    g_print ("Setting state to %s\n", data->playing ? "PLAYING" : "PAUSE");
    break;

暂停/播放切换通过 gst_element_set_state() 处理，与之前的教程相同。

case 's':
  if (g_ascii_isupper (str[0])) {
    data->rate *= 2.0;
  } else {
    data->rate /= 2.0;
  }
  send_seek_event (data);
  break;
case 'd':
  data->rate *= -1.0;
  send_seek_event (data);
  break;

使用 S 和 s 来加倍或减半当前播放速率，使用 d 来反转当前播放方向。在这两种情况下，都会更新 rate 变量并调用 send_seek_event。让我们回顾一下这个函数。

/* Send seek event to change rate */
static void send_seek_event (CustomData *data) {
  gint64 position;
  GstEvent *seek_event;

  /* Obtain the current position, needed for the seek event */
  if (!gst_element_query_position (data->pipeline, GST_FORMAT_TIME, &position)) {
    g_printerr ("Unable to retrieve current position.\n");
    return;
  }

此函数创建一个新的 Seek 事件并将其发送到管道以更新速率。首先，使用 gst_element_query_position() 获取当前位置。这是必需的，因为 Seek 事件会跳转到流中的另一个位置，而我们实际上并不想移动，因此跳转到当前位置。使用 Step 事件会更简单，但如简介中所述，此事件目前尚未完全功能化。

/* Create the seek event */
if (data->rate > 0) {
  seek_event = gst_event_new_seek (data->rate, GST_FORMAT_TIME, GST_SEEK_FLAG_FLUSH | GST_SEEK_FLAG_ACCURATE,
      GST_SEEK_TYPE_SET, position, GST_SEEK_TYPE_END, 0);
} else {
  seek_event = gst_event_new_seek (data->rate, GST_FORMAT_TIME, GST_SEEK_FLAG_FLUSH | GST_SEEK_FLAG_ACCURATE,
      GST_SEEK_TYPE_SET, 0, GST_SEEK_TYPE_SET, position);
}

使用 gst_event_new_seek() 创建 Seek 事件。其参数基本上是新的速率、新的起始位置和新的停止位置。无论播放方向如何，起始位置必须小于停止位置，因此两种播放方向的处理方式不同。

if (data->video_sink == NULL) {
  /* If we have not done so, obtain the sink through which we will send the seek events */
  g_object_get (data->pipeline, "video-sink", &data->video_sink, NULL);
}

如简介中所述，为了避免执行多次 Seek，事件仅发送到一个接收器，在本例中是视频接收器。它通过 video-sink 属性从 playbin 中获取。此时读取而不是在初始化时读取，是因为实际的接收器可能会根据媒体内容而变化，而这在管道处于 PLAYING 状态并读取了一些媒体之前是未知的。

/* Send the event */
gst_element_send_event (data->video_sink, seek_event);

最后，使用 gst_element_send_event() 将新事件发送到选定的接收器。回到键盘处理函数，我们还需要处理逐帧播放的代码，这非常简单：

case 'n':
  if (data->video_sink == NULL) {
    /* If we have not done so, obtain the sink through which we will send the step events */
    g_object_get (data->pipeline, "video-sink", &data->video_sink, NULL);
  }

  gst_element_send_event (data->video_sink,
      gst_event_new_step (GST_FORMAT_BUFFERS, 1, ABS (data->rate), TRUE, FALSE));
  g_print ("Stepping one frame\n");
  break;

使用 gst_event_new_step() 创建一个新的 Step 事件，其参数基本上指定要跳过的量（示例中为 1 帧）和新速率（我们不更改）。

与之前一样，如果尚未获取视频接收器，则从 playbin 中获取。

至此，我们已经完成了所有内容。在测试本教程时，请记住，许多元素中的反向播放并不理想。