简介CSDN博客专家、《Android系统多媒体进阶实战》作者博主新书推荐《Android系统多媒体进阶实战》Android Audio工程师专栏地址Audio工程师进阶系列【原创干货持续更新中……】Android多媒体专栏地址多媒体系统工程师系列【原创干货持续更新中……】专题一 二AAOS车载系统AOSP14系统攻城狮入门视频实战课专题三Android14 Binder之HIDL与AIDL通信实战课专题四Android15快速自定义与集成音效实战课专题五Android15音频策略实战课专题六Android15音频性能实战课(无声/杂音/断音/爆音实战案例)人生格言人生从来没有捷径只有行动才是治疗恐惧和懒惰的唯一良药.更多原创,欢迎关注Android系统攻城狮文章目录1. 前言要点概括2. 应用场景与用法函数原型参数说明返回值应用场景3. 调用流程剖析3.1 核心步骤1. 创建 Main Loop2. 定义事件回调3. 构造 pw_main_loop_events4. 准备 spa_hook5. 调用 add_listener6. 注册 Listener7. 销毁 Main Loop8. 触发 destroy 回调3.2 调用流程图3.3 Main Loop Listener生命周期图4. 实战应用案例5. 一句话总结按相同结构整理如下。1. 前言本篇目的Linux PipeWire 深度解析之pw_main_loop_add_listener调用流程与实战。要点概括核心功能为pw_main_loop注册生命周期事件监听器。工作机制应用准备spa_hook、pw_main_loop_events和用户数据然后调用pw_main_loop_add_listener()将监听器加入 Main Loop 的 Listener 列表。典型用途监听 Main Loop 销毁、执行资源解绑、同步对象生命周期、调试 Main Loop 释放流程。2. 应用场景与用法pw_main_loop_add_listener()是 PipeWire Main Loop 生命周期监听接口。应用创建pw_main_loop后可以通过该接口注册pw_main_loop_events监听 Main Loop 产生的生命周期事件。当前pw_main_loop_events主要提供void(*destroy)(void*data);回调。该接口用于把spa_hook和pw_main_loop_events注册到指定 Main Loop在 Main Loop 销毁时执行对应回调。需要注意pw_main_loop_add_listener()只完成监听器注册不会启动 Main Loop也不会立即执行destroy回调。函数原型voidpw_main_loop_add_listener(structpw_main_loop*loop,structspa_hook*listener,conststructpw_main_loop_events*events,void*data);参数说明loop:目标 pw_main_loop 对象 listener:应用提供的 spa_hook 用于保存监听器注册关系 events:Main Loop事件回调表 类型为 pw_main_loop_events data:传递给事件回调的用户数据返回值无返回值调用完成后listener被加入目标 Main Loop 的监听器列表。应用场景pw_main_loop_add_listener()常见应用场景主要有三类。第一类是监听 Main Loop 销毁。当应用调用pw_main_loop_destroy()时已经注册的destroy回调会被触发。应用可以在回调中记录 Main Loop 生命周期结束、更新对象状态或解除上层对象引用。第二类是资源生命周期同步。某些业务对象、调试对象或自定义上下文依赖 Main Loop 存活。通过pw_main_loop_add_listener()注册监听器后可以在 Main Loop 销毁时同步修改这些对象的状态防止后续继续访问已经失效的 Main Loop。第三类是 Main Loop 销毁流程调试。在分析 PipeWire 客户端退出、资源释放顺序或异常销毁问题时可以通过destroy回调打印日志确认pw_main_loop_destroy()是否执行以及 Main Loop 在整个资源清理链路中的销毁时机。3. 调用流程剖析3.1 核心步骤1. 创建 Main Loop应用首先调用structpw_main_loop*main_loop;main_looppw_main_loop_new(NULL);创建pw_main_loop对象。2. 定义事件回调应用定义 Main Loop 销毁回调staticvoidmain_loop_destroy_cb(void*userdata){/* * 处理Main Loop销毁事件 */}3. 构造 pw_main_loop_events应用创建事件回调表staticconststructpw_main_loop_eventsmain_loop_events{PW_VERSION_MAIN_LOOP_EVENTS,.destroymain_loop_destroy_cb,};其中PW_VERSION_MAIN_LOOP_EVENTS指定事件结构版本。4. 准备 spa_hook应用准备structspa_hooklistener;spa_hook用于保存监听器节点、事件表和用户数据之间的关联关系。5. 调用 add_listener应用执行pw_main_loop_add_listener(main_loop,listener,main_loop_events,userdata);6. 注册 Listenerpw_main_loop_add_listener()把以下信息绑定到spa_hookpw_main_loop_events userdata Listener节点并把 Listener 挂入 Main Loop 内部的监听器列表。7. 销毁 Main Loop当应用执行pw_main_loop_destroy(main_loop);Main Loop 开始执行销毁流程。8. 触发 destroy 回调Main Loop 遍历已经注册的 Listener并执行main_loop_destroy_cb(userdata);将注册时传入的data交给回调函数。3.2 调用流程图3.3 Main Loop Listener生命周期图4. 实战应用案例#includepipewire/pipewire.h// PipeWire核心API#includestdio.h#includestdlib.hstructapp_data{structpw_main_loop*main_loop;// Main Loop对象structspa_hooklistener;// Main Loop监听器intdestroyed;// 销毁状态};staticvoidmain_loop_destroy_cb(void*userdata){structapp_data*datauserdata;data-destroyed1;printf(main loop destroy callback\n);}staticconststructpw_main_loop_eventsmain_loop_events{PW_VERSION_MAIN_LOOP_EVENTS,.destroymain_loop_destroy_cb,};intmain(intargc,char*argv[]){structapp_datadata{0};pw_init(argc,argv);// 初始化PipeWire环境data.main_looppw_main_loop_new(NULL);// 创建Main Loopif(!data.main_loop){fprintf(stderr,pw_main_loop_new failed\n);pw_deinit();returnEXIT_FAILURE;}pw_main_loop_add_listener(data.main_loop,data.listener,main_loop_events,data);// 注册Main Loop生命周期监听器pw_main_loop_destroy(data.main_loop);// 销毁Main Loop并触发destroy回调data.main_loopNULL;pw_deinit();// 释放PipeWire环境资源returndata.destroyed?EXIT_SUCCESS:EXIT_FAILURE;}5. 一句话总结pw_main_loop_add_listener()本质上是“把一个spa_hook生命周期监听器注册到指定pw_main_loop”。它负责保存pw_main_loop_events和用户数据并在 Main Loop 销毁时触发destroy回调是 PipeWire Main Loop 生命周期监控、资源状态同步和销毁流程调试中的基础接口。