Struct dittolive_ditto::transport::Peer

#[non_exhaustive]
pub struct Peer {
    pub address: DittoAddress,
    pub peer_key_string: String,
    pub device_name: String,
    pub os: Option<PresenceOs>,
    pub query_overlap_group: u8,
    pub is_connected_to_ditto_cloud: bool,
    pub is_compatible: Option<bool>,
    pub ditto_sdk_version: Option<String>,
    pub connections: Vec<UndirectedConnection>,
    pub peer_metadata: Value,
    pub identity_service_metadata: Value,
    /* private fields */
}

Peer in the Ditto mesh.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

address: DittoAddress

An address uniquely representing another device on the Ditto network.

peer_key_string: String

The peer key is a unique identifier for a given peer, equal to or derived from the cryptographic public key used to authenticate it.

NOTE: This will be be empty when a peer is not updated to the latest version of the SDK.

device_name: String

The human-readable device name for a peer. This defaults to the the hostname but can be manually set by the application developer.

os: Option<PresenceOs>

The operating system of a peer (if known).

query_overlap_group: u8

An optional query overlap group which an app developer might provide to influence connection priorities. Values can range between 0-63 (inclusive). Defaults to 0 if not set.

is_connected_to_ditto_cloud: bool

Flag which indicates if this peer is connected to HyDRA. This is represented as a simple flag since attempting add HyDRA as a node to a graph would be extremely convoluted. The presence viewer depicts the HyDRA connection with a simple cloud icon above a peer.

is_compatible: Option<bool>

A simplified boolean flag indicating whether the is peer is compatible with our own peer (if known). Note that there might be connections to this peer even if incompatible with our own peer, provided that some other peers are able to interoperate.

ditto_sdk_version: Option<String>

The marketing version of the SDK (if known). For instance: "1.0.3".

connections: Vec<UndirectedConnection>

List of current connections between this peer and other peers.

peer_metadata: Value

Metadata associated with the peer, empty dictionary by default.

Use Presence::set_peer_metadata() or Presence::set_peer_metadata_json_str() to set this value.

This will be empty when a peer is only connected via a WebSocket connection.

• See also: Presence::peer_metadata for details on usage of metadata.

identity_service_metadata: Value

Metadata associated with the peer by the identity service.

Use an authentication webhook to set this value. See Ditto’s online documentation for more information on how to configure an authentication webhook.

Trait Implementations

impl Clone for Peer

fn clone(&self) -> Peer

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Peer

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Peer

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.