Struct backroll::P2PSession

pub struct P2PSession<T> where
    T: BackrollConfig,  { /* fields omitted */ }

Implementations

impl<T: BackrollConfig> P2PSession<T>

pub fn build() -> P2PSessionBuilder<T>

pub fn player_count(&self) -> usize

Gets the number of players in the current session. This includes users that are already disconnected.

pub fn in_rollback(&self) -> bool

Checks if the session currently in the middle of a rollback.

pub fn current_frame(&self) -> i32

Gets the current frame of the game.

pub fn local_players(&self) -> impl Iterator<Item = BackrollPlayerHandle> + '_

pub fn remote_players(&self) -> impl Iterator<Item = BackrollPlayerHandle> + '_

pub fn is_synchronized(&self) -> bool

Checks if all remote players are synchronized. If all players are local, this will always return true.

pub fn add_local_input(
    &mut self,
    player: BackrollPlayerHandle,
    input: T::Input
) -> BackrollResult<()>

Adds a local input for the current frame. This will register the input in the local input queues, as well as queue the input to be sent to all remote players. If called multiple times for the same player without advancing the session with advance_frame, the previously queued input for the frame will be overwritten.

For a corrrect simulation, this must be called on all local players every frame before calling advance_frame.

Errors

Returns BackrollError::InRollback if the session is currently in the middle of a rollback.

Returns BackrollError::NotSynchronized if the all of the remote peers have not yet synchornized.

Returns BackrollError::InvalidPlayer if the provided player handle does not point a vali player.

pub fn advance_frame(&mut self, callbacks: &mut impl SessionCallbacks<T>)

Advances the game simulation by a single frame. This will call SessionCallbacks::advance_frame then check if the simulation is consistent with the inputs sent by remote players. If not, a rollback will be triggered, and the game will be saved and resimulated from the point of rollback.

For a corrrect simulation, add_local_input must be called on all local players every frame before calling this.

pub fn disconnect_player(
    &mut self,
    callbacks: &mut impl SessionCallbacks<T>,
    player: BackrollPlayerHandle
) -> BackrollResult<()>

Disconnects a player from the game.

If called on a local player, this will disconnect the client from all remote peers.

If called on a remote player, this will disconnect the connection with only that player.

Errors

Returns BackrollError::InvalidPlayer if the provided player handle does not point a vali player.

Returns BackrollError::PlayerDisconnected if the provided player is already disconnected.

pub fn get_network_stats(
    &self,
    player: BackrollPlayerHandle
) -> BackrollResult<NetworkStats>

Gets network statistics with a remote player.

Errors

Returns BackrollError::InvalidPlayer if the provided player handle does not point a vali player.

pub fn set_frame_delay(
    &mut self,
    player: BackrollPlayerHandle,
    delay: i32
) -> BackrollResult<()>

Sets the frame delay for a given player.

Errors

Returns BackrollError::InvalidPlayer if the provided player handle does not point a vali player.