Наши партнеры

Библиотека сайта rus-linux.net

Фреймворк GStreamer. Руководство разработчика приложений. Метаданные

Оригинал: GStreamer Application Development Manual
Авторы: Wim Taymans, Steve Baker, Andy Wingo, Ronald S. Bultje, Stefan Kost
Дата публикации: 21 мая 2014 г.
Перевод: А.Панин
Дата перевода: 20 июня 2014 г.

Глава 12. Метаданные

Фреймворк GStreamer проводит четкое разделение между двумя типами метаданных и поддерживает оба этих типа. К первому типу относятся тэги мультимедийного потока, которые описывают содержимое потока без технических подробностей. Примерами таких тэгов являются имя автора композиции, название этой композиции или название альбома, в составе которого она была выпущена. Ко второму типу метаданных относится информация о потоке данных, являющаяся отчасти техническим описанием свойств мультимедийного потока. К данной информации относятся размер изображения, частота дискретизации аудиопотока, названия используемых кодеков и.т..д. Тэги обрабатываются с помощью системы тэгов фреймворка GStreamer. Информация о потоке может быть получена от объекта точки соединения типа GstPad путем получения объектов текущих (согласованных) свойств типа GstCaps для данной точки соединения.

12.1. Чтение метаданных

Наиболее простой метод доступа к информации о потоке заключается в получении данных от объекта точки соединения типа GstPad. Этот метод уже обсуждался ранее в разделе под названием "Использование возможностей для работы с метаданными". Ввиду этого, мы не будем обсуждать упомянутый метод в данной главе. Учтите, что для использования данного метода необходим доступ ко всем точкам соединения, из которых вы хотели бы получить получить информацию о мультимедийном потоке.

Чтение тэгов осуществляется посредством шины сообщений фреймворка GStreamer, о которой было сказано ранее в Главе 7, "Шина сообщений". Вы можете отслеживать сообщения GST_MESSAGE_TAG и обрабатывать их так, как вы хотите.

Однако, следует учесть, что сообщение GST_MESSAGE_TAG может генерироваться неоднократно для каждого из конвейеров. Задачей приложения является сбор передаваемых тэгов и показ их пользователю в читаемой и понятной форме. Обычно для этой цели хорошо подходит функция gst_tag_list_merge (); не забывайте об очистке кэша тэгов при загрузке новой композиции или через каждые несколько минут при прослушивании интернет-радио. Также убедитесь в том, что вы используете режим объединения тэгов GST_TAG_MERGE_PREPEND для того, чтобы новое название композиции (которое принимается позднее) имело приоритет перед старым при его выводе.

Следующий пример позволяет извлечь тэги из файла и вывести их:

/* компилируйте с помощью команды:
 * gcc -o tags tags.c `pkg-config --cflags --libs gstreamer-1.0` */
#include <gst/gst.h>

static void
print_one_tag (const GstTagList * list, const gchar * tag, gpointer user_data)
{
  int i, num;

num = gst_tag_list_get_tag_size (list, tag);
  for (i = 0; i < num; ++i) {
    const GValue *val;

/* Примечание: при поиске определенных тэгов используйте API  gst_tag_list_get_xyz(). 
     * Мы используем подход со значениями типа GValue, так как он является более обобщенным */
    val = gst_tag_list_get_value_index (list, tag, i);
    if (G_VALUE_HOLDS_STRING (val)) {
      g_print ("\t%20s : %s\n", tag, g_value_get_string (val));
    } else if (G_VALUE_HOLDS_UINT (val)) {
      g_print ("\t%20s : %u\n", tag, g_value_get_uint (val));
    } else if (G_VALUE_HOLDS_DOUBLE (val)) {
      g_print ("\t%20s : %g\n", tag, g_value_get_double (val));
    } else if (G_VALUE_HOLDS_BOOLEAN (val)) {
      g_print ("\t%20s : %s\n", tag,
          (g_value_get_boolean (val)) ? "true" : "false");
    } else if (GST_VALUE_HOLDS_BUFFER (val)) {
      GstBuffer *buf = gst_value_get_buffer (val);
      guint buffer_size = gst_buffer_get_size (buf);

g_print ("\t%20s : буфер размера %u\n", tag, buffer_size);
    } else if (GST_VALUE_HOLDS_DATE_TIME (val)) {
      GstDateTime *dt = g_value_get_boxed (val);
      gchar *dt_str = gst_date_time_to_iso8601_string (dt);

g_print ("\t%20s : %s\n", tag, dt_str);
      g_free (dt_str);
    } else {
      g_print ("\t%20s : тэг типа '%s'\n", tag, G_VALUE_TYPE_NAME (val));
    }
  }
}

