QT/QML在树莓派4无X环境下实现多屏同显的方案问询

一、优先尝试系统级克隆模式（最简便） #

树莓派4 Lite基于DRM/KMS架构，无需依赖X桌面，可通过配置系统参数直接实现双HDMI输出克隆，无需修改QT代码：

• 编辑/boot/config.txt，确保以下配置（根据你的显示器分辨率调整参数）：

  # 启用VC4 KMS驱动
  dtoverlay=vc4-kms-v3d
  # 强制双HDMI热插拔（避免未检测到显示器的情况）
  hdmi_force_hotplug=1
  hdmi_force_hotplug:1=1
  # 设置双屏克隆模式
  hdmi_clone=1
  # 配置屏幕分辨率（示例为1920x1080）
  hdmi_group=1
  hdmi_mode=16
  hdmi_group:1=1
  hdmi_mode:1=16
  

• 重启树莓派后，系统会自动将两个HDMI输出设为同步克隆状态，此时你的QT/QML应用只需正常启动（指定EGLFS平台），内容会自动在双屏同步显示。

二、QT代码级实现方案（系统克隆不可用时） #

若系统级克隆无法满足需求，可通过QT多窗口绑定同一内容组件实现同步：

1. 确认QT识别双屏幕
   启动应用时指定EGLFS平台，并检查屏幕列表：

   ./your_app -platform eglfs -listScreens
   

   若未识别到两个屏幕，需先排查树莓派config.txt的HDMI配置是否正确。

2. QML代码实现同步显示
   将核心展示内容封装为独立组件，在多个Window实例中复用该组件，利用QT的数据绑定自动同步状态：

   import QtQuick 2.12
   import QtQuick.Window 2.12
   
   // 封装核心展示内容
   Component {
       id: displayContent
       Rectangle {
           anchors.fill: parent
           // 替换为你的信息展示内容
           Text {
               text: qsTr("同步展示的信息内容")
               anchors.centerIn: parent
               font.pixelSize: 50
               color: "#ffffff"
           }
       }
   }
   
   // 主屏幕窗口
   Window {
       id: screen1Window
       visible: true
       screen: Screen.screens[0]
       width: Screen.screens[0].availableWidth
       height: Screen.screens[0].availableHeight
       displayContent {}
   }
   
   // 第二屏幕窗口
   Window {
       id: screen2Window
       visible: true
       screen: Screen.screens[1]
       width: Screen.screens[1].availableWidth
       height: Screen.screens[1].availableHeight
       displayContent {}
   }
   

3. C++辅助配置（可选）
   若需在C++层控制屏幕，可通过QGuiApplication获取屏幕列表，动态创建窗口：

   #include <QGuiApplication>
   #include <QQmlApplicationEngine>
   #include <QScreen>
   
   int main(int argc, char *argv[])
   {
       QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
       QGuiApplication app(argc, argv);
   
       QQmlApplicationEngine engine;
       // 获取所有屏幕
       QList<QScreen*> screens = app.screens();
       for (int i = 0; i < screens.size(); ++i) {
           QQmlComponent component(&engine, QUrl(QStringLiteral("qrc:/DisplayContent.qml")));
           QObject *content = component.create();
           QQuickWindow *window = qobject_cast<QQuickWindow*>(content);
           if (window) {
               window->setScreen(screens[i]);
               window->show();
           }
       }
   
       return app.exec();
   }
   

三、注意事项 #

• 确保QT应用编译时启用了EGLFS支持，树莓派4 Lite环境下QT 5.12默认已适配OpenGLES。
• 若双屏分辨率不同，可在displayContent组件中使用Scale或布局组件适配不同尺寸，避免内容变形。
• 启动应用时务必指定-platform eglfs参数，确保在无X环境下使用正确的渲染后端。

内容的提问来源于stack exchange，提问作者Aros