byte-engine 0.1.0

A composable Rust game engine focused on graphics, input, audio, physics, and retained UI.
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

//! Reliability policy for application messages sent over engine networking.
//!
//! Implement [`Replicable`] on payloads submitted to network sessions.
//! [`Importance::Essential`] retains retry behavior for state that must arrive;
//! use [`Importance::Optional`] for replaceable cosmetic or high-frequency data.

/// The [`Replicable`] trait supplies payload access and delivery importance to
/// network sessions.
pub trait Replicable {
	fn payload(&self) -> &u8;

	/// Returns the delivery importance of the message.
	///
	/// The default is [`Importance::Essential`], which retries delivery until the
	/// peer acknowledges it. Use [`Importance::Optional`] for replaceable data so
	/// essential messages retain bandwidth.
	fn importance(&self) -> Importance {
		Importance::Essential
	}
}

/// The [`Importance`] enum selects whether delivery should be retried.
pub enum Importance {
	Essential,
	Optional,
}