static void
on_new_pad (GstElement * dec, GstPad * pad, GstElement * fakesink)
{
  GstPad *sinkpad;

sinkpad = gst_element_get_static_pad (fakesink, "sink");
  if (!gst_pad_is_linked (sinkpad)) {
    if (gst_pad_link (pad, sinkpad) != GST_PAD_LINK_OK)
      g_error ("Не удалось связать точки соединения!");
  }
  gst_object_unref (sinkpad);
}

int
main (int argc, char ** argv)
{
  GstElement *pipe, *dec, *sink;
  GstMessage *msg;

gst_init (&argc, &argv);

if (argc < 2 || !gst_uri_is_valid (argv[1]))
    g_error ("Использование: %s file:///путь/к/файлу", argv[0]);

pipe = gst_pipeline_new ("pipeline");

dec = gst_element_factory_make ("uridecodebin", NULL);
  g_object_set (dec, "uri", argv[1], NULL);
  gst_bin_add (GST_BIN (pipe), dec);

sink = gst_element_factory_make ("fakesink", NULL);
  gst_bin_add (GST_BIN (pipe), sink);

g_signal_connect (dec, "pad-added", G_CALLBACK (on_new_pad), sink);

gst_element_set_state (pipe, GST_STATE_PAUSED);

while (TRUE) {
    GstTagList *tags = NULL;

msg = gst_bus_timed_pop_filtered (GST_ELEMENT_BUS (pipe),
        GST_CLOCK_TIME_NONE,
        GST_MESSAGE_ASYNC_DONE | GST_MESSAGE_TAG | GST_MESSAGE_ERROR);

if (GST_MESSAGE_TYPE (msg) != GST_MESSAGE_TAG) /* ошибка или завершение асинхронной операции */
      break;

gst_message_parse_tag (msg, &tags);

g_print ("Получены тэги от элемента %s:\n", GST_OBJECT_NAME (msg->src));
    gst_tag_list_foreach (tags, print_one_tag, NULL);
    g_print ("\n");
    gst_tag_list_unref (tags);

gst_message_unref (msg);
  };

if (GST_MESSAGE_TYPE (msg) == GST_MESSAGE_ERROR)
    g_error ("Получено сообщение об ошибке");

gst_message_unref (msg);
  gst_element_set_state (pipe, GST_STATE_NULL);
  gst_object_unref (pipe);
  return 0;
}

12.2. Запись тэгов

Запись тэгов осуществляется с помощью интерфейса GstTagSetter. Все что для этого нужно, это элемент с поддержкой функции установки тэгов в составе вашего конвейера. Для того, чтобы определить, поддерживают ли какие-либо из ваших элементов функции записи тэгов, вы можете использовать функцию gst_bin_iterate_all_by_interface (pipeline, GST_TYPE_TAG_SETTER). Для установки тэгов вы можете использовать по отношению к полученному в результате объекту элемента, обычно кодировщика или мультиплексора, функцию gst_tag_setter_merge () (со списком тэгов) или функцию gst_tag_setter_add () (с отдельными тэгами).

Полезной дополнительной функцией механизма поддержки тэгов фреймворка GStreamer является сохранение тэгов в рамках конвейеров. Это значит, что в том случае, если вы преобразуете мультимедийный поток, полученный из одного содержащего тэги файла, в мультимедийный поток другого типа, причем поток нового типа также поддерживает тэги, то эти тэги будут обработаны как часть потока данных и добавлены записываемый результирующий мультимедийный файл.

Следующий раздел : Интерфейсы