메시지가 표시된 상태

일반적으로 모든 고객은 어떤 동료가 어떤 메시지를 읽는지 보여주며 얼마나 많은 읽지 않은 메시지를 얻을 수 있어야 합니다.

이 데몬은 몇 가지 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 status 3 (libjami::Account::MessageStates::DISPLAYED))

읽지 않은 메시지를 받습니다

우리의 계정에서 마지막 디스플레이된 메시지를 알고, 우리는 이 정보를 사용할 수 있습니다 ConfigrationManager::countInteractionsSince, 이는 주어진 메시지에 대한 마지막 메시지 (일반적으로 마지막 표시된 상호 작용) 이후 상호 작용을 계산합니다

구성원에게 마지막으로 표시된 메시지를 얻기 위해, 구성원:get 대화Members각 구성원은memberInfo[“최후 표시된”] `를 통해 마지막으로 표시된 상호 작용을 사용할 수 있습니다

이 정보의 저장 방식

src/jamidht/conversation.cpp에서 대화마다 마지막 표시된 메시지가 지도<string, string> (uri, interactionId) 에서 저장되며 이 구조는 fileutils::get_data_dir()/getAccountID()/conversation_data/repository_->id()/lastDisplayed로 순차적으로 표시됩니다