Struct IdentityStatusChanges

pub struct IdentityStatusChanges { /* private fields */ }

Available on crate feature e2e-encryption and non-WebAssembly only.

Support for creating a stream of batches of IdentityStatusChange.

Internally, this subscribes to all identity changes, and to room events that change the membership, and provides a stream of all changes to the identity status of all room members.

This struct does not represent the actual stream, but the state that is used to produce the values of the stream.

It does provide a method to create the stream: IdentityStatusChanges::create_stream.

Implementations

impl IdentityStatusChanges

pub async fn create_stream( room: Room, ) -> Result<impl Stream<Item = Vec<IdentityStatusChange>>>

Create a new stream of changes to the identity status of members of a room.

The “status” of an identity changes when our level of trust in it changes.

For example, if an identity is “pinned” i.e. not manually verified, but known, and it becomes a “unpinned” i.e. unknown, because the encryption keys are different and the user has not acknowledged this, then this constitutes a status change. Also, if an identity is “unpinned” and becomes “pinned”, this is also a status change.

The supplied stream is intended to provide enough information for a client to display a list of room members whose identities have changed, and allow the user to acknowledge this or act upon it.

Note: when an unpinned user leaves a room, an update is generated stating that they have become pinned, even though they may not necessarily have become pinned, but we don’t care any more because they left the room.

Trait Implementations

impl Debug for IdentityStatusChanges

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.