aetheris-server 0.11.2

Authoritative heart and tick scheduler for the Aetheris multiplayer platform
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

//! Aggregates multiple `GameTransport` implementations into one.

use aetheris_protocol::events::NetworkEvent;
use aetheris_protocol::traits::{ClientId, PlatformTransport, TransportError};

/// Combines multiple `GameTransport` implementations.
///
/// This allows the server to simultaneously support native clients (via Renet)
/// and web clients (via WebTransport).
pub struct MultiTransport {
    transports: Vec<Box<dyn PlatformTransport>>,
}

impl MultiTransport {
    /// Creates a new empty `MultiTransport`.
    #[must_use]
    pub fn new() -> Self {
        Self {
            transports: Vec::new(),
        }
    }

    /// Adds a transport to the aggregator.
    pub fn add_transport(&mut self, transport: Box<dyn PlatformTransport>) {
        self.transports.push(transport);
    }
}

impl Default for MultiTransport {
    fn default() -> Self {
        Self::new()
    }
}

#[async_trait::async_trait]
impl PlatformTransport for MultiTransport {
    async fn send_unreliable(
        &self,
        client_id: ClientId,
        data: &[u8],
    ) -> Result<(), TransportError> {
        for transport in &self.transports {
            // We try to send to all, but only one will likely succeed if IDs are properly partitioned
            // or if the transport returns ClientNotConnected for unknown IDs.
            match transport.send_unreliable(client_id, data).await {
                Ok(()) => return Ok(()),
                Err(TransportError::ClientNotConnected(_)) => {}
                Err(e) => {
                    tracing::error!("MultiTransport: individual transport send error: {:?}", e);
                    return Err(e);
                }
            }
        }
        Err(TransportError::ClientNotConnected(client_id))
    }

    async fn send_reliable(&self, client_id: ClientId, data: &[u8]) -> Result<(), TransportError> {
        for transport in &self.transports {
            match transport.send_reliable(client_id, data).await {
                Ok(()) => return Ok(()),
                Err(TransportError::ClientNotConnected(_)) => {}
                Err(e) => {
                    tracing::error!("MultiTransport: individual transport send error: {:?}", e);
                    return Err(e);
                }
            }
        }
        Err(TransportError::ClientNotConnected(client_id))
    }

    async fn broadcast_unreliable(&self, data: &[u8]) -> Result<(), TransportError> {
        let mut first_error = None;
        for transport in &self.transports {
            if let Err(e) = transport.broadcast_unreliable(data).await
                && first_error.is_none()
            {
                first_error = Some(e);
            }
        }

        if let Some(e) = first_error {
            Err(e)
        } else {
            Ok(())
        }
    }

    async fn poll_events(&mut self) -> Result<Vec<NetworkEvent>, TransportError> {
        let mut all_events = Vec::new();
        for transport in &mut self.transports {
            all_events.extend(transport.poll_events().await?);
        }
        Ok(all_events)
    }

    async fn disconnect(&self, client_id: ClientId) -> Result<(), TransportError> {
        for transport in &self.transports {
            // We ignore errors here because we want to try all transports,
            // and it's fine if a transport doesn't know this client.
            let _ = transport.disconnect(client_id).await;
        }
        Ok(())
    }

    async fn connected_client_count(&self) -> usize {
        let mut total = 0;
        for transport in &self.transports {
            total += transport.connected_client_count().await;
        }
        total
    }
}