Κατάσταση που εμφανίζεται το μήνυμα
Κάθε πελάτης πρέπει γενικά να είναι σε θέση να δείξει ποιοι συνάδελφοί διαβάζουν ποιο μήνυμα και να πάρει πόσα αδιαβασμένα μηνύματα υπάρχουν.
Για αυτό, ο δαίμονας παρέχει μερικές 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
))
Να λαμβάνεις μη διαβάζοντα μηνύματα
Γνωρίζοντας το τελευταίοDisplayedMessage για το λογαριασμό μας, μπορούμε να χρησιμοποιήσουμε αυτές τις πληροφορίες και ConfigrationManager::countInteractionsSince
που μετράνε την αλληλεπίδραση από το τελευταίο μήνυμα σε ένα δεδομένο μήνυμα (συνήθως η τελευταία αλληλεπίδραση που εμφανίζεται)
Για να εμφανιστεί τελευταία αγγελία για ένα μέλος, στο Συσταθμό::getConversationMembers
κάθε μέλος θα έχει την τελευταία εμφανισμένη αλληλεπίδραση διαθέσιμη μέσω memberInfo["lastDisplayed"]
Πώς αποθηκεύονται οι πληροφορίες αυτές
Στο src/jamidht/conversation.cpp
κάθε συζήτηση αποθηκεύει τα τελευταία εμφανισμένα μηνύματα σε έναν χάρτη<string, string> (uri, interactionId) και αυτή η δομή είναι σερριεσμένη σε fileutils::get_data_dir()/getAccountID()/conversation_data/repository_->id()/lastDisplayed