GStreamer基礎教程08 - 多執行緒
摘要
GStreamer框架會自動處理多執行緒的邏輯,但在某些情況下,我們仍然需要根據實際的情況自己將部分Pipeline在單獨的執行緒中執行,本文將介紹如何處理這種情況。
GStreamer多執行緒
GStreamer框架是一個支援多執行緒的框架,執行緒會根據Pipeline的需要自動建立和銷燬,例如,將媒體流與應用執行緒解耦,應用執行緒不會被GStreamer的處理阻塞。而且,GStreamer的外掛還可以建立自己所需的執行緒用於媒體的處理,例如:在一個4核的CPU上,視訊解碼外掛可以建立4個執行緒來最大化利用CPU資源。
此外,在建立Pipeline時,我們還可以指定某個Pipeline的分支在不同的執行緒中執行(例如,使audio、video同時在不同的執行緒中進行解碼)。這是通過queue Element來實現的,queue的sink pad僅僅將資料放入佇列,另外一個執行緒從佇列中取出資料,並傳遞到下一個Element。queue通常也被用於作為資料緩衝,緩衝區大小可以通過queue的屬性進行配置。
在上面的示例Pipeline中,souce是audiotestsrc,會產生一個相應的audio訊號,然後使用tee Element將資料分為兩路,一路被用於播放,通過音效卡輸出,另一路被用於轉換為視訊波形,用於輸出到螢幕。
示例圖中的紅色陰影部分表示位於同一個執行緒中,queue會建立單獨的執行緒,所以上面的Pipeline使用了3個執行緒完成相應的功能。擁有多個sink的Pipeline通常需要多個執行緒,因為在多個sync間進行同步的時候,sink會阻塞當前所線上程直到所等待的事件發生。
示例程式碼
示例程式碼將建立上圖所示的Pipeline。
#include <gst/gst.h> int main(int argc, char *argv[]) { GstElement *pipeline, *audio_source, *tee, *audio_queue, *audio_convert, *audio_resample, *audio_sink; GstElement *video_queue, *visual, *video_convert, *video_sink; GstBus *bus; GstMessage *msg; GstPad *tee_audio_pad, *tee_video_pad; GstPad *queue_audio_pad, *queue_video_pad; /* Initialize GStreamer */ gst_init (&argc, &argv); /* Create the elements */ audio_source = gst_element_factory_make ("audiotestsrc", "audio_source"); tee = gst_element_factory_make ("tee", "tee"); audio_queue = gst_element_factory_make ("queue", "audio_queue"); audio_convert = gst_element_factory_make ("audioconvert", "audio_convert"); audio_resample = gst_element_factory_make ("audioresample", "audio_resample"); audio_sink = gst_element_factory_make ("autoaudiosink", "audio_sink"); video_queue = gst_element_factory_make ("queue", "video_queue"); visual = gst_element_factory_make ("wavescope", "visual"); video_convert = gst_element_factory_make ("videoconvert", "csp"); video_sink = gst_element_factory_make ("autovideosink", "video_sink"); /* Create the empty pipeline */ pipeline = gst_pipeline_new ("test-pipeline"); if (!pipeline || !audio_source || !tee || !audio_queue || !audio_convert || !audio_resample || !audio_sink || !video_queue || !visual || !video_convert || !video_sink) { g_printerr ("Not all elements could be created.\n"); return -1; } /* Configure elements */ g_object_set (audio_source, "freq", 215.0f, NULL); g_object_set (visual, "shader", 0, "style", 1, NULL); /* Link all elements that can be automatically linked because they have "Always" pads */ gst_bin_add_many (GST_BIN (pipeline), audio_source, tee, audio_queue, audio_convert, audio_resample, audio_sink, video_queue, visual, video_convert, video_sink, NULL); if (gst_element_link_many (audio_source, tee, NULL) != TRUE || gst_element_link_many (audio_queue, audio_convert, audio_resample, audio_sink, NULL) != TRUE || gst_element_link_many (video_queue, visual, video_convert, video_sink, NULL) != TRUE) { g_printerr ("Elements could not be linked.\n"); gst_object_unref (pipeline); return -1; } /* Manually link the Tee, which has "Request" pads */ tee_audio_pad = gst_element_get_request_pad (tee, "src_%u"); g_print ("Obtained request pad %s for audio branch.\n", gst_pad_get_name (tee_audio_pad)); queue_audio_pad = gst_element_get_static_pad (audio_queue, "sink"); tee_video_pad = gst_element_get_request_pad (tee, "src_%u"); g_print ("Obtained request pad %s for video branch.\n", gst_pad_get_name (tee_video_pad)); queue_video_pad = gst_element_get_static_pad (video_queue, "sink"); if (gst_pad_link (tee_audio_pad, queue_audio_pad) != GST_PAD_LINK_OK || gst_pad_link (tee_video_pad, queue_video_pad) != GST_PAD_LINK_OK) { g_printerr ("Tee could not be linked.\n"); gst_object_unref (pipeline); return -1; } gst_object_unref (queue_audio_pad); gst_object_unref (queue_video_pad); /* Start playing the pipeline */ gst_element_set_state (pipeline, GST_STATE_PLAYING); /* Wait until error or EOS */ bus = gst_element_get_bus (pipeline); msg = gst_bus_timed_pop_filtered (bus, GST_CLOCK_TIME_NONE, GST_MESSAGE_ERROR | GST_MESSAGE_EOS); /* Release the request pads from the Tee, and unref them */ gst_element_release_request_pad (tee, tee_audio_pad); gst_element_release_request_pad (tee, tee_video_pad); gst_object_unref (tee_audio_pad); gst_object_unref (tee_video_pad); /* Free resources */ if (msg != NULL) gst_message_unref (msg); gst_object_unref (bus); gst_element_set_state (pipeline, GST_STATE_NULL); gst_object_unref (pipeline); return 0; }
儲存以上程式碼,執行下列編譯命令即可得到可執行程式:
gcc basic-tutorial-8.c -o basic-tutorial-8 `pkg-config --cflags --libs gstreamer-1.0`
原始碼分析
/* Create the elements */ audio_source = gst_element_factory_make ("audiotestsrc", "audio_source"); tee = gst_element_factory_make ("tee", "tee"); audio_queue = gst_element_factory_make ("queue", "audio_queue"); audio_convert = gst_element_factory_make ("audioconvert", "audio_convert"); audio_resample = gst_element_factory_make ("audioresample", "audio_resample"); audio_sink = gst_element_factory_make ("autoaudiosink", "audio_sink"); video_queue = gst_element_factory_make ("queue", "video_queue"); visual = gst_element_factory_make ("wavescope", "visual"); video_convert = gst_element_factory_make ("videoconvert", "video_convert"); video_sink = gst_element_factory_make ("autovideosink", "video_sink");
首先建立所需的Element:audiotestsrc會產生測試的音訊波形資料。wavescope 會將輸入的音訊資料轉換為波形影象。audioconvert,audioresample,videoconvert保證了Pipeline中各個Element之間的資料可以互相相容,使得Pipeline能夠被正確的link起來,如果不需要對資料進行轉換,這些Element會直接將資料傳送到下一個Element,這種情況下的效能影響可以忽略不計。
/* Configure elements */ g_object_set (audio_source, "freq", 215.0f, NULL); g_object_set (visual, "shader", 0, "style", 1, NULL);
這裡修改相應Element的引數,使得輸出結果更直觀。“freq”會設定audiotestsrc輸出波形的頻率為215Hz,設定“shader”和“style”使得波形更加連續。其他的引數可以通過gst-inspect檢視。
/* Link all elements that can be automatically linked because they have "Always" pads */ gst_bin_add_many (GST_BIN (pipeline), audio_source, tee, audio_queue, audio_convert, audio_sink, video_queue, visual, video_convert, video_sink, NULL); if (gst_element_link_many (audio_source, tee, NULL) != TRUE || gst_element_link_many (audio_queue, audio_convert, audio_sink, NULL) != TRUE || gst_element_link_many (video_queue, visual, video_convert, video_sink, NULL) != TRUE) { g_printerr ("Elements could not be linked.\n"); gst_object_unref (pipeline); return -1; }
這裡我們使用gst_element_link_many 將多個Element連線起來,需要注意的是,這裡我們只連線了擁有Always Pad的Eelement。雖然gst_element_link_many() 能夠在內部處理Request Pad的情況,但我們仍然需要單獨釋放Request Pad,如果直接使用此函式連線所有的Element,這樣容易忘記釋放Request Pad。因此我們使用下面的程式碼單獨處理Request Pad。
/* Manually link the Tee, which has "Request" pads */ tee_audio_pad = gst_element_get_request_pad (tee, "src_%u"); g_print ("Obtained request pad %s for audio branch.\n", gst_pad_get_name (tee_audio_pad)); queue_audio_pad = gst_element_get_static_pad (audio_queue, "sink"); tee_video_pad = gst_element_get_request_pad (tee, "src_%u"); g_print ("Obtained request pad %s for video branch.\n", gst_pad_get_name (tee_video_pad)); queue_video_pad = gst_element_get_static_pad (video_queue, "sink"); if (gst_pad_link (tee_audio_pad, queue_audio_pad) != GST_PAD_LINK_OK || gst_pad_link (tee_video_pad, queue_video_pad) != GST_PAD_LINK_OK) { g_printerr ("Tee could not be linked.\n"); gst_object_unref (pipeline); return -1; } gst_object_unref (queue_audio_pad); gst_object_unref (queue_video_pad);
為了能夠連線到Request Pad,我們需要主動的向Element取得相應的Pad。由於一個Element可以提供不同的Request Pad,所以我們需要指定所需的“Pad Template”,Element提供的Pad Template可以通過gst-inspect檢視。從下面的結果可以發現,tee提供了2種類型的模板, ”sink“ 和“src_%u"。
$ gst-inspect-1.0 tee ... Pad Templates: SRC template: 'src_%u' Availability: On request Has request_new_pad() function: gst_tee_request_new_pad Capabilities: ANY SINK template: 'sink' Availability: Always Capabilities: ANY ...
由於我們這裡需要的是2個Source Pad,所以我們通過gst_element_get_request_pad (tee, "src_%u")獲取兩個Request Pad分別用於audio和video。queue的Sink Pad是Alwasy Pad,所以我們直接使用gst_element_get_static_pad 獲取其Sink Pad。最後再通過gst_pad_link()將其連線起來,在gst_element_link()和gst_element_link_many()內部也是使用此函式連線兩個Element的Pad。
需要注意的是,我們通過Element獲取到的Pad的引用計數會自動增加,因此我們需要呼叫gst_object_unref()釋放相關的引用,對於Request Pad,我們需要在Pipeline執行完成後進行釋放。
/* Release the request pads from the Tee, and unref them */ gst_element_release_request_pad (tee, tee_audio_pad); gst_element_release_request_pad (tee, tee_video_pad); gst_object_unref (tee_audio_pad); gst_object_unref (tee_video_pad);
除了播放完成後正常的資源釋放外,我們還要對Request進行釋放,需要首先呼叫gst_element_release_request_pad(),最後再釋放相應的物件。
總結
我們在本文中瞭解了:
- 如何通過queue讓Pipeline執行在多個執行緒上。
- 如何通過gst_element_get_request_pad(), gst_pad_link() gst_element_release_request_pad() 對Request Pad進行操作。
- 如何使用tee將一路媒體資料分為多路。
引用
https://gstreamer.freedesktop.org/documentation/tutorials/basic/multithreading-and-pad-availability.html?gi-language=c
作者:John.Leng 出處:http://www.cnblogs.com/xleng/ 本文版權歸作者所有,歡迎轉載。商業轉載請聯絡作者獲得授權,非商業轉載請在文章頁面明顯位置給出原文連線.