第 26 课:界面是怎么搭起来的 —— OBSApp、OBSBasic

嘿,我是小方。 前面 25 课,我们一直在"引擎盖下面"转 —— 讲的全是 libobs 这台 C 引擎:源、图形、编码、封装、输出、服务……可你天天打交道的,其实是那个有按钮、有预览、有场景列表的窗口。这个窗口是怎么来的?你点一下"开始直播",它又是怎么指挥引擎干活的? 这一课(模块 7 第一课)换个视角:从前端(C++/Qt6) 看全局。不过这是我们第一次认真碰 GUI 代码,风格和前面的 C 引擎很不一样,所以我会先补 Qt / GUI 的背景(什么是控件、事件循环、信号槽),再讲程序怎么启动(OBSApp)、主窗口怎么组织(OBSBasic),最后讲界面和引擎之间那道双向的桥 —— 你点一下怎么传到引擎、引擎出了事又怎么通知界面。零 Qt 基础也能跟上。

---

26.1 先分清两层:引擎(libobs)vs 界面(frontend)

📍我们在哪:前 25 课在"引擎盖下面";从这一课起,抬头看"引擎盖本身"和"驾驶座"。第一步,先把两层分清。

OBS 其实是两层:

• 引擎层 · libobs(C 语言):第 0~25 课学的全部(源/图形/合成/编码/封装/输出/服务…)。它是一个库,自己不带界面 —— 只提供一大堆 obs_xxx() 函数。命令行工具、别的软件,也能直接用这个库。
• 界面层 · frontend(C++ / Qt6):你双击的 obs-studio.exe —— 那个有按钮、预览、场景列表、混音器的窗口。它由 OBSApp(程序)、OBSBasic(主窗口)、各种对话框/面板组成。本模块(第 26~28 课)讲的就是它。

关键理解:引擎能独立存在,界面只是"最大的那个 libobs 用户"。 界面通过调用引擎的 obs_* 函数来使唤它。所以这一课其实是:看"界面"这个程序,怎么把前 25 课那台引擎"装起来、开起来、指挥起来"。

但在读界面代码前,得先认识它用的工具 —— Qt。

---

26.2 先补:什么是 GUI 框架?什么是 Qt?

📍为什么先讲这个:界面代码的"思路"和引擎代码很不一样。先认识几个 Qt 概念,后面看 OBSApp/OBSBasic 就不懵。

Qt 是 OBS 前端用的跨平台 C++ GUI 框架。它给你四样东西:

• ① 控件(widget):窗口里的零件 —— 按钮、滑块、列表、树、文本框…… Qt 提供一大堆现成的,你拼起来就是界面。
• ② 事件循环(event loop):GUI 程序不是"跑完就退",而是停在那儿"等你操作":来了鼠标/键盘事件 → 处理 → 继续等。App::exec() 就是这个循环。
• ③ 信号 / 槽(signals / slots):Qt 的事件机制 —— 某个控件"发信号"(按钮 clicked)→ 自动调用你"连(connect)"上去的函数("槽")。⚠️ 注意:这不是第 8 课那套 libobs 信号! 两套东西,后面它们还会打交道(26.7)。
• .ui 表单 + 跨平台:.ui 是用设计器"拖控件"画出来的界面(存成 XML,编译时生成代码);跨平台指同一套 C++ 能在 Windows/macOS/Linux 出窗口。

建立一个直觉:引擎代码(C)像"流水线"—— 数据一步步被处理(采集→编码→输出);界面代码(Qt/C++)像"接线员"—— 平时闲着等,你一点按钮,它就"接线"去调引擎、再把结果显示回来。OBS 的前端 = 一个 Qt 程序;它用"信号/槽"响应你的操作,用"obs_* 函数"指挥引擎。

好,进正题:这个 Qt 程序,从哪一行开始跑?

---

26.3 程序从哪开始:main → OBSApp → 主窗口 → 事件循环

📍接上一节:任何程序都从 main() 开始。看双击图标那一刻,代码怎么一步步把界面和引擎都搭起来。

main()                          // obs-main.cpp:857  装崩溃处理、解析命令行参数
  → run_program()               // obs-main.cpp:492
     → OBSApp program(...)       // obs-main.cpp:538  造 Qt 程序对象(OBSApp 继承 QApplication)
     → program.AppInit()         // OBSApp.cpp:1035   早期初始化:配置、语言、主题
     → program.OBSInit()         // OBSApp.cpp:1174   ★ 点火(下面展开)
          ├ obs_startup(...)      // OBSApp.cpp:1128   启动 libobs 核心
          ├ new OBSBasic()        // OBSApp.cpp:1252   造主窗口对象
          └ mainWindow->OBSInit() // OBSBasic.cpp:974  重置音视频 + 加载所有插件(第 9 课)+ show()
     → program.exec()            // obs-main.cpp:691   ★ 进入 Qt 事件循环 —— 停在这儿等你操作
  → obs_shutdown()               // OBSApp.cpp:1868   退出时关闭引擎

