Qt QDBus连接org.gnome.SettingsDaemon.MediaKeys无信号接收问题求助

我编写了一段C++代码，试图通过Qt与QDBus连接org.gnome.SettingsDaemon.MediaKeys D-Bus服务，监听其MediaPlayerKeyPressed信号以获取媒体按键触发通知。代码可编译运行，但无法接收信号。我已通过dbus-send测试GrabMediaPlayerKeys方法正常，问题应出在代码中，恳请帮忙排查错误。

原代码如下：

#include <QtWidgets/QApplication>
#include <QtDBus/QtDBus>
#include <QtWidgets/QLabel>
#include <QtCore/QString>
#include "mediaHandler.h"

#define SERVICE_NAME "org.gnome.SettingsDaemon.MediaKeys"
#define OBJECT_PATH "/org/gnome/SettingsDaemon/MediaKeys"
#define INTERFACE_NAME "org.gnome.SettingsDaemon.MediaKeys"
#define SIGNAL_NAME "MediaPlayerKeyPressed"

void MediaHandler::MediaPlayerKeyPressed(QString name, QString key)
{
    qDebug("test %s", name.toStdString().c_str());
}

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QDBusInterface interface(SERVICE_NAME,
                             OBJECT_PATH,
                             INTERFACE_NAME,
                             QDBusConnection::sessionBus());
    if (!interface.isValid())
    {
        qDebug("interface is not valid\n");
        qDebug("%s\n", qPrintable(QDBusConnection::sessionBus().lastError().message()));
        exit(1);
    }

    qDebug("interface is valid");
    QDBusReply<void> reply = interface.call("GrabMediaPlayerKeys", "test", (unsigned int)0);
    if (!reply.isValid())
    {
        qDebug("Reply was: invalid");
        qDebug("%s", qPrintable(reply.error().message()));
        exit(1);
    }

    qDebug("Reply was: valid");

    MediaHandler mediaHandler;

    if (!QObject::connect(&interface, SIGNAL(MediaPlayerKeyPressed(QString, QString)),
                          &mediaHandler, SLOT(MediaPlayerKeyPressed(QString, QString))))
    {
        qDebug("error1:%s",
               qPrintable(QDBusConnection::sessionBus().lastError().message()));
    }
    else
    {
        qDebug("connected");
    }

    return app.exec();
}

1. MediaHandler类未继承QObject且缺少Q_OBJECT宏 #

Qt的信号槽机制依赖元对象系统，只有继承QObject的类才能使用槽函数，且必须在类定义中添加Q_OBJECT宏，否则元对象系统无法识别槽函数，信号无法触发。

修改mediaHandler.h：

#ifndef MEDIAHANDLER_H
#define MEDIAHANDLER_H

#include <QObject>
#include <QDebug>

class MediaHandler : public QObject
{
    Q_OBJECT
public:
    explicit MediaHandler(QObject *parent = nullptr) : QObject(parent) {}

public slots:
    void MediaPlayerKeyPressed(QString name, QString key)
    {
        qDebug() << "Received media key:" << key << "from" << name;
    }
};

#endif // MEDIAHANDLER_H

2. 改用Qt5+新式信号槽语法 #

旧式SIGNAL/SLOT宏依赖字符串匹配，容易因参数类型隐式转换、拼写错误等导致连接失败却无明确编译提示。改用基于函数指针的新式语法，编译期即可检测错误。

修改main函数中的connect代码：

bool connected = QObject::connect(&interface, &QDBusInterface::MediaPlayerKeyPressed,
                                  &mediaHandler, &MediaHandler::MediaPlayerKeyPressed);
if (!connected)
{
    qDebug() << "Connect failed:" << QDBusConnection::sessionBus().lastError().message();
}
else
{
    qDebug() << "Signal connected successfully";
}

3. 确保moc文件正确生成 #

修改类定义后，需重新运行qmake（或CMake）生成对应的moc文件，否则元对象系统无法识别槽函数，信号依然无法触发。

mediaHandler.h #

#ifndef MEDIAHANDLER_H
#define MEDIAHANDLER_H

#include <QObject>
#include <QDebug>

class MediaHandler : public QObject
{
    Q_OBJECT
public:
    explicit MediaHandler(QObject *parent = nullptr) : QObject(parent) {}

public slots:
    void MediaPlayerKeyPressed(QString name, QString key)
    {
        qDebug() << "Media key triggered: name=" << name << ", key=" << key;
    }
};

#endif // MEDIAHANDLER_H

main.cpp #

#include <QtWidgets/QApplication>
#include <QtDBus/QtDBus>
#include "mediaHandler.h"

#define SERVICE_NAME "org.gnome.SettingsDaemon.MediaKeys"
#define OBJECT_PATH "/org/gnome/SettingsDaemon/MediaKeys"
#define INTERFACE_NAME "org.gnome.SettingsDaemon.MediaKeys"

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QDBusInterface interface(SERVICE_NAME,
                             OBJECT_PATH,
                             INTERFACE_NAME,
                             QDBusConnection::sessionBus());
    if (!interface.isValid())
    {
        qDebug() << "Interface invalid:" << QDBusConnection::sessionBus().lastError().message();
        return 1;
    }

    qDebug() << "Interface valid";
    QDBusReply<void> reply = interface.call("GrabMediaPlayerKeys", "QtMediaKeyListener", 0u);
    if (!reply.isValid())
    {
        qDebug() << "GrabMediaPlayerKeys failed:" << reply.error().message();
        return 1;
    }

    qDebug() << "GrabMediaPlayerKeys succeeded";

    MediaHandler mediaHandler;

    bool connected = QObject::connect(&interface, &QDBusInterface::MediaPlayerKeyPressed,
                                      &mediaHandler, &MediaHandler::MediaPlayerKeyPressed);
    if (!connected)
    {
        qDebug() << "Connect failed:" << QDBusConnection::sessionBus().lastError().message();
    }
    else
    {
        qDebug() << "Signal connected";
    }

    return app.exec();
}

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