)
简介：CSDN博客专家、《Android系统多媒体进阶实战》作者
博主新书推荐：《Android系统多媒体进阶实战》🚀
Android Audio工程师专栏地址：Audio工程师进阶系列【原创干货持续更新中……】🚀
Android多媒体专栏地址：多媒体系统工程师系列【原创干货持续更新中……】🚀
专题一 二：AAOS车载系统+AOSP14系统攻城狮入门视频实战课🚀
专题三：Android14 Binder之HIDL与AIDL通信实战课🚀
专题四：Android15快速自定义与集成音效实战课🚀
专题五：Android15音频策略实战课🚀
专题六：Android15音频性能实战课(无声/杂音/断音/爆音实战案例)🚀
人生格言：人生从来没有捷径，只有行动才是治疗恐惧和懒惰的唯一良药.
🍉🍉🍉文章目录🍉🍉🍉
- 🌻1.前言
- 要点概括
- 🌻2.应用场景与用法
- 函数原型
- 参数说明
- 返回值
- 应用场景
- 🌻3.调用流程剖析
- 🌻3.1核心步骤
- 🌻3.2调用流程图
- 🌻3.3生命周期图
- 🌻4.实战应用案例
- 🌻5.一句话总结
🌻1.前言
本篇目的：
Linux PipeWire深度解析之pw_context_new调用流程与实战。
要点概括
核心功能：创建PipeWire上下文对象，为后续Core连接、对象管理、模块加载和事件处理提供运行环境。
工作机制：基于已有pw_loop分配pw_context对象，保存属性配置，初始化内部管理结构，并返回Context句柄。
典型用途：PipeWire客户端初始化、服务端上下文创建、后续调用pw_context_connect建立Core连接。
pw_context_new的本质是“创建PipeWire运行上下文”。它不是创建MainLoop，也不是连接PipeWire服务端，更不是创建音频Graph中的Node、Port或Link。
它位于PipeWire应用初始化链路中。应用通常先调用pw_init初始化库环境，再创建pw_main_loop，然后通过pw_main_loop_get_loop取得pw_loop，最后把pw_loop传给pw_context_new创建Context。
它和pw_main_loop_new不同。pw_main_loop_new负责创建事件循环容器，pw_context_new负责创建PipeWire对象运行上下文。它和pw_context_connect也不同，pw_context_connect才会基于Context连接PipeWire服务端并返回Core对象。它和pw_context_destroy是一对接口，new负责创建，destroy负责释放。
🌻2.应用场景与用法
pw_context_new
是PipeWireContext API中用于创建PipeWire上下文对象的接口。
它处在PipeWire初始化主链路中，位于MainLoop之后、Core连接之前。Context创建完成后，应用才能继续调用pw_context_connect连接PipeWire服务端，获取pw_core对象，并通过Registry、Proxy、Stream等机制进入后续对象交互流程。
pw_context_new用于创建PipeWire上下文对象。
函数原型
structpw_context*pw_context_new(structpw_loop*main_loop,structpw_properties*props,size_tuser_data_size);参数说明
structpw_loop*main_loop;main_loop表示PipeWire使用的事件循环对象。
它通常来自pw_main_loop_get_loop。pw_context_new不会创建MainLoop，也不会启动MainLoop，只是保存这个pw_loop并基于它建立Context内部运行环境。
structpw_properties*props;props表示传入Context的属性集合。
它可以传NULL。传NULL时，Context会使用默认属性创建。实际开发中，可以通过props传入配置名、运行参数或应用自定义属性。创建成功后，props生命周期由Context管理，应用不要重复释放同一个props对象。
size_tuser_data_size;user_data_size表示为Context附加的用户私有数据大小。
如果不需要附加私有数据，可以传0。如果需要把业务状态和Context绑定，可以传入结构体大小，然后通过Context相关接口取得用户数据区。
返回值
成功时返回：
structpw_context*表示创建成功的PipeWire上下文对象。
失败时返回NULL。常见原因包括参数不合法、内存分配失败或内部资源初始化失败。返回NULL后，应用不能继续调用pw_context_connect，需要先处理错误并释放已经创建的MainLoop资源。
应用场景
第一类场景是普通PipeWire客户端初始化。
播放器、录音程序、屏幕采集程序、测试工具等客户端进程，都可以先创建MainLoop，再创建Context，然后通过pw_context_connect连接PipeWire服务端。
第二类场景是工具类程序访问PipeWire对象。
例如查看Registry对象、监听Node变化、枚举Device、调试PipeWire对象属性时，也需要先创建Context，再建立Core连接。
第三类场景是服务端或嵌入式运行环境初始化。
在自定义PipeWire运行环境中，Context可以作为对象管理、模块加载和内部事件处理的基础对象。此时Context不只是客户端连接前置对象，也是PipeWire服务端侧对象创建的运行上下文。
第四类场景是需要绑定私有状态的框架封装。
业务代码可以通过user_data_size把私有结构挂到Context生命周期上，使Context创建、连接、运行和销毁过程与业务状态保持一致。
🌻3.调用流程剖析
🌻3.1核心步骤
1.应用调用pw_init初始化PipeWire库环境。
2.应用调用pw_main_loop_new创建主循环对象。
3.应用调用pw_main_loop_get_loop取得底层pw_loop指针。
4.应用准备Context属性props，可以传NULL，也可以传入自定义属性集合。
5.应用调用pw_context_new，并传入main_loop、props和user_data_size。
6.pw_context_new分配pw_context对象和可选用户私有数据区。
7.pw_context_new保存main_loop，接管props，并初始化Context内部资源。
8.Context内部完成对象管理、模块管理、Factory管理和事件相关支撑结构初始化。
9.函数返回pw_context句柄。此时Context已经创建，但还没有连接PipeWire服务端。
10.应用后续调用pw_context_connect创建pw_core连接，再进入Registry监听、Stream创建或对象管理流程。
🌻3.2调用流程图
🌻3.3生命周期图
🌻4.实战应用案例
下面以“创建Context并连接PipeWire服务端”为例，说明pw_context_new在实际开发中的位置。
这个案例的目标是建立最小PipeWire初始化链路：初始化库环境、创建MainLoop、创建Context、连接Core，最后按正确顺序释放资源。
#include<pipewire/pipewire.h>structapp_data{structpw_main_loop*main_loop;structpw_context*context;structpw_core*core;};staticintapp_init(structapp_data*app){structpw_loop*loop;app->main_loop=pw_main_loop_new(NULL);if(app->main_loop==NULL)return-1;loop=pw_main_loop_get_loop(app->main_loop);if(loop==NULL)return-1;app->context=pw_context_new(loop,NULL,0);if(app->context==NULL)return-1;app->core=pw_context_connect(app->context,NULL,0);if(app->core==NULL)return-1;return0;}staticvoidapp_clear(structapp_data*app){if(app->core!=NULL)pw_core_disconnect(app->core);if(app->context!=NULL)pw_context_destroy(app->context);if(app->main_loop!=NULL)pw_main_loop_destroy(app->main_loop);}intmain(intargc,char*argv[]){structapp_dataapp={0};pw_init(&argc,&argv);if(app_init(&app)<0){app_clear(&app);pw_deinit();return-1;}/* * 实际项目中，可以在这里注册Registry监听、 * 创建Stream、枚举对象或进入pw_main_loop_run。 */app_clear(&app);pw_deinit();return0;}这个案例中，pw_context_new只负责创建Context。它依赖前面已经创建好的pw_loop，也服务于后面的pw_context_connect。
开发时要注意三个边界。
第一，pw_context_new不是连接接口。Context创建成功后，只能说明本地上下文已经准备好，不能说明已经连接PipeWire服务端。真正的连接动作由pw_context_connect完成。
第二，pw_context_new不是事件循环启动接口。MainLoop是否运行，取决于后续是否调用pw_main_loop_run。Context只是使用这个loop，不负责启动它。
第三，资源释放要按反向顺序执行。通常先断开Core连接，再销毁Context，最后销毁MainLoop。这样可以避免Context仍持有事件和对象时，底层loop已经被提前释放。
如果需要给Context绑定私有状态，可以使用user_data_size：
structcontext_private{uint32_tobject_count;bool connected;};structpw_context*context;context=pw_context_new(loop,NULL,sizeof(structcontext_private));if(context==NULL)return-1;这种方式适合框架封装。业务状态跟随Context创建和销毁，不需要额外维护一份独立生命周期。但普通应用如果没有这种需求，user_data_size传0即可。
🌻5.一句话总结
pw_context_new是PipeWire初始化链路中的Context创建接口：它基于已有pw_loop创建pw_context对象，为后续pw_context_connect、对象管理和事件处理提供运行上下文，但它本身不创建MainLoop、不启动事件循环，也不等于已经连接PipeWire服务端。
