feat(ext-image-capture): Add multi-screen recording support

- Introduce `MultiScreenCaptureCoordinator` and `MultiScreenFrameCompositor` classes to manage multi-screen capture functionality and composite captured frames.
- Enhance `ExtCaptureIntegration` to support starting and stopping multi-screen recordings.
- Add new signals to `ExtCaptureIntegration` for handling multi-screen frame readiness and error reporting.
- Update relevant header and source files to include the new multi-screen components, significantly improving overall screen recording capabilities.

特性(ext-image-capture): 添加多屏幕录制支持

- 引入 `MultiScreenCaptureCoordinator` 和 `MultiScreenFrameCompositor` 类，用于管理多屏幕捕获功能和进行帧合成。
- 增强 `ExtCaptureIntegration`，以支持多屏幕录制的启动和停止操作。
- 为 `ExtCaptureIntegration` 添加新信号，用于处理多屏幕帧准备就绪和错误报告。
- 更新相关的头文件和源文件，纳入新的多屏幕组件，显著提升了整体屏幕录制能力。

Author: dengzhongyuan365-dev

src/ext-image-capture/extcaptureintegration.cpp

@@ -7,22 +7,39 @@
 #include "manager/extcapturemanager.h"
 #include "session/extcapturesession.h"
 #include "frame/extcaptureframe.h"
+#include "multiscreencapturecoordinator.h"
 #include "../utils/log.h"
 
 #include <QDebug>
 #include <QTimer>
+#include <QGuiApplication>
 
 ExtCaptureIntegration::ExtCaptureIntegration(QObject *parent)
     : QObject(parent)
     , m_manager(new ExtCaptureManager(this))
     , m_session(nullptr)
+    , m_multiScreenCoordinator(new MultiScreenCaptureCoordinator(this))
     , m_recording(false)
+    , m_multiScreenRecording(false)
 {
     // 连接管理器信号
     connect(m_manager, &ExtCaptureManager::protocolAvailable,
             this, &ExtCaptureIntegration::onProtocolAvailable);
     connect(m_manager, &ExtCaptureManager::protocolUnavailable,
             this, &ExtCaptureIntegration::onProtocolUnavailable);
+    
+    // 设置多屏协调器的捕获管理器
+    m_multiScreenCoordinator->setCaptureManager(m_manager);
+    
+    // 连接多屏协调器信号
+    connect(m_multiScreenCoordinator, &MultiScreenCaptureCoordinator::compositeFrameReady,
+            this, &ExtCaptureIntegration::onMultiScreenFrameReady);
+    connect(m_multiScreenCoordinator, &MultiScreenCaptureCoordinator::captureStarted,
+            this, &ExtCaptureIntegration::onMultiScreenCaptureStarted);
+    connect(m_multiScreenCoordinator, &MultiScreenCaptureCoordinator::captureStopped,
+            this, &ExtCaptureIntegration::onMultiScreenCaptureStopped);
+    connect(m_multiScreenCoordinator, &MultiScreenCaptureCoordinator::error,
+            this, &ExtCaptureIntegration::onMultiScreenCaptureError);
 }
 
 ExtCaptureIntegration::~ExtCaptureIntegration()
