简介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_thread_loop_wait调用流程与实战。要点概括核心功能让当前线程在PipeWireThread Loop锁保护下进入等待状态直到其他线程调用pw_thread_loop_signal唤醒。工作机制调用时要求已经持有loop锁函数内部会释放锁并阻塞等待收到signal后重新获得锁并返回。典型用途等待PipeWire异步连接完成、等待Stream状态变化、等待对象创建完成、等待回调线程更新共享状态。pw_thread_loop_wait的本质是线程同步接口不是事件分发接口也不是Graph处理接口。它不直接处理音频数据不触发process回调也不驱动PipeWire服务端工作。它通常和pw_thread_loop_lock、pw_thread_loop_unlock、pw_thread_loop_signal配套使用。应用线程先加锁检查条件如果条件未满足就调用pw_thread_loop_wait等待回调线程在状态变化后加锁更新条件再调用pw_thread_loop_signal唤醒等待线程。它和pw_thread_loop_timed_wait的区别是pw_thread_loop_wait没有超时返回只能等待signal唤醒pw_thread_loop_timed_wait带超时时间可以避免无限阻塞。它和pw_thread_loop_accept也不同accept只用于配合signal的wait_for_accept握手机制不是普通等待入口。2.应用场景与用法pw_thread_loop_wait是PipeWireThread Loop API中用于线程等待和条件同步的接口。Thread Loop会把PipeWireLoop运行在独立线程中应用线程可以通过Thread Loop锁保护共享状态。由于PipeWire连接、注册表事件、Stream状态变化等操作都可能通过异步回调完成所以应用经常需要等待某个状态从“未完成”变成“已完成”。pw_thread_loop_wait用于在持有Thread Loop锁时释放锁并等待其他线程调用pw_thread_loop_signal唤醒。函数原型voidpw_thread_loop_wait(structpw_thread_loop*loop);参数说明structpw_thread_loop*loop;loop表示已经创建的PipeWireThread Loop对象。调用该函数前当前线程必须已经调用pw_thread_loop_lock持有该loop的锁。该函数内部会临时释放锁使其他线程或回调可以进入临界区更新状态。被pw_thread_loop_signal唤醒后它会重新获得锁然后返回到调用点。返回值该函数没有返回值。void由于没有返回值调用者不能通过返回码判断等待原因。工程上通常使用“条件变量模式”处理wait返回后再次检查业务条件而不是假设signal一定表示目标状态已经满足。典型写法如下pw_thread_loop_lock(loop);while(!done)pw_thread_loop_wait(loop);pw_thread_loop_unlock(loop);这里必须使用while检查条件而不是只用if。因为线程可能被唤醒后发现条件仍未满足也可能存在多个等待线程共享同一个signal。应用场景第一类场景是等待PipeWire连接完成。应用创建pw_context、pw_core或pw_stream后连接过程通常伴随异步事件。主线程可以等待回调线程更新connected状态避免在对象未准备完成时继续访问后续资源。第二类场景是等待Stream进入目标状态。播放或录音应用调用pw_stream_connect后Stream状态会通过state_changed回调上报。应用线程可以通过pw_thread_loop_wait等待Stream进入PAUSED、STREAMING或ERROR状态。第三类场景是等待全局对象发现完成。客户端连接PipeWireCore后Registry会异步上报Node、Device、Factory、Metadata等全局对象。应用如果需要等待目标对象出现可以在registry回调中更新状态并signal。第四类场景是同步业务线程和PipeWire事件线程。应用线程负责创建对象和发起请求Thread Loop线程负责事件处理和回调执行。pw_thread_loop_wait把这两类线程用同一把锁和signal机制串起来避免忙等和竞态。3.调用流程剖析3.1核心步骤1.应用调用pw_thread_loop_new创建Thread Loop对象。2.应用调用pw_thread_loop_start启动独立Loop线程。3.应用线程调用pw_thread_loop_lock进入受保护临界区。4.应用线程检查业务条件例如connected、ready、done、error等状态。5.如果条件已经满足应用线程直接继续执行。6.如果条件未满足应用线程调用pw_thread_loop_wait进入等待。7.pw_thread_loop_wait内部释放Thread Loop锁使回调线程可以更新共享状态。8.回调线程在状态变化时持有同一把锁更新业务条件。9.回调线程调用pw_thread_loop_signal唤醒等待线程。10.pw_thread_loop_wait被唤醒后重新获得Thread Loop锁并返回调用点。11.应用线程再次检查条件条件满足后调用pw_thread_loop_unlock退出临界区。12.如果条件仍未满足应用线程继续调用pw_thread_loop_wait等待下一次signal。3.2调用流程图3.3生命周期图4.实战应用案例下面以“等待Stream状态变化”为例说明pw_thread_loop_wait在真实开发中的用法。应用调用pw_stream_connect后Stream状态不会立即变成目标状态。状态变化会通过pw_stream_events.state_changed回调异步通知。主线程如果需要等待Stream进入PAUSED或STREAMING状态就可以使用pw_thread_loop_wait。structapp_data{structpw_thread_loop*loop;structpw_stream*stream;bool stream_ready;bool stream_error;};staticvoidon_stream_state_changed(void*userdata,enumpw_stream_stateold,enumpw_stream_statestate,constchar*error){structapp_data*appuserdata;pw_thread_loop_lock(app-loop);switch(state){casePW_STREAM_STATE_PAUSED:casePW_STREAM_STATE_STREAMING:app-stream_readytrue;break;casePW_STREAM_STATE_ERROR:casePW_STREAM_STATE_UNCONNECTED:app-stream_errortrue;break;default:break;}pw_thread_loop_signal(app-loop,false);pw_thread_loop_unlock(app-loop);}state_changed回调中只做三件事加锁、更新状态、发送signal。这样可以保证应用线程看到的stream_ready和stream_error状态是受锁保护的不会出现读写竞态。主线程等待状态变化时使用while循环检查条件。staticintwait_stream_ready(structapp_data*app){intret0;pw_thread_loop_lock(app-loop);while(!app-stream_ready!app-stream_error)pw_thread_loop_wait(app-loop);if(app-stream_error)ret-1;pw_thread_loop_unlock(app-loop);returnret;}这段代码的关键点不是“等待一次signal”而是“等待条件成立”。signal只是唤醒手段真正决定是否继续执行的是stream_ready和stream_error。完整使用链路通常如下staticconststructpw_stream_eventsstream_events{PW_VERSION_STREAM_EVENTS,.state_changedon_stream_state_changed,};staticintsetup_stream(structapp_data*app){intret;app-stream_readyfalse;app-stream_errorfalse;app-looppw_thread_loop_new(stream-loop,NULL);if(app-loopNULL)return-1;retpw_thread_loop_start(app-loop);if(ret0)returnret;pw_thread_loop_lock(app-loop);app-streampw_stream_new_simple(pw_thread_loop_get_loop(app-loop),playback-stream,NULL,stream_events,app);if(app-streamNULL){pw_thread_loop_unlock(app-loop);return-1;}/* * 这里通常继续调用pw_stream_connect。 * connect后状态通过state_changed异步返回。 */pw_thread_loop_unlock(app-loop);retwait_stream_ready(app);if(ret0)returnret;return0;}这个案例中pw_thread_loop_wait负责解决“同步线程等待异步回调结果”的问题。应用线程不需要轮询状态也不需要sleep等待。回调线程只要在状态变化后调用pw_thread_loop_signal等待线程就可以被及时唤醒。工程上要特别注意三点。第一调用pw_thread_loop_wait前必须先调用pw_thread_loop_lock。否则等待和状态更新不在同一个同步模型中容易产生竞态。第二wait返回后必须重新检查条件。不要把signal理解成“目标状态一定完成”signal只表示“有线程通知你重新检查状态”。第三不要在持锁状态下执行耗时操作。Thread Loop回调也会在锁保护下执行长时间占用锁会阻塞PipeWire事件处理导致状态通知、对象创建或Stream处理延迟。pw_thread_loop_wait常见错误写法如下pw_thread_loop_lock(loop);if(!ready)pw_thread_loop_wait(loop);pw_thread_loop_unlock(loop);这段代码只检查一次ready。如果线程被唤醒后ready仍然为false后续逻辑仍会继续执行容易访问未初始化对象。更安全的写法是pw_thread_loop_lock(loop);while(!ready!error)pw_thread_loop_wait(loop);pw_thread_loop_unlock(loop);这样可以同时处理正常完成、错误退出和重复唤醒问题。5.一句话总结pw_thread_loop_wait是PipeWireThread Loop中的等待同步接口调用线程必须先持有loop锁wait内部释放锁并等待pw_thread_loop_signal唤醒返回后重新持锁适合等待连接、状态变化和异步回调结果。