)
简介CSDN博客专家、《Android系统多媒体进阶实战》作者博主新书推荐《Android系统多媒体进阶实战》Android Audio工程师专栏地址Audio工程师进阶系列【原创干货持续更新中……】Android多媒体专栏地址多媒体系统工程师系列【原创干货持续更新中……】专题一 二AAOS车载系统AOSP14系统攻城狮入门视频实战课专题三Android14 Binder之HIDL与AIDL通信实战课专题四Android15快速自定义与集成音效实战课专题五Android15音频策略实战课专题六Android15音频性能实战课(无声/杂音/断音/爆音实战案例)人生格言人生从来没有捷径只有行动才是治疗恐惧和懒惰的唯一良药.更多原创,欢迎关注Android系统攻城狮文章目录1.前言要点概括2.应用场景与用法函数原型参数说明返回值应用场景3.调用流程剖析3.1核心步骤3.2调用流程图3.3生命周期图4.实战应用案例5.一句话总结1.前言本篇目的Linux PipeWire深度解析之pw_main_loop_run调用流程与实战。要点概括核心功能运行PipeWire主循环让当前线程进入事件等待和事件分发流程。工作机制内部持续迭代pw_loop等待IO、Timer、Signal、Defer等事件源就绪并把事件派发到对应回调。典型用途PipeWire客户端程序、测试Demo、命令行工具、音频播放/录音示例程序中的主事件循环。pw_main_loop_run的本质是“运行主循环”不是创建主循环也不是创建Context、Core或Stream。主循环对象由pw_main_loop_new创建底层pw_loop可以通过pw_main_loop_get_loop取得事件循环真正开始运行时才调用pw_main_loop_run。它和pw_main_loop_get_loop不同。pw_main_loop_get_loop只返回底层pw_loop指针用于注册Signal、IO、Timer等事件源pw_main_loop_run会阻塞当前线程并持续驱动事件分发。它和pw_main_loop_quit也不同。pw_main_loop_quit只负责请求主循环退出不负责销毁资源。pw_main_loop_run返回后应用仍然需要按顺序销毁Stream、Core、Context和MainLoop对象。2.应用场景与用法pw_main_loop_run是PipeWireMainLoop API中用于运行主事件循环的接口。它位于PipeWire客户端程序的最外层调度位置。应用完成pw_init、pw_main_loop_new、pw_context_new、pw_context_connect、Stream创建或Registry监听后通常调用pw_main_loop_run让当前线程进入事件循环。后续PipeWire服务端消息、Stream状态变化、Registry对象通知、Signal退出事件都会在该循环中被分发。pw_main_loop_run用于启动并运行PipeWire主事件循环。函数原型intpw_main_loop_run(structpw_main_loop*loop);参数说明structpw_main_loop*loop;loop表示由pw_main_loop_new创建的PipeWire主循环对象。该对象内部维护底层pw_loop和退出事件源。应用可以通过pw_main_loop_get_loop取得底层pw_loop然后注册Signal、Timer、IO等事件源。pw_main_loop_run运行时会基于这些事件源持续等待和分发事件。返回值成功退出时返回0表示主循环被正常退出请求打断例如调用pw_main_loop_quit。失败时返回负错误码通常表示底层事件迭代过程出现错误。实际开发中常见用法是把pw_main_loop_run作为客户端程序的主阻塞点退出后再进入资源清理流程。应用场景第一类场景是PipeWire客户端常驻程序。客户端连接PipeWire服务端后需要持续接收Core、Registry、Node、Stream等事件。pw_main_loop_run负责让客户端线程一直等待事件并在事件到达时分发回调。第二类场景是音频播放和录音Demo。应用创建pw_stream后播放或录音过程依赖process、state_changed、param_changed等回调。pw_main_loop_run运行后这些回调才会被持续触发。第三类场景是命令行测试工具。很多PipeWire测试程序需要等待异步结果例如等待Registry枚举完成、等待Stream进入STREAMING状态、等待用户按CtrlC退出。pw_main_loop_run负责把这些异步事件串到同一个主循环里。第四类场景是信号退出控制。应用可以通过pw_main_loop_get_loop取得底层pw_loop再注册SIGINT和SIGTERM信号处理。收到退出信号时调用pw_main_loop_quitpw_main_loop_run随后返回程序进入清理流程。3.调用流程剖析3.1核心步骤1.应用调用pw_init初始化PipeWire库运行环境。2.应用调用pw_main_loop_new创建主循环对象。3.应用调用pw_main_loop_get_loop取得底层pw_loop用于后续创建Context或注册事件源。4.应用调用pw_context_new创建PipeWireContext。5.应用调用pw_context_connect连接PipeWire服务端得到Core连接对象。6.应用根据业务需要创建Registry、Stream、Signal、Timer或IO事件源。7.应用调用pw_main_loop_run当前线程进入主循环运行态。8.主循环内部持续等待事件源就绪。9.事件就绪后底层pw_loop把事件派发给对应回调。10.回调中可以处理PipeWire消息、Stream数据、Registry对象变化或退出信号。11.如果没有退出请求pw_main_loop_run继续进入下一轮事件等待。12.如果调用pw_main_loop_quit主循环退出pw_main_loop_run返回。13.应用在run返回后销毁Core、Context、MainLoop等资源。3.2调用流程图3.3生命周期图4.实战应用案例下面以“创建PipeWire客户端主循环并支持CtrlC退出”为例说明pw_main_loop_run在真实程序中的位置。这个案例的目标是应用完成PipeWire初始化、创建MainLoop、创建Context、连接PipeWire服务端然后调用pw_main_loop_run进入事件循环。用户按CtrlC后Signal回调调用pw_main_loop_quit主循环返回程序进入清理阶段。#includesignal.h#includepipewire/pipewire.hstructapp_data{structpw_main_loop*main_loop;structpw_context*context;structpw_core*core;};staticvoidon_signal(void*userdata,intsignal_number){structapp_data*datauserdata;(void)signal_number;pw_main_loop_quit(data-main_loop);}on_signal是Signal事件回调。它不直接销毁PipeWire对象只调用pw_main_loop_quit请求主循环退出。真正的资源释放放在pw_main_loop_run返回之后执行这样可以避免在事件回调中提前释放仍在使用的对象。intmain(intargc,char*argv[]){structapp_datadata{0};structpw_loop*loop;pw_init(argc,argv);data.main_looppw_main_loop_new(NULL);if(data.main_loopNULL)gotoout_deinit;looppw_main_loop_get_loop(data.main_loop);pw_loop_add_signal(loop,SIGINT,on_signal,data);pw_loop_add_signal(loop,SIGTERM,on_signal,data);data.contextpw_context_new(loop,NULL,0);if(data.contextNULL)gotoout_main_loop;data.corepw_context_connect(data.context,NULL,0);if(data.coreNULL)gotoout_context;pw_main_loop_run(data.main_loop);pw_core_disconnect(data.core);out_context:pw_context_destroy(data.context);out_main_loop:pw_main_loop_destroy(data.main_loop);out_deinit:pw_deinit();return0;}这段代码中pw_main_loop_run是程序的主阻塞点。它开始运行后当前线程不会继续向下执行直到主循环收到退出请求或底层事件循环出现错误。主循环运行期间PipeWire服务端消息、Signal事件和业务事件都会通过同一个pw_loop分发。客户端不需要自己写poll、epoll或事件等待逻辑只需要把事件源注册到pw_loop然后交给pw_main_loop_run统一驱动。在播放或录音程序中pw_main_loop_run的位置也类似。应用先创建Stream并注册Stream事件回调再调用pw_main_loop_run。运行期间Stream的state_changed、param_changed和process回调会被PipeWire事件循环持续触发。staticvoidon_stream_process(void*userdata){/* * 播放流通常在这里dequeue buffer并填充PCM数据。 * 录音流通常在这里dequeue buffer并读取PCM数据。 */(void)userdata;}对于音频程序来说pw_main_loop_run不直接处理PCM数据。它只负责运行事件循环。真正的数据处理发生在Stream回调中例如process回调。主循环负责调度回调Stream回调负责处理媒体数据。工程上需要注意三点。第一pw_main_loop_run会阻塞当前线程。它适合放在主线程末尾或者放在专门的PipeWire线程中运行。第二不要把资源销毁逻辑直接塞进Signal回调。Signal回调中只请求退出等pw_main_loop_run返回后再统一清理资源。第三pw_main_loop_run不等于Graph调度本身。它运行的是客户端事件循环负责接收服务端消息、分发回调和驱动客户端侧状态变化。PipeWire服务端Graph的实时处理由服务端和相关Driver Node调度完成。5.一句话总结pw_main_loop_run是PipeWire客户端程序的主事件循环入口它阻塞当前线程并持续分发pw_loop事件让Core、Registry、Stream和Signal回调能够被触发直到pw_main_loop_quit请求主循环退出。
