QXmppMucManagerV2 Class

 auto *muc   = new QXmppMucManagerV2;
 auto *disco = new QXmppDiscoveryManager;
 client.addExtension(muc);
 client.addExtension(disco);

 muc->joinRoom(u"room@conference.example.org"_s, u"alice"_s).then(this, [](auto result) {
     if (auto *room = std::get_if<QXmppMucRoomV2>(&result)) {
         qDebug() << "Joined as" << room->nickname().value();
     }
 });

 auto r = muc->room(u"room@conference.example.org"_s);
 if (r.isValid()) {
     // use r
 }

 auto r = muc->room(u"room@conference.example.org"_s);
 QXmppMessage msg;
 msg.setBody(u"Hello, room!"_s);
 r.sendMessage(std::move(msg)).then(this, [](auto result) {
     // handle result
 });

 muc->createRoom(u"newroom@conference.example.org"_s, u"alice"_s).then(this, [](auto result) {
     if (auto *room = std::get_if<QXmppMucRoomV2>(&result)) {
         auto config = room->roomConfig().value().value_or(QXmppMucRoomConfig{});
         config.setName(u"My New Room"_s);
         room->setRoomConfig(config);
     }
 });

 // Kick a participant
 r.setRole(participant, QXmpp::Muc::Role::None, u"Misbehaving"_s);

 // Ban a user
 r.setAffiliation(u"user@example.org"_s, QXmpp::Muc::Affiliation::Outcast);

 // Fetch the member list
 r.requestAffiliationList(QXmpp::Muc::Affiliation::Member).then(this, [](auto result) {
     if (auto *list = std::get_if<QList<QXmpp::Muc::Item>>(&result)) {
         for (const auto &item : *list) {
             qDebug() << item.jid() << item.affiliation();
         }
     }
 });

 r.requestRoomConfig(true).then(this, [r](auto result) mutable {
     if (auto *config = std::get_if<QXmppMucRoomConfig>(&result)) {
         config->setMaxUsers(50);
         r.setRoomConfig(*config);
     }
 });

Member Function Documentation

QXmppMucManagerV2::QXmppMucManagerV2()

Default constructor.

[since QXmpp 1.16] QXmppTask<QXmpp::Result<QXmppMucRoomV2>> QXmppMucManagerV2::createRoom(QString serviceJid, QString nickname, std::optional<QString> roomName = std::nullopt)

Creates a new reserved (locked) MUC room on serviceJid with the given nickname.

If roomName is set, the room is created at roomName@serviceJid. If roomName is unset, createRoom() asks the service for a unique localpart via XEP-0307 (muc#unique); if that query fails for any reason (service does not support XEP-0307, IQ error, …), it falls back to a client-generated UUID localpart so creation still succeeds against any compliant MUC service.

The room is created in a locked state; no other users can join until the owner submits the configuration form via QXmppMucRoomV2::setRoomConfig(). The task resolves once the server has confirmed room creation (XEP-0045 status code 201) and the configuration form has been fetched. If the local state machine detects that the room is already tracked, the task fails immediately.

This function was introduced in QXmpp 1.16.

[since QXmpp 1.16] QXmppTask<QXmpp::SendResult> QXmppMucManagerV2::declineInvitation(const QString &roomJid, QXmpp::Muc::Decline decline)

Declines a mediated invitation by sending decline as a message to roomJid.

Can be called before joining the room. Set decline.to() to the inviter's JID.

This function was introduced in QXmpp 1.16.

[override virtual] QStringList QXmppMucManagerV2::discoveryFeatures() const

Supported service discovery features.

QXmppTask<QXmpp::Result<QXmppMucRoomV2>> QXmppMucManagerV2::joinRoom(const QString &jid, const QString &nickname)

Joins the MUC room at jid with the given nickname.

Sends an initial presence to the room and waits for all occupant presences that the MUC service sends back. The returned task resolves once the server sends the self-presence with status code 110, meaning the participant list is already fully populated when the task finishes.

If a join for the same room is already in progress the task fails immediately. If the room is already joined the existing room handle is returned as a success.

jid is the bare JID of the room (e.g. room\@conference.example.org). nickname is the desired nickname — must not be empty.

[since QXmpp 1.16] QBindable<QStringList> QXmppMucManagerV2::mucServices() const

Returns the JIDs of discovered MUC services on the server.

The list is populated automatically after connecting and updated reactively.

This function was introduced in QXmpp 1.16.

[since QXmpp 1.16] QBindable<bool> QXmppMucManagerV2::mucServicesLoaded() const

Returns whether MUC service discovery has completed.

This function was introduced in QXmpp 1.16.

[since QXmpp 1.16] QXmppTask<QXmpp::Result<QString>> QXmppMucManagerV2::requestUniqueRoomName(QString serviceJid)

Requests a unique room localpart from the MUC serviceJid (XEP-0307: Unique Room Names for Multi-User Chat).

Returns the full room JID (localpart@serviceJid) which can be passed to createRoom(). Fails if the service does not support XEP-0307: Unique Room Names for Multi-User Chat or returns an empty name.

This function was introduced in QXmpp 1.16.

[since QXmpp 1.16] std::chrono::milliseconds QXmppMucManagerV2::selfPingSilenceThreshold() const

Returns the XEP-0410: MUC Self-Ping silence threshold.

After a room has been silent for this duration, the manager sends a self-ping to verify that the client is still joined. A zero value disables self-pinging entirely.

This function was introduced in QXmpp 1.16.

See also setSelfPingSilenceThreshold().

[since QXmpp 1.16] QXmppTask<QXmpp::SendResult> QXmppMucManagerV2::sendDirectInvitation(const QString &to, QXmpp::Muc::DirectInvitation invitation, QXmppMessage message = {})

Sends a direct invitation (XEP-0249) to to.

Direct invitations are sent peer-to-peer and are not routed through the room. The optional message parameter can be used to set custom extensions on the message stanza; the to, type, and invitation fields will be overwritten.

This function was introduced in QXmpp 1.16.

[since QXmpp 1.16] void QXmppMucManagerV2::setSelfPingSilenceThreshold(std::chrono::milliseconds threshold)

Sets the XEP-0410: MUC Self-Ping silence threshold.

After threshold of silence on a joined room, the manager sends an XEP-0199: XMPP Ping to the user's own occupant JID and interprets the response to detect silent server-side eviction ("ghosting"). Defaults to 5 minutes. Pass a zero duration to disable self-pinging entirely.

Ghosted rooms are surfaced via removedFromRoom() with LeaveReason::ConnectionLost.

This function was introduced in QXmpp 1.16.

See also selfPingSilenceThreshold().