@@ -91,20 +108,33 @@ bool ExtCaptureIntegration::startScreenRecording(QScreen *screen, bool includeCu
 
 void ExtCaptureIntegration::stopRecording()
 {
-    if (!m_recording) {
+    qCDebug(dsrApp) << "ExtCaptureIntegration::stopRecording: Stopping recording"
+                    << "single screen:" << m_recording << "multi screen:" << m_multiScreenRecording;
+
+    if (!m_recording && !m_multiScreenRecording) {
         return;
     }
 
-    m_recording = false;
+    // 停止单屏录制
+    if (m_recording) {
+        m_recording = false;
 
-    if (m_session) {
-        m_session->stop();
-        m_session->deleteLater();
-        m_session = nullptr;
+        if (m_session) {
+            m_session->stop();
+            m_session->deleteLater();
+            m_session = nullptr;
+        }
+
+        emit recordingStopped();
+        qCDebug(dsrApp) << "Single screen recording stopped";
     }
 
-    emit recordingStopped();
-    qDebug() << "Screen recording stopped";
+    // 停止多屏录制
+    if (m_multiScreenRecording) {
+        m_multiScreenCoordinator->stopMultiScreenCapture();
+        // m_multiScreenRecording 将在 onMultiScreenCaptureStopped 中设置为 false
+        qCDebug(dsrApp) << "Multi-screen recording stop requested";
+    }
 }
 
 bool ExtCaptureIntegration::captureFrame()
@@ -241,3 +271,87 @@ void ExtCaptureIntegration::onFrameFailed(const QString &reason)
     emit error(QString("Frame capture failed: %1").arg(reason));
 }
 
+bool ExtCaptureIntegration::startMultiScreenRecording(const QList<QScreen*>& screens, bool includeCursor)
+{
+    qCWarning(dsrApp) << "ExtCaptureIntegration::startMultiScreenRecording: Starting with" 
+                      << screens.size() << "screens, includeCursor:" << includeCursor;
+
+    if (m_recording || m_multiScreenRecording) {
+        qCWarning(dsrApp) << "ExtCaptureIntegration: Already recording";
+        return false;
+    }
+
+    if (!isAvailable()) {
+        qCWarning(dsrApp) << "ExtCaptureIntegration: Protocol not available";
+        emit error("Protocol not available");
+        return false;
+    }
+
+    if (screens.isEmpty()) {
+        qCWarning(dsrApp) << "ExtCaptureIntegration: No screens provided";
+        emit error("No screens to record");
+        return false;
+    }
+
+    // 开始多屏捕获
+    if (!m_multiScreenCoordinator->startMultiScreenCapture(screens, includeCursor)) {
+        qCWarning(dsrApp) << "ExtCaptureIntegration: Failed to start multi-screen capture";
+        emit error("Failed to start multi-screen capture");
+        return false;
+    }
+
+    m_multiScreenRecording = true;
+    qCWarning(dsrApp) << "ExtCaptureIntegration: Multi-screen recording started";
+    
+    return true;
+}
+
+bool ExtCaptureIntegration::captureMultiScreenFrame()
+{
+    if (!m_multiScreenRecording) {
+        qCWarning(dsrApp) << "ExtCaptureIntegration: Not in multi-screen recording mode";
+        return false;
+    }
+
+    return m_multiScreenCoordinator->captureMultiScreenFrame();
+}
+
+bool ExtCaptureIntegration::isMultiScreenRecording() const
+{
+    return m_multiScreenRecording;
+}
+
+QList<QScreen*> ExtCaptureIntegration::getAvailableScreens() const
+{
+    return QGuiApplication::screens();
+}
+
+void ExtCaptureIntegration::onMultiScreenFrameReady(const QByteArray& compositeFrameData, 
+                                                   int width, int height, int stride, uint64_t timestamp)
+{
+    qCDebug(dsrApp) << "ExtCaptureIntegration::onMultiScreenFrameReady: Composite frame ready"
+                    << "size:" << compositeFrameData.size() << "dimensions:" << width << "x" << height;
+
+    emit multiScreenFrameReady(compositeFrameData, width, height, stride, timestamp);
+}
+
+void ExtCaptureIntegration::onMultiScreenCaptureStarted()
+{
+    qCDebug(dsrApp) << "ExtCaptureIntegration::onMultiScreenCaptureStarted";
+    emit recordingStarted();
+}
+
+void ExtCaptureIntegration::onMultiScreenCaptureStopped()
+{
+    qCDebug(dsrApp) << "ExtCaptureIntegration::onMultiScreenCaptureStopped";
+    m_multiScreenRecording = false;
+    emit recordingStopped();
+}
+
+void ExtCaptureIntegration::onMultiScreenCaptureError(const QString& message)
+{
+    qCWarning(dsrApp) << "ExtCaptureIntegration::onMultiScreenCaptureError:" << message;
+    m_multiScreenRecording = false;
+    emit error(QString("Multi-screen capture error: %1").arg(message));
+}
+

src/ext-image-capture/extcaptureintegration.h

@@ -8,10 +8,13 @@
 
 #include <QObject>
 #include <QScreen>
+#include <QList>
+#include <QRect>
 
 class ExtCaptureManager;
 class ExtCaptureSession;
 class ExtCaptureFrame;
+class MultiScreenCaptureCoordinator;
 
 /**
  * @brief ext-image-copy-capture集成接口
@@ -39,6 +42,14 @@ class ExtCaptureIntegration : public QObject
      */
     bool startScreenRecording(QScreen *screen, bool includeCursor = false);
 
+    /**
+     * @brief 开始多屏录制
+     * @param screens 要录制的屏幕列表
+     * @param includeCursor 是否包含光标
+     * @return 是否成功开始
+     */
+    bool startMultiScreenRecording(const QList<QScreen*>& screens, bool includeCursor = false);
+
     /**
      * @brief 停止录制
      */
@@ -50,11 +61,27 @@ class ExtCaptureIntegration : public QObject
      */
     bool captureFrame();
 
+    /**
+     * @brief 捕获多屏帧
+     * @return 是否成功开始捕获
+     */
+    bool captureMultiScreenFrame();
+
     /**
      * @brief 获取当前会话状态
      */
     bool isRecording() const;
 
+    /**
+     * @brief 是否正在进行多屏录制
+     */
+    bool isMultiScreenRecording() const;
+
+    /**
+     * @brief 获取支持的屏幕列表
+     */
+    QList<QScreen*> getAvailableScreens() const;
+
 signals:
     /**
      * @brief 协议变为可用
@@ -99,6 +126,16 @@ class ExtCaptureIntegration : public QObject
      */
     void dmaFrameReady(int dmaBufferFd, void *gbmBo, size_t size, int width, int height, int stride, uint64_t timestamp);
 
+    /**
+     * @brief 多屏合成帧就绪
+     * @param compositeFrameData 合成后的帧数据
+     * @param width 帧宽度
+     * @param height 帧高度
+     * @param stride 行字节数
+     * @param timestamp 时间戳
+     */
+    void multiScreenFrameReady(const QByteArray& compositeFrameData, int width, int height, int stride, uint64_t timestamp);
+
     /**
      * @brief 发生错误
      */
@@ -113,10 +150,18 @@ private slots:
     void onFrameReady(ExtCaptureFrame *frame);
     void onFrameFailed(const QString &reason);
 
+private slots:
+    void onMultiScreenFrameReady(const QByteArray& compositeFrameData, int width, int height, int stride, uint64_t timestamp);
+    void onMultiScreenCaptureStarted();
+    void onMultiScreenCaptureStopped();
+    void onMultiScreenCaptureError(const QString& message);
+
 private:
     ExtCaptureManager *m_manager;
     ExtCaptureSession *m_session;
+    MultiScreenCaptureCoordinator *m_multiScreenCoordinator;
     bool m_recording;
+    bool m_multiScreenRecording;
 };
 
 #endif // EXTCAPTUREINTEGRATION_H