记住两个里程碑:

• obs_startup() = 引擎点火(在 OBSApp::OBSInit 里,OBSApp.cpp:1128);
• program.exec() = 界面开始等你操作(obs-main.cpp:691,这是 QApplication::exec(),"等用户事件,直到退出")。

在 exec() 之前,是"搭台";之后,就全靠"你点一下、它响应一下"了(26.6 起)。先看"点火"这一步的关键 —— OBSApp。

---

26.4 OBSApp:给引擎"点火"的那只手

📍放大 26.3 的 OBSInit:libobs 只是个库、自己不会动。是谁把它开起来的?就是 OBSApp。

OBSApp 是一个 QApplication 子类(这就是"OBS 前端是个 Qt 程序"的证据):

// frontend/OBSApp.hpp:63
class OBSApp : public QApplication {
	Q_OBJECT
	...
	QPointer<OBSMainWindow> mainWindow;   // 主窗口指针(:77)
};

它的 OBSInit() 依次做四件事,把前 25 课那台引擎"装上、通电":

1. obs_startup(...)(OBSApp.cpp:1128)—— 启动 libobs 核心;
2. obs_load_all_modules2(...)(OBSApp.cpp:1882)—— 加载所有插件(第 9 课那套 os_dlopen);
3. obs_reset_video / obs_reset_audio2(OBSBasic.cpp:1493/1667)—— 把音视频管线跑起来(第 14/16 课那两条心跳);
4. new OBSBasic()(OBSApp.cpp:1252)—— 造出主窗口,随后 mainWindow->OBSInit()(OBSApp.cpp:1268)完成上面 2、3 步并 show()。

所以"界面负责点火":没有前端调 obs_startup + 加载插件,libobs 就是一堆睡着的代码。 前 25 课那台引擎的所有能力,是在这一刻被"通电"的 —— 之后主窗口才有东西可指挥。

那主窗口 OBSBasic 本身,是怎么组织的?

---

26.5 主窗口 OBSBasic:一个"巨类",拆成 28 个文件

📍接上一节:new OBSBasic() 造出的这个主窗口,是整个界面的核心。但它大得吓人。

