1.4 KiB
Recently used emoji
{{% added-in v="1.18" %}}
This module enables clients to track a user's cumulated emoji usage across different
devices. The data is stored in the m.recent_emoji
global account data and can,
among other things, be used to generate recommendations
in emoji pickers.
Events
{{% event event="m.recent_emoji" %}}
Client behaviour
What exactly constitutes trackable emoji usage is left as an implementation detail for clients. It is RECOMMENDED to include sending emoji in both messages and annotations.
When an emoji is used, the sending client moves (or adds) it to the beginning of
the recent_emoji array and increments (or initializes) its counter. This keeps
the array ordered by last usage time which facilitates evaluating the data. How
exactly the client evaluates and uses the collected data is deliberately left
unspecified.
To prevent excessive growth of the event as new emoji are being used, clients
SHOULD limit the length of the recent_emoji array by dropping elements from
its end. A RECOMMENDED maximum length is 100 emoji.
To enable future extension, clients MUST tolerate and preserve array elements
within recent_emoji that they don't understand or support. This means ignoring
the entries when deciding what to display to the user while retaining them when
modifying the array (unless the modification is for truncation).