显示消息状态

总体而言,每个客户都必须能够显示哪些同行阅读哪些消息,

为了实现这一点,该恶魔提供了一些API:

设置显示的消息

配置管理器提供:

<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>

必须在显示交互和选择对话时进行.

这将以以下格式发送SIP消息给连接的同行:

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>");
}

然后同行通过 onMessageDisplayed来了解这一点,并发出信号给客户端 (libjami::ConfigurationSignal::AccountMessageStatusChanged与状态3 (libjami::Account::MessageStates::DISPLAYED))

接收未读的消息

通过了解我们帐户的最后显示消息,我们可以使用此信息和ConfigrationManager::countInteractionsSince`,这些信息计算自最后一个消息到给定的消息 (通常是最后一次显示的互动)

为了获得一个成员的最后显示消息,在 Configuration::getConversationMembers每个成员将通过 `memberInfo[“最后显示”]]]]]

如何存储这些信息

在 src/jamidht/conversation.cpp中,每个对话都存储在地图<string, string> (uri, interactionId) 中最后显示的消息,并且这个结构是序列化在 fileutils::get_data_dir()/getAccountID()/conversation_data/repository_->id()/lastDisplayed