// frontend/widgets/OBSBasic.hpp:182
class OBSBasic : public OBSMainWindow {   // OBSMainWindow 就是 QMainWindow(OBSMainWindow.hpp:7)
	Q_OBJECT
	...

OBSBasic 是一个 QMainWindow(Qt 的主窗口类)。但它管的事太多(直播、录制、场景、转场、工作室模式、配置…),写成一个文件会有几万行,没法看。于是 OBS 把同一个类的方法,按功能拆进 28 个 OBSBasic_*.cpp 文件(加上主文件 OBSBasic.cpp):

OBSBasic_Streaming.cpp、OBSBasic_Recording.cpp、OBSBasic_Scenes.cpp、OBSBasic_SceneItems.cpp、OBSBasic_Transitions.cpp、OBSBasic_StudioMode.cpp、OBSBasic_Profiles.cpp、OBSBasic_VirtualCam.cpp、OBSBasic_Docks.cpp……

它们全都是 OBSBasic:: 开头,共享同一批成员变量 —— 只是物理上分了文件。(所以你在源码里搜一个 OBSBasic:: 方法,可能在任何一个 OBSBasic_*.cpp 里。)

它拥有你看到的 5 个面板(dock):场景、源、混音器、转场、控制(OBSBasic_Docks.cpp:84)—— 就是主窗口里那几块可拖动的区域。

搭好了台、造好了窗口,接下来是这一课的重点:界面和引擎怎么互相"说话"。 先看你 → 引擎这个方向。

---

26.6 方向一:界面驱动引擎(你点一下 → 调一个 obs_ 函数)

📍核心之一:界面上你能点、能拖、能拉的每个东西,最后都落到一次 libobs API 调用。

以"开始直播"为例,一路追下去(每一跳都在不同的 OBSBasic_*.cpp 里):

1. 你点 streamButton → Qt 把点击变成信号 clicked,再发出 StreamButtonClicked(OBSBasicControls.cpp:18);
2. 连到主窗口的槽 OBSBasic::StreamActionTriggered(OBSBasic.cpp:290 连接;逻辑在 OBSBasic_Streaming.cpp:373)—— 它判断当前是"该开始"还是"该停止";
3. 走到 OBSBasic::StartStreaming(OBSBasic_Streaming.cpp:48),它不直接调引擎,而是交给"输出处理器";
4. obs_output_start(streamOutput)(SimpleOutput.cpp:728)—— 到这就是第 22~24 课那个"开始推流"了。

obs_output_start 就是第 22~24 课那个"开始推流"—— 界面只是"按下开关"。 其它操作也一样:

界面操作	落到的 libobs 调用
拖一个"窗口捕获"进来	obs_source_create(...)(第 6 / 10 课)
点另一个场景	切换当前场景 / 转场(第 13 / 14 课)
拉动某路音量滑块	obs_source_set_volume(...)(第 16 / 17 课)
点"开始录制"	obs_output_start(录制那个 output)(第 23 课)

一句话:整个界面,就是一层"把你的点击翻译成 obs_* 调用"的壳。 你前面学的所有引擎能力,都是被界面上的某个按钮/菜单/滑块"这样"触发的。

反过来呢?引擎自己出了事,怎么告诉界面?

---

26.7 方向二:引擎回话界面(还得"跨线程")

📍核心之二,也是最巧的一处:引擎在别的线程上跑,出了事要通知界面 —— 但 Qt 界面不能被别的线程直接碰。怎么办?

想想推流:它跑在引擎的输出线程上(不是界面线程)。假设网络断了、推流停了:

1. libobs 在引擎线程上发信号 "stop"(第 8 课那套信号)→ 前端连的静态回调 OBSStopStreaming 被调用(BasicOutputHandler.cpp:57);
2. 但此刻还在"引擎线程"上! Qt 有条铁律:GUI 控件只能在"界面线程"上改;别的线程直接动按钮,轻则不刷新、重则崩溃;
3. 所以回调不直接改界面,而是用 QMetaObject::invokeMethod 把"请帮我调 StreamingStop 这个槽"的请求,投递到界面线程:

// frontend/utility/BasicOutputHandler.cpp:69(引擎线程里)
QMetaObject::invokeMethod(output->main, "StreamingStop",
                          Q_ARG(int, code), Q_ARG(QString, arg_last_error));

4. 界面线程在事件循环(exec)里取出这个请求,在自己线程上执行槽 OBSBasic::StreamingStop()(OBSBasic_Streaming.cpp:278)—— 于是安全地更新状态栏"已停止"、把按钮变回"开始直播"。

这正是第 8 课、第 14 课那个"跨线程 invokeMethod"的实战。 记住这条规矩和这个办法:

• 规矩:GUI 控件只能在界面线程上改;
• 办法:别的线程不直接改界面,而是 invokeMethod 把"请调这个槽"投递到界面线程的队列,由界面线程在事件循环里执行。

那些静态回调是怎么挂到引擎信号上的?靠 OBSSignal(第 8 课那个 RAII 包装).Connect 到 obs_output_get_signal_handler(SimpleOutput.cpp:631)。把两个方向合起来,看一次完整往返。

---

26.8 合起来:一次"开始直播"的完整往返

📍收束:把 26.6(去程)和 26.7(回程)拼成一个完整故事,中间夹着一个"输出处理器"当桥。

去程(界面 → 引擎):

点 streamButton (OBSBasicControls.cpp:18)
 → OBSBasic::StreamActionTriggered (OBSBasic_Streaming.cpp:373)
 → OBSBasic::StartStreaming (OBSBasic_Streaming.cpp:48)
 → outputHandler->StartStreaming (SimpleOutput.cpp:683)
 → obs_output_start(streamOutput) (SimpleOutput.cpp:728)

……推流跑着(第 24 课那套:握手、发包、丢帧)……直到你点停止、或网络断开。

回程(引擎 → 界面):

libobs 发 "stop" 信号(引擎线程) (SimpleOutput.cpp:638 连接)
 → 静态回调 OBSStopStreaming (BasicOutputHandler.cpp:57)
 → invokeMethod 投递到界面线程 (BasicOutputHandler.cpp:69)
 → OBSBasic::StreamingStop 槽 (OBSBasic_Streaming.cpp:278)
 → 按钮变回「开始直播」+ 状态栏更新 (OBSBasicControls.cpp:140)

中间那个 outputHandler(输出处理器,BasicOutputHandler / SimpleOutput / AdvancedOutput)是那座桥:主窗口不亲自调 obs_output_start、也不亲自接引擎信号,而是委托给这个处理器对象(主窗口成员 OBSBasic.hpp:671,按"简单/高级模式"创建 OBSBasic_OutputHandler.cpp:36)。这样主窗口保持"只管界面"、处理器专管"和输出打交道",分工清爽。

这就是界面与引擎的咬合方式:你的每次操作 obs_* 下去,引擎的每次状态变化 信号 + invokeMethod 回来。 整个 OBS,就是这样一来一回转起来的。

---

26.9 模块 7 开场:把它们串起来

站在这里回望:前 6 个模块,拆开讲了引擎的每一块;这个模块,从"界面"视角把它们连成一台完整的机器。

整张图很简单:界面 frontend(Qt)⟷ 引擎 libobs(C)→ 插件 plugins。界面用 obs_* 使唤引擎、用信号接引擎的回话;引擎又通过插件(win-capture / x264 / rtmp-services…)真正干活。

模块 7 路线图:

• 第 26 课(本课):界面怎么搭起来 —— OBSApp 点火引擎、OBSBasic 主窗口、UI ⟷ 引擎双向桥;
• 第 27 课:界面如何驱动引擎的细节 —— obs-frontend-api、属性面板(properties-view)怎么从 obs_properties 自动生成;
• 第 28 课:全链路总复盘 —— 追踪"一帧画面"从采集到直播间的完整旅程,把前面 28 课串成一个故事。

这一课带走的:① 前端是个 Qt 程序,负责给引擎点火(obs_startup)、并把你的操作翻译成 obs_* 调用;② 引擎反过来用"信号 + 跨线程 invokeMethod"通知界面更新。界面与引擎,就靠这一来一回咬合。

---

26.10 本课小结

• 两层:libobs(C 引擎) = 前 25 课的全部,是个不带界面的库(只提供 obs_* 函数);frontend(C++/Qt6) = 你双击的 obs-studio.exe 窗口。引擎能独立存在,界面只是"最大的 libobs 用户",通过 obs_* 使唤它。
• Qt 背景:控件(按钮/列表…)、事件循环(exec() 停着等操作)、信号/槽(控件发信号→连的槽被调,≠ libobs 信号)、.ui 表单、跨平台。界面像"接线员":等你操作→调引擎→显示结果。
• 启动序列:main()(obs-main.cpp:857)→ run_program → OBSApp program(:538,QApplication 子类)→ AppInit(配置/语言/主题,OBSApp.cpp:1035)→ OBSInit(:1174:obs_startup :1128 + new OBSBasic :1252 + mainWindow->OBSInit)→ exec()(:691,事件循环)→ 退出 obs_shutdown(:1868)。两里程碑:obs_startup=引擎点火,exec=开始等操作。
• OBSApp(点火):class OBSApp : public QApplication(OBSApp.hpp:63)。OBSInit 做四件事:obs_startup(启核心)→ obs_load_all_modules2(加载插件,第 9 课,:1882)→ obs_reset_video/audio(跑管线,OBSBasic.cpp:1493/1667)→ new OBSBasic(造窗口)。没有前端点火,libobs 就是睡着的代码。
• OBSBasic(主窗口):class OBSBasic : public QMainWindow(OBSBasic.hpp:182)。一个巨类,方法拆在 28 个 OBSBasic_*.cpp(Streaming/Recording/Scenes/Transitions/…)加主文件,全是 OBSBasic::、共享成员。拥有 5 个面板 dock(场景/源/混音器/转场/控制,OBSBasic_Docks.cpp:84)。
• 方向一(UI→引擎):点按钮 → Qt 信号 → OBSBasic 槽 → obs_* 调用。例:streamButton.clicked → StreamActionTriggered → StartStreaming → outputHandler->StartStreaming → obs_output_start(SimpleOutput.cpp:728)。整个界面 = 把点击翻译成 obs_* 的壳。
• 方向二(引擎→UI,跨线程):libobs 在引擎线程发信号(第 8 课)→ 静态回调 OBSStopStreaming(BasicOutputHandler.cpp:57)→ QMetaObject::invokeMethod(:69)投递到界面线程 → OBSBasic::StreamingStop 槽安全更新 UI。规矩:GUI 只能在界面线程改;办法:invokeMethod 跨线程投递(第 8/14 课实战)。
• 桥 = outputHandler(BasicOutputHandler/SimpleOutput/AdvancedOutput):主窗口委托它调 obs_output_start + 接引擎信号 + invokeMethod 回来。主窗口只管界面。
• 模块 7 开场:界面(Qt)⟷ 引擎(libobs)→ 插件;这一来一回,就是 OBS 转起来的方式。

26.11 动手 / 观察(本课作业)

1. 认两层:说清 libobs 和 frontend 各是什么、谁用谁。为什么说"引擎能独立存在,界面只是它的用户"?
2. 数 OBSBasic 的文件:在 frontend/widgets/ 里看有多少个 OBSBasic_*.cpp,挑三个文件名,猜猜各管什么功能。
3. 追一次点击:从 frontend/widgets/OBSBasicControls.cpp:18(streamButton)出发,跟着 StreamActionTriggered → StartStreaming,找到 SimpleOutput.cpp:728 的 obs_output_start。体会"点击 → obs_ 调用"。
4. 理解 invokeMethod:用自己的话说清 —— 为什么引擎线程不能直接改按钮?invokeMethod 解决了什么问题?(提示:GUI 单线程 + 事件循环。)
5. 翻源码:打开 frontend/OBSApp.hpp:63 确认 OBSApp : public QApplication;frontend/widgets/OBSBasic.hpp:182 确认 OBSBasic : public QMainWindow;frontend/OBSApp.cpp:1128 找 obs_startup、:1252 找 new OBSBasic。

下一课预告

这一课看到"点按钮 → 调 obs_*"。但有些界面是自动生成的:你在源的"属性"对话框里看到的一堆选项(分辨率下拉、颜色选择、路径框…),OBS 并没有为每种源手写界面 —— 它是根据源自己声明的 obs_properties,自动画出来的。这背后是一套很巧的机制。

第 27 课:界面如何驱动引擎 —— obs-frontend-api、属性面板 —— 我们看两样东西:obs-frontend-api(让前端插件在不碰 OBSBasic 的情况下驱动/观察界面的稳定 C 接口),以及 properties-view(把一个 obs_properties_t 自动渲染成 Qt 表单的机制)。下节课见。

---

📁 本课配图:imgs/26-01 ~ imgs/26-09 📌 源码锚点: 启动 frontend/obs-main.cpp:857(main)、:492(run_program)、:538(new OBSApp)、:547(AppInit)、:686(OBSInit)、:691(exec 事件循环)、:1053(main 调 run_program)；frontend/OBSApp.hpp:63(class OBSApp : public QApplication)、:77(mainWindow)、:139-141(AppInit/OBSInit)；frontend/OBSApp.cpp:1035(AppInit)、:699(InitLocale)、:1174(OBSInit)、:1128(obs_startup)、:1252(new OBSBasic)、:1268(mainWindow->OBSInit)、:1882(obs_load_all_modules2)、:1886(obs_post_load_modules)、:1868(obs_shutdown)；frontend/widgets/OBSBasic.cpp:974(OBSBasic::OBSInit)、:980-985(ResetAudio/Video)、:1493(obs_reset_video)、:1667(obs_reset_audio2)、:1036(loadAppModules)、:1158/:1181(show)； 主窗口 frontend/widgets/OBSBasic.hpp:182(class OBSBasic : public OBSMainWindow)、:671(outputHandler)；frontend/widgets/OBSMainWindow.hpp:7(: public QMainWindow)；frontend/widgets/OBSBasic_Docks.cpp:84(5 个 dock)；frontend/widgets/OBSBasic.cpp:283(controlsDock)； UI→引擎 frontend/widgets/OBSBasicControls.cpp:18(streamButton clicked)、frontend/widgets/OBSBasic.cpp:290(连 StreamActionTriggered)、frontend/widgets/OBSBasic_Streaming.cpp:373(StreamActionTriggered)、:48(StartStreaming)、frontend/utility/SimpleOutput.cpp:683(SimpleOutput::StartStreaming)、:728(obs_output_start)；frontend/widgets/OBSBasic_OutputHandler.cpp:36(创建 outputHandler)； 引擎→UI frontend/utility/BasicOutputHandler.cpp:49(OBSStartStreaming)、:54(invokeMethod StreamingStart)、:57(OBSStopStreaming)、:69(invokeMethod StreamingStop)；frontend/utility/SimpleOutput.cpp:631-638(OBSSignal.Connect 到 obs_output_get_signal_handler)；frontend/widgets/OBSBasic.hpp:1378-1380(StreamingStart/Stop 槽)、frontend/widgets/OBSBasic_Streaming.cpp:278(StreamingStop)、frontend/widgets/OBSBasicControls.cpp:140(按钮复位)。 注:Qt / GUI 框架 / 事件循环 / 跨线程为通用编程背景知识,非 OBS 源码内容。