Az üzenet megjelenített állapot

Minden ügyfélnek általában meg kell tudnia mutatni, hogy melyik társa olvas, melyik üzenet, és megtudnia kell, hány olvasatlan üzenet van.

Ehhez a rendszerfolyamat néhány API-t biztosít:

Beállítsa a megjelenített üzenetet

A konfigurációs kezelő a következőket írja elő:

<method name="setMessageDisplayed" tp:name-for-bindings="setMessageDisplayed">
    <tp:added version="8.1.0"/>
    <tp:docstring>
        <p>Informs that a message have been read</p>
    </tp:docstring>
    <arg type="s" name="accountId" direction="in">
        <tp:docstring>
        The account ID
        </tp:docstring>
    </arg>
    <arg type="s" name="conversationUri" direction="in">
        <tp:docstring>
        A conversation uri (swarm:xxxx or jami:xxxx)
        </tp:docstring>
    </arg>
    <arg type="s" name="messageId" direction="in">
        <tp:docstring>
        The message ID
        </tp:docstring>
    </arg>
    <arg type="i" name="status" direction="in">
        <tp:docstring>
        The message status, 3 for displayed
        </tp:docstring>
    </arg>
    <arg type="b" name="success" direction="out">
        <tp:docstring>
        True if the message status was set, false if account, contact or message is unknown.
        </tp:docstring>
    </arg>
</method>

A kommunikáció megjelenítése és a beszélgetés kiválasztása esetén kell ezt megtenni.

Ez a következő formátumú SIP üzeneteket küld a csatlakoztatott társainak:

std::string
getDisplayed(const std::string& conversationId, const std::string& messageId)
{
    // implementing https://tools.ietf.org/rfc/rfc5438.txt
    return fmt::format(
        "<?xml version=\"1.0\" encoding=\"utf-8\" ?>\n"
        "<imdn><message-id>{}</message-id>\n"
        "{}"
        "<display-notification><status><displayed/></status></display-notification>\n"
        "</imdn>",
        messageId,
        conversationId.empty() ? "" : "<conversation>" + conversationId + "</conversation>");
}

A társa a onMessageDisplayed útján fogja tudni ezt, és egy jelet küld a kliensnek (libjami::ConfigurationSignal::AccountMessageStatusChanged 3 állapotával (libjami::Account::MessageStates::DISPLAYED))

Olvasatlan üzeneteket kap

Ha ismerjük az utolsóDisplayedMessage számláinkat, akkor ezt az információt és a ConfigrationManager::countInteractionsSince-t használhatjuk, amelyek számolják az interaktív kapcsolatot az utolsó üzenettől a megadott üzenetig (általában az utolsó megjelenített interaktív kapcsolat)

A tagnak az utolsó megjelenített üzenethez a Konfiguráció::getConversationMembers minden tagnak lesz az utolsó megjelenített interakció a `memberInfo[„LastDisplayed”]]] segítségével.

Hogyan tárolható ez az információ

A src/jamidht/conversation.cpp-ben minden beszélgetés tárolja az utolsó megjelenített üzeneteket egy térképen<string, string> (uri, interactionId) és ez a szerkezet a fileutils::get_data_dir()/getAccountID()/conversation_data/repository_->id()/lastDisplayed-ben sorolódik