Статус приказану поруку
Сваки клијент обично мора бити у стању да покаже који вршњак чита коју поруку и да схвати колико нерачитаних порука има.
За ово, демон пружа неке АПИ:
Podesite prikazanu poruku
У управљачу конфигурацијом се наводи:
<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>
Треба се урадити када се приказује интеракција и изабрана разговор.
Ово šalје 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
))
Примајте нечитане поруке
Знајући последњуDisplayedMessage за наш рачун, можемо користити ове информације и ConfigrationManager::countInteractionsSince
који броје интеракцију од последње поруке до одређене поруке (обично последње приказану интеракцију)
Да бисте добили последње приказану поруку за члана, у Конфигурација::getКонверсијаМемберови
сваки члан ће имати последње приказану интеракцију доступну преко мemberИнфо["ПослењеПоказано"]
Како се ове информације чувају
У src/jamidht/conversation.cpp
сваки разговор чува последње приказане поруке на мапи<string, string> (uri, interactionId) и ова структура серијализује у fileutils::get_data_dir()/getAccountID()/conversation_data/repository_->id()/lastDisplayed