GStreamer学习笔记（一）

内容转自 http://phinecos.cnblogs.com/

本文介绍如何使用GStreamer 编写一个简单的MP3播放器。

1,需要使用mad解码插件，因此需要先安装gstreamer0.10-plugins-ugly

2，编写mp3播放器

下面来看看如何利用GStreamer框架提供的组件，来实现一个简单的MP3播放器。数据源元件负责从磁盘上读取数据，过滤器元件负责对数据进行解码，而接受器元件则负责将解码后的数据写入声卡。

如果想要在程序中应用GStreamer提供的各种功能，首先必须在主函数中调用gst_init()来完成相应的初始化工作，以便将用户从命令行输入的参数传递给GStreamer函数库。一个典型的GStreamer应用程序的初始化如下所示：

#include  < gst / gst.h >
int  main ( int  argc,  char   * argv[])
{
  gst_init ( & argc,  & argv);
   /*    */
}

      接下去需要创建三个元件并连接成管道，由于所有GStreamer元件都具有相同的基类GstElement，因此能够采用如下方式进行定义：

  GstElement  * pipeline,  * filesrc,  * decoder,  * audiosink;

      管道在GStreamer框架中是用来容纳和管理元件的，下面的代码将创建一条名为pipeline的新管道：

   /*  创建用来容纳元件的新管道  */
  pipeline  =  gst_pipeline_new ( " pipeline " );

      数据源元件负责从磁盘文件中读取数据，它具有名为location的属性，用来指明文件在磁盘上的位置。使用标准的GObject属性机制可以为元件设置相应的属性：

/*  创建数据源元件  */
filesrc  =  gst_element_factory_make ( " filesrc " ,  " disk_source " );
g_object_set (G_OBJECT (filesrc),  " location " , argv[ 1 ], NULL);

      过滤器元件负责完成对MP3格式的数据进行解码，最简单的办法是安装mad这一插件，借助它来完成相应的解码工作：

/*  创建过滤器元件  */
decoder  =  gst_element_factory_make ( " mad " ,  " decoder " ); 

      接收器元件负责将解码后的数据利用声卡播放出来：

/*  创建接收器元件  */
audiosink  =  gst_element_factory_make ( " audiosink " ,  " play_audio " )

      已经创建好的三个元件需要全部添加到管道中，并按顺序连接起来：

/*  添加元件到管道中  */
gst_bin_add_many (GST_BIN (pipeline), filesrc, decoder, audiosink, NULL);
/*  通过衬垫连接元件  */
gst_element_link_many (filesrc, decoder, audiosink, NULL); 

所有准备工作都做好之后，就可以通过将管道的状态切换到PLAYING状态，来启动整个管道的数据处理流程：

/*  启动管道  */
gst_element_set_state (pipeline, GST_STATE_PLAYING); 

      这里加入一个消息处理函数bus_call来监视产生的消息

/*  终止管道  */
gst_element_set_state (pipeline, GST_STATE_NULL);
/*  释放资源  */
gst_object_unref (GST_OBJECT (pipeline));

3,完整的源代码如下所示：

#include  < gst / gst.h >
#include  < glib.h >
// 定义消息处理函数,
static  gboolean bus_call(GstBus  * bus,GstMessage  * msg,gpointer data)
{
    GMainLoop  * loop  =  (GMainLoop  * ) data; // 这个是主循环的指针，在接受EOS消息时退出循环
     switch  (GST_MESSAGE_TYPE(msg))
    {
         case  GST_MESSAGE_EOS:
            g_print( " End of stream\n " );
            g_main_loop_quit(loop);
             break ;
         case  GST_MESSAGE_ERROR:
        {
                           gchar  * debug;
                           GError  * error;

                           gst_message_parse_error(msg, & error, & debug);
                           g_free(debug);
                           g_printerr( " ERROR:%s\n " ,error -> message);
                           g_error_free(error);
                           g_main_loop_quit(loop);
                            break ;
        }
         default :
              break ;
    }
     return  TRUE;
}

int  main( int  argc, char   * argv[])
{
    GMainLoop  * loop;
    GstElement  * pipeline, * source, * decoder, * sink; // 定义组件
    GstBus  * bus;

    gst_init( & argc, & argv);
    loop  =  g_main_loop_new(NULL,FALSE); // 创建主循环，在执行 g_main_loop_run后正式开始循环

     if (argc  !=   2 )
    {
        g_printerr( " Usage:%s <mp3 filename>\n " ,argv[ 0 ]);
         return   - 1 ;
    }
     // 创建管道和组件
    pipeline  =  gst_pipeline_new( " audio-player " );
    source  =  gst_element_factory_make( " filesrc " , " file-source " );
    decoder  =  gst_element_factory_make( " mad " , " mad-decoder " );
    sink  =  gst_element_factory_make( " autoaudiosink " , " audio-output " );

     if ( ! pipeline ||! source ||! decoder ||! sink){
        g_printerr( " One element could not be created.Exiting.\n " );
         return   - 1 ;
    }
     // 设置 source的location 参数。即 文件地址.
    g_object_set(G_OBJECT(source), " location " ,argv[ 1 ],NULL);
     // 得到 管道的消息总线
    bus  =  gst_pipeline_get_bus(GST_PIPELINE(pipeline));
    // 添加消息监视器
    gst_bus_add_watch(bus,bus_call,loop);
    gst_object_unref(bus);
     // 把组件添加到管道中.管道是一个特殊的组件，可以更好的让数据流动
    gst_bin_add_many(GST_BIN(pipeline),source,decoder,sink,NULL);
    // 依次连接组件
   gst_element_link_many(source,decoder,sink,NULL);
    // 开始播放
    gst_element_set_state(pipeline,GST_STATE_PLAYING);
    g_print( " Running\n " );
     // 开始循环
    g_main_loop_run(loop);
    g_print( " Returned,stopping playback\n " );
    gst_element_set_state(pipeline,GST_STATE_NULL);
    gst_object_unref(GST_OBJECT(pipeline));
     return   0 ;
}

4，编译运行

gcc -Wall  $( pkg-config --cflags --libs gstreamer- 0.10 )  -g test2 . c -o test2
./ test2  / home / phinecos / test . mp3

 

作者：洞庭散人

出处：http://phinecos.cnblogs.com/　　　　

本博客遵从 Creative Commons Attribution 3.0 License，若用于非商业目的，您可以自由转载，但请保留原作者信息和文章链接URL